View a markdown version of this page

使用 AI 编码代理对构建进行故障排除 - EC2 Image Builder
掌握技能注意事项

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

使用 AI 编码代理对构建进行故障排除

的代理工具包为 AI 编码代理 AWS提供了使用服务所需的工具、知识和护栏。 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 对失败的构建进行故障排除-预览。

掌握技能

您的代理可以通过以下方式获得该技能：

  • 通过 AWS MCP 服务器在运行时发现 — 连接到 AWS MCP 服务器的代理可以按需搜索和加载技能，无需在本地安装。有关更多信息，请参阅《 AWS 用户指南》代理工具包中的技能。

  • 使用安装 AWS CLI — 以下命令安装系统上检测到的 AI 编码代理的技能。该命令指定us-east-1区域，因为技能目录仅在该地区可用。这并不限制你可以在哪里使用该技能。有关设置和版本要求，请参阅《代理工具包 AWS 用户指南》中的 AWS CLI 。

    aws agent-toolkit add-skill \
    --skill-name amazon-ec2-image-builder \
    --region us-east-1

  • 从下载 GitHub — 技能来源可在 AWS 存储库的代理工具包中找到 GitHub。将其添加到您的代理的技能目录中。

注意事项

使用该技能时请注意以下几点：

  • 您的代理使用您的 AWS 凭证致电映像生成器和相关服务。我们建议您将代理的 IAM 权限范围限制为任务所需的最低权限。

  • AI 会生成响应。在修改资源之前，请验证分析和建议。