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

將動作群組新增至代理程式

1. 使用具有 Amazon Bedrock 主控台使用許可的 IAM 身分登入AWS 管理主控台。接著，開啟位於 https://console.aws.amazon.com/bedrock 的 Amazon Bedrock 主控台。

2. 從左側導覽窗格選取代理程式。接著，在代理程式區段中選擇代理程式。

3. 選擇在代理程式建置器中編輯。

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

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

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

   1. 使用函數詳細資訊定義 - 定義代理程式要從使用者取得的參數，以便執行動作。如需有關新增函數的詳細資訊，請參閱在 Amazon Bedrock 中定義代理程式動作群組的函數詳細資訊。

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

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

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

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

     注意

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

   • 傳回控制權 – 代理程式不會將預測的 API 或函數的參數傳遞給 Lambda 函數，而是透過 InvokeAgent 回應傳遞其預測應調用的動作，以及從工作階段決定的動作參數和資訊，藉此將控制權傳回給您的應用程式。如需詳細資訊，請參閱 透過在 InvokeAgent 回應中傳送取得的資訊，將控制權傳回給代理程式開發人員。

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

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

     1. 提供名稱和選用的 (建議提供) 描述。

     2. 若要在調用函數之前請求使用者確認，請選取已啟用。在調用函數之前請求確認，可以保護您的應用程式免於因惡意提示注入而執行動作。

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

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

     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 描述、結構和參數的 OpenAPI 結構描述，請選擇選取 API 結構描述，並提供指向該結構描述之 Amazon S3 URI 的連結。

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

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

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

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

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

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

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

10. 在測試代理程式之前，請務必準備套用您對代理程式所做的變更。