Lambda 工具¶
這個工具讓 Agent 呼叫一個 AWS Lambda 函式來完成特定動作，例如查詢內部系統、觸發某個處理流程。Agent 會依你定義的輸入格式，自動把需要的資料填好再呼叫。
這項偏技術
Lambda 函式與其輸入格式通常由工程或 IT 同事提供。若你不確定函式名稱或要填哪些參數，建議請他們協助。
開始前
你需要一個已部署、且平台有權限呼叫的 Lambda 函式（函式名稱或 ARN）。
設定步驟¶
-
在 Agent 的「自訂工具」中，新增一個「Lambda」工具。
-
填寫「名稱」與「描述」。
- 在「Lambda 函式指定方式」選擇「從 Lambda 函式資源選取」或「輸入函式名稱或 ARN」，再依選擇填入函式（見下方欄位說明）。
-
（選用）設定「輸入結構」，描述 Agent 呼叫時要提供哪些欄位。
-
儲存。
完整欄位說明¶
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 名稱（Name） | 是 | （無） | 工具識別名稱，同一 Agent 內不可重複。 |
| 描述（Description） | 是 | （無） | 這個函式做什麼，Agent 靠它判斷何時呼叫。 |
| Lambda 函式指定方式（Lambda Function Reference） | 是 | 從 Lambda 函式資源選取 | 選擇怎麼指定函式：「從 Lambda 函式資源選取」（選一個已登記的 Lambda 函式資源）或「輸入函式名稱或 ARN」（直接填名稱或 ARN）。 |
| Lambda 函式（Lambda Function） | 條件 | （無） | 當指定方式為「從 Lambda 函式資源選取」時出現，選擇一個已建立的 Lambda 函式資源。 |
| Lambda 函式名稱（Lambda Function Name） | 條件 | （無） | 當指定方式為「輸入函式名稱或 ARN」時出現，直接填 Lambda 函式名稱或 ARN。 |
| 輸入結構（Input Schema） | 否 | 不需輸入 | 描述 Agent 呼叫時要填的輸入欄位；是一張逐列填寫的表格（見下方說明）。未設定時視為不需輸入。 |
| 顯示名稱 / 標籤 | 否 | （無） | 顯示名稱（Display Name）與標籤（Tags），位於進階設定。 |
「描述」決定 Agent 會不會用對工具
Agent 是靠每個工具的「描述」（Description）判斷何時、該不該用它。描述寫得越清楚具體，Agent 越能在對的時機正確使用；寫得太籠統，可能該用時沒用、或用錯場合。建議寫明這個函式做什麼、回傳什麼、什麼情況下該呼叫。
輸入結構是什麼
它定義「呼叫這個函式時要提供哪些資料」。這是一張表格，按「輸入結構」(+) 按鈕新增一列，每列有四欄：
- 名稱：這個輸入欄位的名字，例如
order_id。 - 類型：這欄資料的種類，例如文字、數字、布林（是／否）等。
- 必填：開啟代表呼叫時這欄一定要有值，不能漏填。
- 可空：開啟代表這欄允許留空值（沒有內容也可以）。
這些值通常由提供函式的工程同事一併給你，照著填上即可；不確定就請他們提供。Agent 會依此自動把資料準備好。
對話設定（Chat Setup）¶
有些 Lambda 函式每次呼叫都需要一組固定的基礎輸入（例如所屬部門、語系、預設參數）。你不必每次對話都請 Agent 重填，可在對話畫面用「對話設定」一次設定好，之後該工具的每次呼叫都會自動帶入。
- 入口：在與 Agent 對話的畫面，工具列上的齒輪（）按鈕即「對話設定」。
- 作用：這裡填的值會注入到每次該工具呼叫的輸入，並儲存為這個 Agent 的個人預設值，下次開新對話會自動帶入。
- 必填欄位：若工具的「輸入結構」有必填欄位尚未填寫，對話設定會被強制開啟、且無法取消，並提示「開始對話前需先完成必填欄位。」。填妥後才能開始對話。
- 輸入結構變更時：若這個 Agent 的 Lambda 工具輸入結構之後有調整，下次開新對話會自動跳出對話設定，請你重新確認或補填，確保帶入的預設值仍然正確。
對話設定是「個人預設」
對話設定儲存的是你自己對這個 Agent 的預設輸入，方便每次對話沿用；它不會改動 Agent 本身的工具設定。
實際效果¶
設定好之後，當使用者的問題需要這個函式，Agent 會依「輸入結構」把資料準備好、呼叫 Lambda 函式，再用回傳結果作答。對話中會以可展開的卡片顯示 Agent 傳入的輸入與函式回傳的結果，再依結果整理出回答。
執行效果截圖待補
本頁的實際執行截圖需要一個已部署、且平台有權限呼叫的 Lambda 函式才能擷取；目前文件環境尚無可用的 Lambda 函式資源，待後端就緒後補上。