本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
测试 Amazon Bedrock 代理
创建代理后，您将获得一份工作草稿。工作草稿是代理的一个版本，可用于以迭代方式构建代理。每次您对代理进行更改时，工作草稿都会更新。当您对代理的配置感到满意时，可以创建一个版本（即代理的快照）和指向该版本的别名。然后，您可以通过调用别名将代理部署到您的应用程序中。有关更多信息，请参阅 部署 Amazon Bedrock 代理。
以下列表描述了如何测试代理：
-
在 Amazon Bedrock 控制台中，您可以打开侧面的测试窗口，然后发送输入内容供您的代理回复。您可以选择工作草稿或已创建的版本。
-
在 API 中，工作草案就是
DRAFT版本。您可以通过使用InvokeAgent测试别名TSTALIASID、或指向静态版本的其他别名向代理发送输入。
为了帮助解决您的代理的行为，Amazon Bedrock 代理提供了在与您的代理会话期间查看跟踪的功能。轨迹显示了代理的 step-by-step 推理过程。有关跟踪的更多信息，请参阅在 Amazon Bedrock 中追踪事件。
以下是测试代理的步骤。选择与您选择的方法相对应的选项卡，然后按照步骤操作。
- Console
-
测试代理
-
AWS Management Console 使用具有 Amazon Bedrock 权限的 IAM 角色登录，然后通过 https://console.aws.amazon.com/bedrock/ 打开亚马逊 Bedrock 控制台。
-
从左侧导航窗格中选择 “代理”。然后，在 “代理” 部分中选择一个代理。
-
在 “代理” 部分，从代理列表中选择要测试的代理的链接。
-
“测试” 窗口出现在右侧的窗格中。
注意
如果 “测试” 窗口已关闭，则可以通过选择代理详细信息页面顶部的测试或其中的任何页面来重新打开该窗口。
-
创建代理后，必须通过以下方式之一进行准备，将其与工作草稿更改一起打包：
-
在 “测试” 窗口中，选择 “准备”。
-
在 “工作草稿” 页面中，选择页面顶部的准备。
注意
每次更新工作草稿时，都必须让代理做好准备，以便将最新更改打包给代理。作为最佳实践，我们建议您始终在工作草稿页面的代理概述部分中查看代理的上次准备时间，以确认您正在使用最新的配置测试代理。
-
-
要选择要测试的别名和关联版本，请使用测试窗口顶部的下拉菜单。默认情况下，选择 TestAlias：工作草稿组合。
-
（可选）要为您的别名选择预配置吞吐量，您选择的测试别名下方的文本将显示使用 ODT 或使用 P T。要创建预置吞吐量模型，请选择更改。有关更多信息，请参阅 Amazon Bedrock 的预配置吞吐量。
-
要测试代理，请输入一条消息并选择 Run。在等待生成响应时或生成响应之后，您可以选择以下选项：
-
要查看代理协调流程中每个步骤的详细信息，包括每个步骤的提示、推理配置和代理的推理过程以及其操作组和知识库的使用情况，请选择显示跟踪。跟踪会实时更新，因此您可以在返回响应之前进行查看。要展开或折叠步骤的轨迹，请选择步骤旁边的箭头。有关 “跟踪” 窗口和显示的详细信息的更多信息，请参阅在 Amazon Bedrock 中追踪事件。
-
如果代理调用知识库，则响应中包含脚注。要查看包含响应特定部分引用信息的 S3 对象的链接，请选择相关的脚注。
-
如果您将代理设置为返回控制权，而不是使用 Lambda 函数来处理操作组，则响应将包含预测的操作及其参数。为操作提供 API 或函数的输出值示例，然后选择 S ub mit 以生成代理响应。有关示例，请参阅下图：
您可以在 “测试” 窗口中执行以下操作：
-
要与代理开始新的对话，请选择刷新图标。
-
要查看 “跟踪” 窗口，请选择展开图标。要关闭 “跟踪” 窗口，请选择缩小图标。
-
要关闭 “测试” 窗口，请选择向右箭头图标。
-
您可以启用或禁用操作组和知识库。使用此功能通过评估代理在不同设置下的行为来确定哪些操作组或知识库需要更新，从而对代理进行故障排除。
启用操作组或知识库
-
AWS Management Console 使用具有 Amazon Bedrock 权限的 IAM 角色登录，然后通过 https://console.aws.amazon.com/bedrock/ 打开亚马逊 Bedrock 控制台。
-
从左侧导航窗格中选择 “代理”。然后，在 “代理” 部分中选择一个代理。
-
在 “代理” 部分，从代理列表中选择要测试的代理的链接。
-
在代理的详细信息页面上，在工作草稿部分，选择工作草稿的链接。
-
在 “操作组” 或 “知识库” 部分，将鼠标悬停在要更改其状态的操作组或知识库的状态上。
-
此时将出现一个编辑按钮。选择编辑图标，然后从下拉菜单中选择操作组或知识库是启用还是禁用。
-
如果操作组处于禁用状态，则代理将不使用该操作组。如果知识库已禁用，则代理将不使用知识库。启用或禁用操作组或知识库，然后使用 “测试” 窗口对代理进行故障排除。
-
选择 “准备”，应用您在测试代理之前对代理所做的更改。
-
- API
-
在首次测试代理之前，必须使用适用于 A mazon Bedrock 的代理构建时终端节点发送PrepareAgent请求（请求和响应格式以及字段详情参见链接），将其与工作草稿更改一起打包。在请求
agentId中包含。更改适用于TSTALIASID别名指向的DRAFT版本。注意
每次更新工作草稿时，都必须让代理做好准备，以便将最新更改打包给代理。作为最佳实践，我们建议您使用适用于 Amazon Bedrock 的 Amazon Bedrock 代理构建时终端节点发送GetAgent请求（有关请求和响应格式以及字段详情，请参阅链接），并查看代理验证您是否正在使用最新配置测试代理的
preparedAt时间。要测试您的代理，请使用适用于 A mazon Bedrock 的代理运行时终端节点发送InvokeAgent请求（有关请求和响应格式以及字段详情，请参阅链接）。
注意
AWS CLI 不支持InvokeAgent。
请求中存在以下字段：
-
至少要提供以下必填字段：
字段 简短描述 agentId 代理人的 ID agentAliasId 别名的 ID。 TSTALIASID用于调用DRAFT版本sessionId 会话的字母数字 ID（2—100 个字符） 输入文本 用户向代理发送的提示 -
以下字段为可选字段：
响应以事件流的形式返回。每个事件都包含一个
chunk，其中包含bytes字段中的部分响应，必须对其进行解码。如果代理人查询了知识库，则chunk还会包含citations知识库。也可以返回以下对象：-
如果您启用了跟踪，则还会返回一个
trace对象。如果发生错误，则会返回包含错误消息的字段。有关如何读取跟踪的更多信息，请参阅在 Amazon Bedrock 中追踪事件。
-
