在 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 匯入現有的結構描述以進行編輯，請選取匯入結構描述，提供 S3URI，然後選取匯入。

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

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

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

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

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