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

# 使用 AI 编码代理对构建进行故障排除
<a name="agent-toolkit-skill"></a>

的[代理工具包为 AI 编码代理 AWS](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/what-is-agent-toolkit.html)提供了使用服务所需的工具、知识和护栏。 AWS 它适用于 Kiro、Claude Code、Cursor 和 Codex 等代理。该工具包包括`amazon-ec2-image-builder`技能、精心策划的说明包和指导您的代理完成映像生成器任务的参考材料。

加载技能后，您的代理可以从终端或 IDE 诊断构建失败。该技能引导代理进入失败的工作流程步骤和 Amazon Logs 中的组件 CloudWatch 日志。它为常见故障场景（例如实例连接超时、缺少实例配置文件权限和组件错误）提供补救步骤。

该技能涵盖了映像生成器工作流程的其余部分：构建 IAM 角色、Amazon 托管和自定义组件、映像配方以及基础设施和分发配置。它处理一次性构建和循环流水线，以实现金色 AMI 自动化和操作系统补丁。它支持 Linux、Windows 和 macOS AMI 以及容器镜像。

**注意**  
该技能在你自己的 AI 编码代理中运行。有关图像生成器控制台中内置的 AI-powered 根本原因分析，请参阅[使用 AI 对失败的构建进行故障排除-预览](devops-agent-troubleshooting.md)。

**Topics**
+ [掌握技能](#agent-toolkit-skill-get)
+ [注意事项](#agent-toolkit-skill-considerations)

## 掌握技能
<a name="agent-toolkit-skill-get"></a>

您的代理可以通过以下方式获得该技能：
+ **通过 AWS MCP 服务器在运行时发现 ** — 连接到 AWS MCP 服务器的代理可以按需搜索和加载技能，无需在本地安装。有关更多信息，请参阅《 AWS 用户指南》*代理工具包[中的](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/skills.html)技能*。
+ **使用安装 AWS CLI** — 以下命令安装系统上检测到的 AI 编码代理的技能。该命令指定`us-east-1`区域，因为技能目录仅在该地区可用。这并不限制你可以在哪里使用该技能。有关设置和版本要求，请参阅《*代理工具包 AWS 用户指南》[中的 ](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/aws-cli.html)AWS CLI *。

  ```
  aws agent-toolkit add-skill \
      --skill-name amazon-ec2-image-builder \
      --region us-east-1
  ```
+ **从下载 GitHub ** — 技能来源可在 AWS 存储库[的](https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/ec2-skills/amazon-ec2-image-builder)代理工具包中找到 GitHub。将其添加到您的代理的技能目录中。

## 注意事项
<a name="agent-toolkit-skill-considerations"></a>

使用该技能时请注意以下几点：
+ 您的代理使用您的 AWS 凭证致电映像生成器和相关服务。我们建议您将代理的 IAM 权限范围限制为任务所需的最低权限。
+ AI 会生成响应。在修改资源之前，请验证分析和建议。