在 Amazon Bedrock 中將動作群組新增至您的代理程式

將動作群組新增至客服人員

1. AWS Management Console 使用IAM具有 Amazon Bedrock 許可 的角色登入 ，並在 開啟 Amazon Bedrock 主控台https://console.aws.amazon.com/bedrock/。

2. 從左側導覽窗格中選取客服人員。然後，在客服人員區段中選擇客服人員。

3. 選擇客服人員建置器 中的編輯。

4. 在動作群組區段中，選擇新增 。

5. （選用） 在動作群組詳細資訊區段中，變更自動產生的名稱，並為動作群組提供選用的描述。

6. 在動作群組類型區段中，選取下列其中一種方法來定義代理程式可以從使用者取得的參數，以協助執行動作：

   1. 使用函數詳細資訊定義 - 定義可讓客服人員從使用者引出的參數，以執行動作。如需新增函數的詳細資訊，請參閱 在 Amazon 基岩中為您的代理程式動作群組定義功能詳細資訊。

   2. 使用結構描述定義 API - 定義客服人員可以叫用API的操作和參數 。使用您建立或使用主控台文字編輯器建立結構描述的開放API結構描述。如需設定開放API結構描述的詳細資訊，請參閱 定義 OpenAPI Amazon Bedrock 中代理程式動作群組的結構描述

7. 在動作群組調用區段中，您可以設定代理程式在預測應該調用並接收其所需參數的 API或 函數之後所執行的動作。選擇下列其中一個選項：

   • 快速建立新的 Lambda 函數 – 建議 – 讓 Amazon Bedrock 為您的代理程式建立基本 Lambda 函數，稍後您可以在 中 AWS Lambda 針對您的使用案例進行修改。代理程式會根據工作階段，將預測的 API或 函數和 參數傳遞至 Lambda 函數。

   • 選取現有的 Lambda 函數 – 選擇您先前在 中建立的 Lambda 函數， AWS Lambda 以及要使用的函數版本。代理程式會根據工作階段，將預測的 API或 函數和 參數傳遞至 Lambda 函數。

     注意

     若要允許 Amazon Bedrock 服務主體存取 Lambda 函數，請將資源型政策連接至 Lambda 函數，以允許 Amazon Bedrock 服務主體存取 Lambda 函數。

   • 傳回控制項 – 除了將預測的 API或 函數的參數傳遞至 Lambda 函數之外，代理程式也應該透過傳遞預測的動作，將控制項傳回給應用程式，以及從工作階段中決定之動作的參數和資訊，位於 中 InvokeAgent 回應。如需詳細資訊，請參閱通過在響應中發送引起的信息將控制權返回給代理開發人員 InvokeAgent 。

8. 根據您選擇的動作群組類型 ，您會看到下列其中一個區段：

   • 如果您選取了使用函數詳細資訊定義 ，則您會有一個動作群組函數區段。執行下列動作來定義函數：

     1. 提供名稱和選用 （但建議） 描述 。

     2. 若要在叫用函數之前請求使用者確認，請選取已啟用 。在叫用函數之前請求確認，可能會保護您的應用程式免於因惡意的立即注入而採取動作。

     3. 在參數子區段中，選擇新增參數 。定義下列欄位：

        欄位	描述
        名稱	為 參數命名。
        描述 (選用)	描述 參數。
        Type	指定 參數的資料類型。
        必要	指定代理程式是否需要使用者提供 參數。

     4. 若要新增其他參數，請選擇新增參數 。

     5. 若要編輯參數中的欄位，請選取欄位並視需要編輯。

     6. 若要刪除參數，請在包含 參數的資料列中選擇刪除圖示 （ ）。

     如果您偏好使用JSON物件定義函數，請選擇JSON編輯器，而非資料表 。JSON 物件格式如下所示 （parameters物件中的每個索引鍵都是您提供的參數名稱）：

     {
         "name": "string",
         "description": "string",
         "parameters": [
             {
                 "name": "string",
                 "description": "string",
                 "required": "True" | "False",
                 "type": "string" | "number" | "integer" | "boolean" | "array"
             }
         ]
     }

     若要透過定義另一組參數將另一個函數新增至動作群組，請選擇新增動作群組函數 。

   • 如果您選取使用結構描述定義 API ，您會有一個動作群組結構描述區段，其中包含下列選項：

     • 若要使用您先前為動作群組準備的API描述、結構和參數的開放API結構描述，請選取選取API結構描述並提供結構描述URI的 Amazon S3 連結。

     • 若要使用內嵌結構描述編輯器定義開啟API結構描述，請選取透過內嵌結構描述編輯器定義 。此時會顯示可編輯的範例結構描述。

       1. 使用格式旁的下拉式選單以選取結構描述的格式。

       2. 若要從 S3 匯入現有結構描述以進行編輯，請選取匯入結構描述 ，提供 S3 URI，然後選取匯入 。

       3. 若要將結構描述還原為原始範例結構描述，請選取重設，然後再次選取重設以確認顯示的訊息。

9. 建立動作群組完成後，請選擇新增 。如果您定義API了結構描述，如果沒有問題，則會出現綠色成功橫幅。如果驗證結構描述時發生問題，會出現紅色橫幅。您有下列選項：

   • 捲動結構描述，以查看存在格式化錯誤或警告的行。X 表示格式錯誤，而驚嘆號表示有關格式化的警告。

   • 選取紅色橫幅中的檢視詳細資訊，以查看API結構描述內容的錯誤清單。

10. 請務必在測試之前，準備好將所做的變更套用至客服人員。