在 Amazon Bedrock 中向代理添加操作组

向代理添加操作组

1. AWS Management Console 使用具有 Amazon Bedrock 权限的IAM角色登录，然后通过以下网址打开 Amazon Bedrock 控制台。https://console.aws.amazon.com/bedrock/

2. 从左侧导航窗格中选择代理。然后，在代理部分选择一个代理。

3. 选择在代理生成器中编辑。

4. 在操作组部分，选择添加。

5. （可选）在操作组详细信息部分，更改自动生成的名称，并为操作组提供一个可选的描述。

6. 在操作组类型部分，选择以下一种方法来定义代理可以从用户处获取的参数，用于帮助执行操作：

   1. 通过函数详细信息来定义 – 定义代理需要从用户处获取的参数，以便执行操作。有关添加函数的更多信息，请参阅 在 Amazon Bedrock 中为代理的操作组定义函数详细信息。

   2. 使用API架构定义-定义代理可以调用的API操作和参数。使用您创建的 Open API 架构或使用控制台文本编辑器创建架构。有关设置 Open 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. 在参数子部分中，选择添加参数。定义以下字段：

        字段	描述
        Name	为参数指定名称。
        Description（可选）	描述参数。
        Type	制定参数的数据类型。
        Required	指定代理是否要求用户提供参数。

     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架构并提供指向该架构的 Amazon S3 URI 的链接。

     • 要使用行内API架构编辑器定义 Open 架构，请选择 “通过内联架构编辑器定义”。此时将出现一个您可以编辑的示例架构。

       1. 使用格式旁边的下拉菜单选择架构的格式。

       2. 要从 S3 导入现有架构进行编辑，请选择导入架构，提供 S3URI，然后选择导入。

       3. 要将架构恢复为原始示例架构，请选择重置，然后再次选择重置来确认显示的消息。

9. 创建完操作组后，选择添加。如果您定义了API架构，则如果没有问题，则会显示一个绿色的成功横幅。如果验证架构时出现问题，将会出现红色横幅。您有以下选项：

   • 滚动浏览架构，查看存在有关格式的错误或警告的行。X 表示存在格式错误，而感叹号表示存在有关格式的警告。

   • 选择红色横幅中的查看详细信息以查看有关API架构内容的错误列表。

10. 务必选择准备以应用对代理所做的更改，然后再测试代理。