翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AI コーディングエージェントを使用したビルドのトラブルシューティング
<a name="agent-toolkit-skill"></a>

[エージェントツールキット for AWS](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/what-is-agent-toolkit.html) は、AI コーディングエージェントに、 AWS サービスを操作するために必要なツール、知識、ガードレールを提供します。Kiro、Claude Code、Cursor、Codex などのエージェントで動作します。ツールキットには、 `amazon-ec2-image-builder` スキル、Image Builder タスクを通じてエージェントをガイドする手順と参考資料の厳選されたパッケージが含まれています。

スキルがロードされると、エージェントはターミナルまたは IDE からビルドの失敗を診断できます。このスキルは、失敗したワークフローステップと Amazon CloudWatch Logs のコンポーネントログにエージェントを誘導します。インスタンス接続タイムアウト、インスタンスプロファイルのアクセス許可の欠落、コンポーネントエラーなど、一般的な障害シナリオに対する修復手順を提供します。

このスキルは、ビルド IAM ロール、Amazon マネージドコンポーネントとカスタムコンポーネント、イメージレシピ、インフラストラクチャとディストリビューションの設定など、Image Builder ワークフローの残りの部分を対象としています。ゴールデン AMI オートメーションと OS パッチ適用のための 1 回限りのビルドと定期的なパイプラインを処理します。Linux、Windows、macOS AMIs、コンテナイメージをサポートしています。

**注記**  
スキルは独自の AI コーディングエージェントで実行されます。Image Builder コンソールに組み込まれた AI を活用した根本原因分析については、「」を参照してください[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 サーバーに接続されたエージェントは、ローカルにインストールすることなく、オンデマンドでスキルを検索してロードできます。詳細については、*「 Agent Toolkit for AWS ユーザーガイド*」の[「スキル](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/skills.html)」を参照してください。
+ **を使用して AWS CLI**をインストールする – 次のコマンドは、システムで検出された AI コーディングエージェントのスキルをインストールします。このコマンドは、スキルカタログがその`us-east-1`リージョンでのみ使用できるため、リージョンを指定します。これにより、スキルが使用できる場所は制限されません。セットアップとバージョンの要件については、*「 Agent Toolkit for AWS ユーザーガイド*」の[AWS 「CLI](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/aws-cli.html)」を参照してください。

  ```
  aws agent-toolkit add-skill \
      --skill-name amazon-ec2-image-builder \
      --region us-east-1
  ```
+ **GitHub からのダウンロード** – スキルソースはGitHub の [Agent Toolkit for AWS リポジトリ](https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/ec2-skills/amazon-ec2-image-builder)で入手できます。エージェントのスキルディレクトリに追加します。

## 考慮事項
<a name="agent-toolkit-skill-considerations"></a>

スキルを使用する場合は、次の点に注意してください。
+ エージェントは、認証情報 AWS を使用して Image Builder および関連サービスを呼び出します。エージェントの IAM アクセス許可の範囲は、タスクに必要な最小限にすることをお勧めします。
+ AI はレスポンスを生成します。リソースを変更する前に、分析と推奨事項を確認してください。