先决条件

注意

Amazon Bedrock 的配置和调用内联代理功能目前为预览版，可能会有改变。

在调用内联代理之前，请先满足以下先决条件：

1. 确定要用于配置内联代理的基础模型、要从中调用代理的区域，以及告知内联代理应该做什么的指令。

2. 创建或准备以下一个或多个要用于内联代理的 Amazon Bedrock 代理属性。

   字段	使用案例
   actionGroups	提供操作组列表，每个操作组定义了内联代理可以执行的操作。例如，您可以定义一个操作组 “预约”，以帮助用户执行诸如 CreateAppointment、 GetAppointment CancelAppointment、等操作。
   guardrailConfiguration	配置护栏，用于屏蔽话题、防止出现幻觉并为您的应用程序实施保护措施。
   knowledgeBases	将知识库与内联代理关联，以增强模型生成的响应。知识库不仅可以用来回答用户查询和分析文档，还可以通过为提示提供上下文来增强为基础模型提供的提示。
   promptOverridenConfiguration	在代理序列的不同部分配置覆盖提示，以提高内联代理的准确性。
   customerEncryptionArn	指定用于加密内联代理的AWS KMS密钥的 Amazon 资源名称 (ARN)。

3. 创建AWS身份和访问管理 (IAM) Access Management 角色并将本步骤中提到的策略附加到该角色。

   在调用内联代理之前，必须创建一个 IAM 角色来提供必要的权限，以使用 InvokeInlineAgent API 和访问 Lambda 函数、知识库和基础模型等资源。

   按照创建向 IAM 用户委派权限的角色中的步骤进行操作，为内联代理创建自定义服务角色。创建 IAM 角色后，将以下策略附加到该角色。

   注意

   出于安全考虑，最佳做法是在创建您的账户 ID 和*.ids特定资源 ID 后，将、和替换为 Region。${region} ${account-id}