建立多代理協同作業

步驟 1：建立協作者代理程式

• 依照指示建立和設定代理程式。請務必將每個協作者代理程式設為執行特定任務。

步驟 2：建立新的主管代理程式，或將主管角色指派給現有的代理程式

1. 如果您要建立新的主管代理程式，請遵循 手動建立和設定代理程式 的指示，然後繼續下一個步驟。

   如果您已設定代理程式，並想要將主管角色指派給代理程式，請繼續下一個步驟。

2. 如果您尚未進入代理程式建置器，請執行下列動作：

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

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

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

   4. 在代理程式建置器中，向下捲動至多代理協同作業區段，然後選擇編輯。

3. 在多代理協同作業頁面中的協同作業狀態區段中，開啟多代理協同作業。這會將代理程式識別為主管代理程式。

4. 在協同作業組態區段中，選擇您希望主管代理程式如何處理多個協作者代理程式的資訊，以協調最終回應。

   1. 如果您希望主管代理程式協調來自協作者代理程式的回應，請選取主管。

   2. 如果您希望主管代理程式將資訊路由到適當的協作者代理程式以傳送最終回應，請選取使用路由的主管。

   3. 繼續執行後續步驟，以新增協作者代理程式。

步驟 3：新增協作者代理程式

1. 展開代理程式協作者區段，並提供您為多代理協同作業所建立之協作者代理程式的詳細資訊。

   1. 對於協作者代理程式，從下拉式清單中選取協作者代理程式和代理程式別名。您可以選擇檢視，以檢視協作者代理程式的詳細資訊。

   2. 針對協作者名稱，輸入協作者代理程式的替代名稱。此名稱不會取代此代理程式的原始名稱。

   3. 在協作指示中，輸入主管代理程式何時應使用此協作者的詳細資訊。

   4. (選用) 如果您希望主管代理程式與此協作者代理程式共用先前對話的內容，請開啟啟用對話歷史記錄。如果開啟此功能，主管將包含目前工作階段的完整歷史記錄，包括使用者輸入文字和每次對話的主管代理程式回應。

2. 選擇新增協作者，將在多代理協同作業團隊中新增此協作者代理程式。若要新增更多協作者代理程式，請重複步驟 1，直到您新增所有協作者代理程式為止。

3. 完成協作者代理程式的新增後，請選取下列其中一個選項：

   • 若要繼續多代理協同作業，請選擇儲存並繼續下一個步驟，以準備和測試多代理協同作業團隊。

   • 若要返回代理程式詳細資訊頁面，請選擇儲存並結束。

步驟 4：準備和測試多代理協同作業

• 遵循指示來準備和測試多代理協同作業團隊。

步驟 5：部署多代理協同作業

• 設定主管代理程式以提出 InvokeAgent 請求，部署多代理協同作業。

步驟 1：建立協作者代理程式

• 依照指示建立和設定代理程式。請務必將每個協作者代理程式設為執行特定任務。

步驟 2：建立新的主管代理程式，或將主管角色指派給現有的代理程式

• 若要建立新的主管代理程式，請使用 Amazon Bedrock 代理程式建置時期端點傳送 CreateAgent 請求 (請參閱連結，取得請求和回應格式和欄位詳細資訊)。

  若要將主管角色指派給現有代理程式，請使用 Amazon Bedrock 代理程式建置時期端點傳送 UpdateAgent 請求。由於所有欄位都將遭覆寫，因此請同時包括您要更新的欄位以及要保持不變的欄位。

  您必須至少包含下列欄位：

  欄位	使用案例
  agentResourceRoleArn	指定具有許可的服務角色 ARN，以呼叫代理程式上的 API 操作
  foundationModel	為代理程式指定基礎模型 (FM) 以與以下項目協調
  指示	提供指示來告知代理程式該怎麼做。用於協同運作提示範本的 $instructions$ 預留位置。
  agentCollaboration	將主管角色指派給代理程式。 指定 SUPERVISOR 您是否希望主管代理程式協調來自協作者代理程式的回應，並輸出回應。 指定 SUPERVISOR_ROUTER 您是否希望主管代理程式將資訊路由到適當的協作者代理程式，以傳送最終回應。 根據預設，此欄位會設為 DISABLED。

  以下是選填欄位：

  欄位	使用案例
  描述	描述代理程式執行的操作
  idleSessionTTLInSeconds	持續時間，代理程式在此時間後會結束工作階段與刪除任何預存資訊。
  customerEncryptionKeyArn	用於加密代理程式資源的 KMS 金鑰 ARN
  tags	將標籤與代理程式建立關聯。
  promptOverrideConfiguration	在協同運作的每個步驟自訂傳送至 FM 的提示。
  guardrailConfiguration	將防護機制新增至代理程式。指定防護機制的 ID 或 ARN，以及要使用的版本。
  clientToken	為確保 API 請求，僅完成一次。如需詳細資訊，請參閱確保冪等性。

  回應會傳回 CreateAgent 物件，其中包含新建立之主管代理程式的詳細資訊。如果無法建立代理程式，回應中的 CreateAgent 物件會傳回 failureReasons 的清單和 recommendedActions 的清單，供您進行疑難排解。

步驟 3：新增協作者代理程式

• 若要將協作者代理程式與主管代理程式建立關聯，請使用 Amazon Bedrock 代理程式建置時期端點傳送 AssociateAgentCollaborator 請求 (請參閱連結，取得請求和回應格式和欄位詳細資訊)。

  您必須至少包含下列欄位：

  欄位	使用案例
  collaboratorName	指定協作者代理程式的替代名稱。此名稱只會出現在協同作業指示中，不會取代原始代理程式名稱。
  agentDescriptor	指定代理程式的別名 Arn。
  collaborationInstruction	提供指示來告知協作者代理程式該怎麼做。
  relayConversationHistory	設為 TO_COLLABORATOR 以指定主管代理程式將與此協作者代理程式共用先前對話的內容。 有效值：TO_COLLABORATOR | DISABLED。

步驟 4：準備和測試多代理協作者團隊

• 遵循指示來準備和測試多代理協同作業團隊。

步驟 4：部署多代理協同作業團隊

• 設定主管代理程式以提出 InvokeAgent 請求，部署多代理協同作業。