翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # DevOps エージェントスキル AWS DevOps エージェントスキルは、インフラストラクチャと運用ワークフローに合わせた専門的なドメインの知識と調査方法論により、エージェントの機能を拡張するモジュラー命令セットです。 ## スキルとは スキルは、 AWS DevOps Agent に特殊な機能を提供する Markdown 指示を含む自己完結型ディレクトリです。 AWS DevOps Agent は、エージェントの指示とリソースをパッケージ化するオープンスタンダードである [Agent Skills 仕様](https://agentskills.io/)のサブセットをサポートし、Markdown 指示書、PDFs、画像、データファイルなどの実行可能でないドキュメントのみをサポートします。 **注記** ** サンドボックス (プレビュー) を有効にすると、スキルには、エージェントがサンドボックス環境で実行する実行可能コードを含めることもできます。詳細については、[「サンドボックスのセットアップ](configuring-integrations-and-knowledge-sandbox.md)」を参照してください。 すべてのスキルには、 AWS DevOps エージェントに提供する手順を含む SKILL.md ファイルが必要です。必要な SKILL.md ファイルに加えて、スキルには次のようなものがあります。 + 特定のシナリオまたはインフラストラクチャタイプの**調査ワークフロー**。 + アーキテクチャパターンや運用手順を含む**参考資料**。 + **エージェントタイプのターゲティング** – スキルは、特定のエージェントタイプ (汎用、オンデマンド、インシデントトリアージ、インシデント RCA、インシデント緩和、評価) を対象にして、コンテキストの消費を減らし、エージェントのフォーカスを向上させることができます。 ## スキルを使用する理由 スキルは、 AWS DevOps エージェントを汎用アシスタントからインフラストラクチャと運用ワークフローのスペシャリストに変換します。チャットメッセージで提供される 1 回限りの手順とは異なり、スキルは、 AWS DevOps Agent によって実行されるタスクに関連する場合に自動的にロードされる再利用可能な機能です。 **主な利点:** + **エージェントを専門化する** – 調査手順、ベストプラクティス、インフラストラクチャと運用パターンに固有の組織知識を使用して、 AWS DevOps エージェントをカスタマイズします。 + **繰り返しを減らす** – 調査ワークフローを一度作成すると、 AWS DevOps Agent は関連するすべての調査でそれらを自動的に使用するため、同じガイダンスを繰り返し提供する必要がなくなります。 + **機能を構成する** – 複数のスキルを組み合わせてend-to-endの調査ワークフローを構築します。 AWS DevOps エージェントは、カスタム CI/CD パイプラインからデプロイを取得するスキルやコードリポジトリを検索するスキルなど、実行中に複数のスキルを読み取ります。 + **Amplify カスタムツール** – AWS DevOps Agent がカスタム MCP サーバーツールを効果的に使用するのに役立つスキルを作成します。スキルは、特定のツールを呼び出すタイミング、さまざまなシナリオに使用するパラメータ、結果を解釈してインフラストラクチャ固有のワークフローを実行する方法を文書化することができます。 ## スキルの仕組み AWS DevOps エージェントが関連するタスクに遭遇すると、適切なスキルをロードし、調査の指針となる指示に従います。例えば、「データベースパフォーマンス調査」スキルには、RDS スロットリングの問題を分析するstep-by-stepの手順が含まれている場合があります。これにより、エージェントはアラームステータスを体系的にチェックし、接続メトリクスを分析し、スロークエリを特定できます。 ## スキル構造 スキルは、以下を含むディレクトリとして編成されます。 ``` my-skill/ ├── SKILL.md # Main skill instructions ├── references/ # Optional: additional reference documentation └── assets/ # Optional: images, diagrams, data files ``` ### SKILL.md は唯一の必須ファイル`SKILL.md`です。これには、Markdown 形式で記述されたコア命令が含まれています。このファイルは次の条件を満たす必要があります。 + スキルを使用するタイミングと方法を説明します。 + step-by-stepの調査手順を提供します。 + さまざまなシナリオのディシジョンツリーを含めます。 + 期待される出力と成功基準を文書化します。 ### フロントマター Frontmatter は、`SKILL.md`ファイルの上部にあるメタデータブロックで、`---`区切り文字で囲まれています。これには、 AWS DevOps Agent が調査またはタスク中にスキルを有効にするタイミングを判断するために使用する フィールド`name`と `description`フィールドが含まれています。 ``` --- name: rds-performance-investigation description: Investigation procedures for RDS performance issues including connection exhaustion, slow queries, replication lag, and storage capacity. Use this skill when investigating database latency, connection errors, or read/write performance degradation. --- ``` **name** – スキルの一意の識別子。小文字、数字、ハイフンのみを使用してください (最大 64 文字）。先頭または末尾にハイフンを使用しないでください。 description**** – AWS DevOps エージェントがこのスキルを使用するタイミングと理由の詳細な説明。 AWS DevOps エージェントはこのフィールドを評価して、スキルが現在のタスクに関連しているかどうかを判断します。説明があいまいまたは欠落している場合、指示が適切に記述されていても、エージェントはスキルを完全にスキップする可能性があります。 **重要** – エージェントの観点から説明を記述します。スキルをトリガーする特定のシナリオ、サービス、エラータイプ、または症状を含めます。たとえば、「Amazon RDS インスタンスのデータベースレイテンシー、接続エラー、またはクエリタイムアウトを調査するときにこのスキルを使用する」は、「RDS スキル」よりも効果的です。 UI でスキルを作成すると、指定した名前と説明からフロントマターが自動的に生成されます。zip ファイルとしてアップロードされるスキルには、`SKILL.md`ファイルに frontmatter が含まれている必要があります。 ## 例: スキルを完了する 次の例は、RDS パフォーマンスの問題を調査するための完全で適切な形式のスキルを示しています。ディレクトリ構造、SKILL.md frontmatter、実用的な調査手順、および補足参照ファイルを示します。 **ディレクトリ構造:** ``` rds-performance-investigation/ ├── SKILL.md ├── references/ │ └── rds-metrics-reference.md └── assets/ └── rds-investigation-flowchart.png ``` **SKILL.md:** ``` --- name: rds-performance-investigation description: Investigation procedures for RDS performance issues including connection exhaustion, slow queries, replication lag, and storage capacity. Use this skill when investigating database latency, connection errors, or read/write performance degradation. --- # RDS Performance Investigation Use this skill when customers report database latency, connection errors, query timeouts, or read/write performance degradation. ## Step 1: Check alarm status Query CloudWatch for active alarms on the affected RDS instance. Look for: - `DatabaseConnections` exceeding 80% of max_connections - `ReadLatency` or `WriteLatency` above 20ms - `FreeStorageSpace` below 20% of total storage - `ReplicaLag` above 30 seconds (read replicas only) ## Step 2: Analyze connection metrics Retrieve `DatabaseConnections` over the past hour. If connections are near the max_connections limit, check for connection pool misconfiguration or long-running idle connections. ## Step 3: Identify slow queries Use Performance Insights (`pi:GetResourceMetrics`) to retrieve the top SQL statements by average active sessions. Focus on queries with high `db.load` contribution or frequent I/O waits. ## Step 4: Summarize findings Provide a summary with: 1. Current performance status (healthy / degraded / critical) 2. Root cause hypothesis with supporting metrics 3. Recommended remediation steps ranked by priority ``` **リファレンス/rds-metrics-reference.md:** ``` # RDS CloudWatch Metrics Reference | Metric | Normal Range | Investigation Threshold | |---|---|---| | DatabaseConnections | < 70% max_connections | > 80% max_connections | | ReadLatency | < 5ms | > 20ms | | WriteLatency | < 5ms | > 20ms | | FreeStorageSpace | > 30% total storage | < 20% total storage | | ReplicaLag | < 5 seconds | > 30 seconds | | CPUUtilization | < 70% | > 85% | ``` ## 例: インシデントフィルタリングスキル **Incident Triage** エージェントタイプの対象となるスキルは、インシデントを自動的にスキップするための基準を定義できます。これを使用して、調査を必要としないインシデントをフィルタリングします。新しいインシデントがスキップ条件に一致すると、 AWS DevOps エージェントは**それをスキップ**済みとしてマークします。システムは、フィルタリングされた理由を説明する理由を提供します。 次の例は、スケジュールされたメンテナンス中に優先度の低いインシデントをスキップするスキルを示しています。 **SKILL.md:** ``` --- name: skip-scheduled-maintenance description: Skip low-priority incidents during a scheduled maintenance window. Use this skill to automatically filter MEDIUM and LOW severity alarms that fire during planned maintenance, avoiding unnecessary investigations for expected disruptions. --- # Skip Scheduled Maintenance Skip all incidents that meet BOTH of the following criteria: 1. The incident arrived between **2025-03-15 02:00 UTC** and **2025-03-15 06:00 UTC** 2. Severity is MEDIUM or LOW Do NOT skip HIGH or CRITICAL severity incidents, even during the maintenance window. ``` このスキルを作成するときは、エージェントタイプとして **Incident Triage** を選択します。これにより、スキルはトリアージフェーズ中にのみ評価されます。 ## スキルの作成 スキルを作成する前に、エージェントスペースが必要です。詳細については、「[エージェントスペースの作成](getting-started-with-aws-devops-agent-creating-an-agent-space.md)」を参照してください。 ワークフローの設定とスキルの複雑さに応じて、2 つの方法でスキルを作成できます。 CLI または SDK AWS を使用してプログラムでスキルを管理するには、「」を参照してください[アセットの管理](about-aws-devops-agent-managing-assets.md)。 AWS SDKs ### UI でのスキルの作成 AWS DevOps エージェントオペレーターウェブアプリで作成されたスキルには、単一の SKILL.md ファイルの名前、説明、および手順が含まれています。 **UI でスキルを作成するには:** + エージェントスペースオペレーターウェブアプリの**ナレッジ**ページに移動し、**スキル**タブを選択します。 + **スキルの追加**を選択します。 + モーダルから**スキルの作成**を選択します。 + スキルフォームに入力します。 + **名前** – 小文字、数字、ハイフンのみ (最大 64 文字）。先頭または末尾にハイフンを使用しないでください。例: `rds-throttling-investigation` + **説明** – このスキルを使用するタイミングの簡単な説明 (推奨文字数は 100 文字以上、最大 1,024 文字）。これは、エージェントがスキルを有効にするタイミングを決定するのに役立ちます。 + **ステータス** – アクティブ (デフォルト) または非アクティブに設定します。非アクティブなスキルはエージェントでは使用されません。 + **エージェントタイプ** – このスキルを使用できるエージェントタイプを 1 つ以上選択します。**汎用** はデフォルトで選択され、スキルがすべてのエージェントタイプで使用できるようにします。特定のエージェントをターゲットにするには、汎用 の選択を解除し、オンデマンド、インシデントトリアージ、インシデント RCA、インシデント緩和、評価のいずれかを選択します。 + **手順** – Markdown Step-by-stepの手順。具体的で実用的であること。 + スキルを保存するには、「作成」を選択します。 システムは、適切なフロントマター構造を持つ SKILL.md ファイルを自動的に生成します。 **UI で作成されたスキルを編集するには:** + **ナレッジ**ページのスキル**スキル**タブに移動し、スキルを選択して開きます。 + **[編集]** を選択します。 + 名前、説明、または手順を変更します。 + **保存**を選択してスキルを更新します。 ### スキルのアップロード zip ファイルとしてアップロードされたスキルには、SKILL.md ファイルに加えて、参考資料やアセットなどの追加リソースが含まれています。 **スキル構造:** ``` my-skill.zip ├── SKILL.md # Required: main skill instructions ├── references/ # Optional: reference documentation │ ├── architecture.md │ └── troubleshooting.md └── assets/ # Optional: images, diagrams, data files ├── topology.png └── metrics.csv ``` **SKILL.md フロントマター要件:** zip ファイルとしてアップロードされるスキルには、 `name`フィールドと `description`フィールドを含む SKILL.md のフロントマターが含まれている必要があります。 AWS DevOps Agent はこれらのフィールドを使用して、スキルを有効にするタイミングを決定します。効果的なフロントマターの記述の詳細については、このトピックの前半の「Frontmatter」セクションを参照してください。 ``` --- name: rds-performance-analysis description: Comprehensive RDS performance investigation procedures for connection exhaustion, slow queries, and storage capacity issues. Use when investigating database latency or read/write degradation. --- # RDS Performance Analysis [Your skill instructions here...] ``` **zip アップロードでスキルを作成するには:** + 上記の構造に従って、スキルファイルを含むディレクトリを作成します。 + SKILL.md に適切なフロントマター (名前と説明) が含まれていることを確認します。 + ディレクトリを .zip ファイルに圧縮します。 + エージェントスペースオペレーターウェブアプリの**ナレッジ**ページに移動し、**スキル**タブを選択します。 + **スキルの追加**を選択します。 + モーダルから**スキルのアップロード**を選択します。 + .zip ファイルをドラッグアンドドロップするか、参照することを選択します (ZIP ファイルのみ、最大 6 MB)。 + このスキルを使用できるエージェントタイプを 1 つ以上選択します (汎用 はデフォルトで選択され、すべてのエージェントタイプに適用されます。特にオンデマンド、インシデントトリアージ、インシデント RCA、インシデント緩和、または評価をターゲットにするには選択を解除します）。 + zip ファイルの要件と検証結果を確認します。 + エージェントスペースにスキルを追加するには、「アップロード」を選択します。 **zip ファイルとしてアップロードされるスキルに関する重要な制限:** + **スクリプトは現在サポートされていません** – `scripts/` ディレクトリにスクリプトを含むスキルは、アップロード中に拒否されます。スクリプト実行は、エージェントが安全なコーディング環境にアクセスできるようになると、将来のリリースで有効になります。 + **サイズ制限** – zip ファイルの合計サイズは 6 MB を超えることはできません (すべてのファイルを含む）。 + **SKILL.md 必須** – zip ファイルには、有効なフロントマターを含む SKILL.md ファイルが含まれている必要があります。 **命名スキルのベストプラクティス:** 一般的な名前ではなく、rds-throttling-investigation」のような明確でわかりやすい名前を使用します。優れたスキル名は、対応する特定のシナリオやサービスを反映しているため、適切なスキルを簡単に一目で特定できます。 ### リポジトリからのスキルのインポート スキルは GitHub リポジトリディレクトリから直接インポートできます。 AWS DevOps Agent は、リポジトリからスキルコンテンツを取得し、SKILL.md フロントマターから名前と説明を抽出して、エージェントスペースにスキルを作成します。これにより、バージョン管理のスキルを管理し、1 つのアクションでインポートできます。 **前提条件**: + エージェントスペースに関連付けられた GitHub アカウント。GitHub アカウントを接続するには、「」を参照してください[GitHub の接続](connecting-to-cicd-pipelines-connecting-github.md)。GitHub アカウント接続により、パブリックリポジトリからのインポートが可能になります。プライベートリポジトリの場合、関連付けられたアカウントにはリポジトリへの読み取りアクセス権が必要です。 + ルートに SKILL.md ファイルがある有効なスキルディレクトリを含む GitHub リポジトリ。 **リポジトリ構造:** インポートするリポジトリディレクトリは、標準のスキル構造に従う必要があります。 ``` my-skill/ ├── SKILL.md # Required: must include name and description in frontmatter ├── references/ # Optional: reference documentation │ └── runbook.md └── assets/ # Optional: images, diagrams, data files └── architecture.png ``` **リポジトリからスキルをインポートするには:** + エージェントスペースオペレーターウェブアプリの**ナレッジ**ページに移動し、**スキル**タブを選択します。 + **スキルの追加**を選択します。 + モーダル**からリポジトリからインポート**を選択します。 + SKILL.md ファイルを含む GitHub ディレクトリ URL を入力します。例: `https://github.com/my-org/my-repo/tree/main/skills/rds-investigation` + このスキルを使用できるエージェントタイプを 1 つ以上選択します。 + ライフサイクルステータス (アクティブまたは非アクティブ) を設定します。 + **スキルのインポート**を選択します。 AWS DevOps エージェントはディレクトリの内容を取得し、SKILL.md のフロントマターを読み取りてスキル名と説明を抽出し、すべてのファイルをエージェントスペースにインポートします。 **インポートされたスキルの表示:** インポートされたスキルは、ソースリポジトリへのリンクとともにカスタムスキルリストに表示されます。スキル詳細ビューで、次の操作を行います。 + スキル名と説明は読み取り専用です (SKILL.md ファイルによって管理されます）。 + 手順とリソースファイルは読み取り専用モードで表示されます。 + ステータスとエージェントタイプは編集可能です。 + 「最終同期」タイムスタンプは、スキルがリポジトリから最後に同期された日時を示します。 **インポートされたスキルの同期:** リポジトリ内のスキルファイルを更新すると、インポートされたスキルを同期して最新の変更をプルできます。 + 詳細ビューでインポートしたスキルを開きます。 + **[同期]** を選択します。 + AWS DevOps Agent は、ソースリポジトリからディレクトリコンテンツを再取得し、スキルコンテンツを更新します。 インポートしたスキル行で **Sync** を選択して、スキルリストビューから同期することもできます。 **注:** 同期すると、スキルコンテンツ全体がリポジトリディレクトリの現在の状態に置き換えられます。編集可能なフィールド (ステータス、エージェントタイプ) に対するローカルの変更は保持されます。 **制約**: + **URL 形式** – GitHub URLs。参照ファイルを含むディレクトリ全体をインポートする SKILL.md ( など`https://github.com/org/repo/tree/main/skills/my-skill`) を含むディレクトリを指すことができます。SKILL.md がリポジトリのルートにある場合は、SKILL.md のみをインポートする ファイル ( など`https://github.com/org/repo/blob/main/SKILL.md`) に直接リンクすることもできます。 + **SKILL.md 必須** – ディレクトリには、有効なフロントマター (名前と説明) を含む SKILL.md ファイルが含まれている必要があります。 + **最大ディレクトリサイズ** – ディレクトリの合計サイズは 6 MB を超えることはできません。 + **最大ファイル**数 – ディレクトリには最大 100 個のファイルを含めることができます。 + **GitHub アカウントが必要** – スキルをインポートするには、エージェントスペースに関連付けられた GitHub アカウントが必要です。関連付けられた GitHub アカウントは、パブリックリポジトリからのインポートを有効にします。プライベートリポジトリの場合、関連付けられたアカウントにはリポジトリへの読み取りアクセス権が必要です。 ## サンプルスキル GitHub ウェブサイトの [DevOps エージェントツールリポジトリ](https://github.com/aws-samples/sample-devops-agent-tools)には、コミュニティが貢献するスキルが含まれており、そのまま使用することも、独自の記述の開始点として使用することもできます。利用可能なサンプルには、 AWS ヘルスイベント調査、 AWS サポートケース分析、EKS 運用レビュー、RDS 運用レビューのスキルが含まれます。利用可能なスキルを参照するには、GitHub ウェブサイトの[コミュニティスキルギャラリー](https://aws-samples.github.io/sample-devops-agent-tools/)を参照してください。 サンプルスキルを使用するには: + **GitHub からのインポート** – スキルディレクトリ URL をコピーし、 Operator Web App の「リポジトリからインポート」フローに貼り付けます。詳細については、[「リポジトリからのスキルのインポート](#importing-a-skill-from-a-repository)」を参照してください。 + **zip としてアップロード** – リポジトリのクローンを作成し、スキルディレクトリを圧縮して、「スキルのアップロード」フローを使用してアップロードします。詳細については、[「スキルのアップロード](#uploading-a-skill)」を参照してください。 各スキルには、前提条件と使用手順を含む README が含まれています。 ## スキルの管理 AWS DevOps エージェントは、オペレーターウェブアプリを通じて包括的なスキル管理機能を提供します。 **スキルの一覧表示** – エージェントスペース内のすべてのスキルを表示します。**ナレッジ**ページの**スキル**タブには、スキル名、アクティブまたは非アクティブのステータス、作成日、最終更新日、使用可能なアクションが表示されます。 **スキルの表示** – 任意のスキルを選択すると、その詳細ビューが表示されます。UI で作成されたスキルには編集可能なコンテンツが表示され、UI で名前、説明、または手順を直接変更し、更新する「保存」を選択できます。zip ファイルとしてアップロードされたスキルには、SKILL.md と references/ や assets/ などの追加のディレクトリを示すファイルツリーが表示されます。ツリー内のファイルを選択すると、その内容が読み取り専用モードで表示されます。 **スキルのエージェントの選択** – 各スキルを作成または編集するときに使用できるエージェントタイプを設定します。エージェントタイプドロップダウンで、**汎用** (デフォルト — すべてのエージェントタイプに適用）、**オンデマンド** (会話型クエリ）、**インシデントトリアージ** (初期インシデント評価）、**インシデント RCA** (根本原因分析）、**インシデント軽減** (自動インシデント対応）、または**評価** (事前推奨事項) のチェックボックスを使用して、1 つ以上のエージェントタイプを選択します。汎用 はデフォルトで選択され、スキルがすべてのエージェントタイプで使用できるようにします。特定のエージェントを対象としたスキルは、コンテキストの消費を減らし、エージェントの集中力を向上させます。 **スキルのアクティブ化と非アクティブ化** – アクティブ/非アクティブトグルを使用して、スキルを削除せずに一時的に無効にします。スキル詳細ビューを開き、スイッチを「非アクティブ」に切り替えて、エージェントがすべてのコンテンツと設定を保持しながら、新しい調査のためにロードしないようにします。進行中の調査では、スキルが引き続き使用されます。「アクティブ」に戻すと、スキルがすぐに再び利用可能になります。プログラムでスキルを有効化または無効化するには、「アセットの管理[」ページの「スキルの有効化と無効化](about-aws-devops-agent-managing-assets.md)」を参照してください。 **スキルの更新** – 作成方法に基づいて既存のスキルを変更します。UI で作成されたスキルについては、スキル詳細ビューで「編集」を選択し、名前、説明、または手順を変更し、更新する「保存」を選択します。zip ファイルとしてアップロードされたスキルについては、ローカルでファイルを変更し、新しい zip ファイルを作成して、新しいバージョンをアップロードします。 **スキルの削除** – エージェントスペースからスキルを完全に削除します。スキルリストビューを開き、その他のオプションメニュー (⋮) を選択し、「削除」を選択し、永久削除に関する警告を確認し、確認するスキル名を入力し、「スキルの削除」を選択します。削除を元に戻すことはできません。削除されたスキルをロードしようとすると、進行中の調査が影響を受ける可能性があります。zip ファイルとしてアップロードされたスキルについては、バックアップとして を削除する前に zip ファイルをダウンロードしてください。再度必要になった場合は、削除せずにスキルを無効にすることを検討してください。 ## ランブックからの移行 既存のランブックは、顧客のアクションなしでスキルに自動的に移行されます。エージェントスペースがスキルモデルに移行すると、すべてのランブックがスキルに変換され、スキル UI に表示されます。移行後、次のことができます。 + **移行されたスキルを確認する** – 自動移行がランブックを正しく変換したことを確認します。 + **必要に応じて更新**する – UI でスキルを直接編集して、指示を絞り込んだり、説明を更新したり、エージェントタイプのターゲティングを設定したりできます。 + **リファレンスで拡張**する – 追加の参考資料やアーキテクチャ図からメリットを得るスキルについては、リファレンス/ または assets/ ディレクトリを使用して zip アップロードスキルとして再作成します。 + **新しいスキルを作成する** – Runbooks で以前にカバーされていない調査ワークフローに新しいスキルを追加します。 自動的に移行されたスキルに問題がある場合、または移行後の更新に関するサポートが必要な場合は、 AWS サポートにお問い合わせください。