先決條件

注意

設定和調用內嵌代理程式功能是 Amazon Bedrock 的預覽版本，可能會有所變更。

在調用內嵌代理程式之前，請先完成下列必要條件：

1. 決定您要用於設定內嵌代理程式的基礎模型、您要調用代理程式的區域，以及指示內嵌代理程式應執行的動作。

2. 建立或準備要用於內嵌代理程式的下列一或多個 Amazon Bedrock 代理程式屬性。

   欄位	使用案例
   actionGroups	提供動作群組清單，其中包含定義內嵌代理程式可執行之動作的每個動作群組。例如，您可以定義動作群組 Appointment，以協助使用者執行 CreateAppointment、GetAppointment、CancelAppointment 等動作。
   guardrailConfiguration	設定防護機制以封鎖主題、防止幻覺，以及為應用程式實作保護措施的防護機制組態。
   knowledgeBases	將 knowledgeBases 與您的內嵌代理程式建立關聯，以增強模型產生的回應。不僅可運用知識庫來回答使用者查詢及分析文件，還可以透過提示提供內容來增強提供給基礎模型的提示。
   promptOverridenConfiguration	在代理程式序列的不同部分中設定覆寫提示，以提高內嵌代理程式的準確性。
   customerEncryptionArn	指定要用來加密內嵌代理程式之AWS KMS金鑰的 Amazon Resource Name (ARN)。

3. 建立 AWSIdentity and Access Management (IAM) 角色，並將此步驟中提及的政策連接至角色。

   您必須先建立 IAM 角色，以提供使用 InvokeInlineAgent API 和存取 Lambda 函數、知識庫和基礎模型等資源的必要許可，才能調用內嵌代理程式。

   遵循建立角色以將許可委派給 IAM 使用者中的步驟，為您的內嵌代理程式建立自訂服務角色。建立 IAM 角色之後，請將下列政策連接至該角色。

   注意

   基於安全考量，最佳實務是在建立 ${region}、${account-id} 和 *.ids 之後，將其取代為區域、您的帳戶 ID 和特定資源 ID。