View a markdown version of this page

AI コーディングエージェントを使用したビルドのトラブルシューティング - EC2 イメージビルダー
スキルを取得する考慮事項

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

AI コーディングエージェントを使用したビルドのトラブルシューティング

エージェントツールキット for AWS は、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 を使用した失敗したビルドのトラブルシューティング - プレビュー。

スキルを取得する

エージェントは、次の方法でスキルを取得できます。

  • AWS MCP サーバーを介して実行時に検出 – AWS MCP サーバーに接続されたエージェントは、ローカルにインストールすることなく、オンデマンドでスキルを検索してロードできます。詳細については、「 Agent Toolkit for AWS ユーザーガイド」の「スキル」を参照してください。

  • を使用して AWS CLIをインストールする – 次のコマンドは、システムで検出された AI コーディングエージェントのスキルをインストールします。このコマンドは、スキルカタログがそのus-east-1リージョンでのみ使用できるため、リージョンを指定します。これにより、スキルが使用できる場所は制限されません。セットアップとバージョンの要件については、「 Agent Toolkit for AWS ユーザーガイド」のAWS 「CLI」を参照してください。

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

  • GitHub からのダウンロード – スキルソースはGitHub の Agent Toolkit for AWS リポジトリで入手できます。エージェントのスキルディレクトリに追加します。

考慮事項

スキルを使用する場合は、次の点に注意してください。

  • エージェントは、認証情報 AWS を使用して Image Builder および関連サービスを呼び出します。エージェントの IAM アクセス許可の範囲は、タスクに必要な最小限にすることをお勧めします。

  • AI はレスポンスを生成します。リソースを変更する前に、分析と推奨事項を確認してください。