View a markdown version of this page

使用控制台开始使用实例 - 亚马逊基岩 AgentCore
步骤 1：创建容量提供商步骤 2：创建使用容量提供者的代理运行时第 3 步：调用和监控步骤 4：清除后续步骤

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用控制台开始使用实例

本教程介绍如何使用 AWS 管理控制台在实例计算类型上托管代理。您首先创建一个定义 EC2 基础设施的容量提供商，然后创建一个使用它的代理运行时，最后调用和监控该代理。

有关先决条件，请参阅实例入门。

步骤 1：创建容量提供商

  1. 打开亚马逊 Bedrock AgentCore 控制台并选择 Runtime 。

  2. 在容量提供者选项卡上，选择创建容量提供商。

  3. 在 “容量提供者详细信息” 下，输入名称。有效字符是字母、数字和下划线；名称必须以字母开头，最多可包含 48 个字符。

  4. 对于操作系统，请为您的 EC2 实例选择操作系统（例如 Linux（64 位 x86））。这决定了哪些软件和应用程序与您的环境兼容。

  5. 对于允许的实例类型，最多选择 30 种符合您的工作负载要求的 EC2 实例类型。按 vCPU、内存和 CPU 制造商进行筛选以找到匹配项。

  6. 在 “安全” 下，选择控制实例网络访问的 V PC。（可选）在 “其他详细信息” 下配置子网和容器网络模式。

  7. （可选）在存储配置下，选择添加卷以连接用于永久存储的 Amazon EBS 卷。配置卷类型、大小、吞吐量、IOPS 和加密。这样可以保存卷配置；在会话首次启动时 AgentCore 创建每个卷。

  8. 在 “服务访问权限” 下，选择附加到 EC2 实例的实例配置文件（用于收集系统日志；它不向您的代理代码授予权限）和基础设施角色（用于代表 AgentCore 您管理 EC2 实例）。 AgentCore 您可以使用现有角色或让控制台创建新角色。

  9. 选择创建容量提供程序。容量提供器以一种CREATING状态启动，并在验证其配置ACTIVE后变为。

注意

创建容量提供器后，只能编辑其描述。要更改实例类型、网络或存储等其他配置，请复制容量提供商并在重复流程中进行更新。

步骤 2：创建使用容量提供者的代理运行时

  1. 在运行时页面上，选择创建运行时（或从容量提供商的详细信息页面中选择主机 agent/tool）。

  2. 输入代理或工具的名称。

  3. 对于计算类型，选择实例。

  4. 对于容量提供商，选择现有容量提供商，或选择 “快速创建” 以创建具有预配置默认值的内联容量提供商。

  5. 在 “Agent/tool 来源” 下，选择您的来源类型并提供工件：

    • S3 源 -从模板开始，上传.zip文件或选择 S3 存储桶中的现有对象。

    • ECR 容器 — 提供亚马逊 ECR 容器镜像 URI。

  6. （可选）配置入站身份验证、高级配置（安全、环境变量）和权限（IAM 执行角色和 KMS 加密）。

  7. 选择 “创建运行时” 。 AgentCore 创建版本 1 和指向它的DEFAULT端点。

注意

创建运行时后，您无法更改计算类型。

第 3 步：调用和监控

  1. 在运行时的详细信息页面上，选择测试并提供负载，或使用查看调用代码片段从您自己的应用程序调用代理。

  2. 首次调用新会话会在您的账户中预置 EC2 实例并启动代理，因此通常比以后的调用花费更长的时间。随后调用同一会话要快得多。 AgentCore 将该实例配置为 Amazon EC2 托管实例，DescribeInstances默认情况下，该实例在您的 EC2 控制台视图中处于隐藏状态。有关托管实例可见性的更多信息，请参阅托管资源可见性设置。

  3. 使用运行时详细信息页面上的可观察性指标和日志和跟踪来监控会话、调用、错误率和资源消耗。

步骤 4：清除

为避免在您的账户中预置的 Amazon EC2 实例和 Amazon EBS 卷持续收费，请在完成后清理您为本教程创建的资源：

  1. 删除会话，以便 AgentCore 取消配置 EC2 实例及其永久卷。在会话中停止单个代理运行时不会终止实例。有关 API 操作的更多信息，请参阅使用 AWS CLI 或 SDK 开始使用实例。

  2. 通过删除运行时、其端点或版本，取消运行时与容量提供者的关联。

  3. 一旦没有运行时引用容量提供器，就将其删除。

后续步骤