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

# 使用控制台开始使用实例
<a name="runtime-instances-get-started-console"></a>

本教程介绍如何使用 AWS 管理控制台在**实例**计算类型上托管代理。您首先创建一个定义 EC2 基础设施的[容量提供商](runtime-instances-how-it-works.md#runtime-instances-capacity-provider)，然后创建一个使用它的代理运行时，最后调用和监控该代理。

有关先决条件，请参阅实例[入门](runtime-instances-getting-started.md)。

## 步骤 1：创建容量提供商
<a name="runtime-instances-console-create-cp"></a>

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

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

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

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

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

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

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

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

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

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

## 步骤 2：创建使用容量提供者的代理运行时
<a name="runtime-instances-console-create-runtime"></a>

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

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

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

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

1. 在 “**Agent/tool 来源” 下**，选择您的来源类型并提供工件：
   +  **S3 源 **-从模板开始，上传`.zip`文件或选择 S3 存储桶中的现有对象。
   +  **ECR 容器 ** — 提供亚马逊 ECR 容器镜像 URI。

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

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

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

## 第 3 步：调用和监控
<a name="runtime-instances-console-invoke"></a>

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

1. 首次调用新会话会在您的账户中预置 EC2 实例并启动代理，因此通常比以后的调用花费更长的时间。随后调用同一会话要快得多。 AgentCore 将该实例配置为 [ Amazon EC2 托管实例](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/amazon-ec2-managed-instances.html)，`DescribeInstances`默认情况下，该实例在您的 EC2 控制台视图中处于隐藏状态。有关托管实例可见性的更多信息，请参阅[托管资源可见性设置](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/amazon-ec2-managed-instances.html#managed-resource-visibility-settings)。

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

## 步骤 4：清除
<a name="runtime-instances-console-cleanup"></a>

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

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

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

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

## 后续步骤
<a name="runtime-instances-console-next-steps"></a>
+  [实例](runtime-instances-how-it-works.md) 
+  [比较计算类型 ](runtime-instances-how-it-works.md#runtime-instances-compute-comparison) 
+  [运行时实例的安全模型和权限 ](runtime-instances-security.md)