本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 AI 編碼代理程式對組建進行故障診斷
<a name="agent-toolkit-skill"></a>

Agent [Toolkit 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 受管和自訂元件、映像配方，以及基礎設施和分佈組態。它處理一次性建置和週期性管道，用於黃金 AMI 自動化和作業系統修補。它支援 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 伺服器的代理程式可以隨需搜尋和載入技能，而無需本機安裝。如需詳細資訊，請參閱《 *客服人員工具組 AWS 使用者指南*》中的[技能](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/skills.html)。
+ **使用 安裝 AWS CLI** – 下列命令會為系統上偵測到的 AI 編碼代理程式安裝技能。命令會指定 `us-east-1`區域，因為技能目錄只能在該區域中使用。這不會限制您可以使用技能的位置。如需設定和版本需求，請參閱《 *客服人員工具組 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 會產生回應。修改資源之前，請先驗證分析和建議。