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

# エージェントの指示
<a name="about-aws-devops-agent-agent-instructions"></a>

エージェントの指示を使用して、 AWS DevOps Agent がすべてのセッションに適用する常時オンのガイダンスを提供します。セッションは、エージェントとの単一の会話または調査です。**エージェント**スペースオペレーターウェブアプリのエージェントページで、すべてのエージェントに適用される**グローバル指示**を設定したり、チャットやインシデントのトリアージなどの特定のマネージドエージェントに対する指示を設定したりできます。これらの手順は AGENTS.md ファイルとして保存されます。エージェントがスキルの説明を現在のタスクに一致させるとオンデマンドでロード[DevOps エージェントスキル](about-aws-devops-agent-devops-agent-skills.md)される とは異なり、エージェントの指示は、エージェントが作業している内容に関係なく、すべてのセッションの開始時から常に存在します。

## エージェントの指示とは
<a name="what-are-agent-instructions"></a>

エージェントの指示は、エージェントに無条件の常時オンのガイダンスを提供します。各セッションの開始時に、エージェントサービスはエージェントスペース用に設定された指示を取得し、その内容をエージェントシステムプロンプトに直接挿入します。エージェントはロードするかどうかを決定せず、常に存在します。

各エージェントセッションは、グローバル指示および関連するエージェント固有の指示の両方から指示を受け取ります。例えば、チャットです。

エージェントの指示は AGENTS.md ファイルとして保存され、いくつかの重要な点[DevOps エージェントスキル](about-aws-devops-agent-devops-agent-skills.md)で異なります。


| 側面 | スキル | エージェントの指示 (AGENTS.md) | 
| --- | --- | --- | 
| 名前と説明 | 必須 | 該当しない | 
| コンテンツ形式 | Markdown または ZIP バンドル | マークダウンのみ | 
| リソースファイル | サポート | サポートされていません | 
| コンテキストインジェクション | オンデマンド (エージェントがスキル説明のマッチングで決定) | 常に (無条件、すべてのセッション) | 
| Uniqueness | エージェントスペースごとに複数 | エージェントごとに 1 つ (グローバル指示の場合は 1 つ、マネージドエージェントごとに 1 つ) | 

エージェントの指示には名前または説明フィールドがありません。基盤となる AGENTS.md ファイルには、フロントマターなし、ZIP バンドルのサポートなし、リソースファイルなしのマークダウンのみが含まれます。

## エージェントの指示を使用する理由
<a name="why-use-agent-instructions"></a>

エージェントの指示により、エージェントのスキルロードの決定に依存することなく、特定のガイダンスが常にコンテキスト内であることを確認する信頼性の高い方法が提供されます。

**主な利点:**
+ **予測可能性:** エージェントが作業しているタスクに関係なく、指示は常に存在します。説明の一致は必要なく、エージェントはコンテンツをスキップできません。
+ **保証対象:** タスクの関連性に応じてエージェントがロードする場合とロードしない場合のスキルとは異なり、エージェントの指示は常にすべてのセッションの開始時に挿入されます。
+ **スタンディングポリシー:** エージェントの指示を使用して、運用ポリシー、セキュリティガイドライン、コーディング標準、または例外なくすべてのセッションに適用する必要があるガイダンスを配置します。
+ **ターゲット範囲:** グローバル指示を使用してすべてのエージェントタイプに一度に指示を適用したり、ガイダンスがそのエージェントの作業にのみ関連する場合に特定のエージェントタイプに指示を制限したりできます。

## エージェントの指示の仕組み
<a name="how-agent-instructions-work"></a>

セッションが開始されると、エージェントサービスはエージェントスペース用に設定された指示を取得し、セッションが開始される前にその内容をエージェントシステムプロンプトに挿入します。これはセッションごとに自動的に行われます。エージェントはそれらをロードするかどうかを評価しません。常にコンテンツを挿入します。

新しいセッションごとに、起動時に新しい手順がロードされます。手順を更新すると、保存後に開始するセッションに対して変更がすぐに有効になります。すでに進行中のセッションは、開始時にロードされたコンテンツを使用し続けます。

スコープによって、セッションが受け取る指示が決まります。グローバル手順は、エージェントスペース内のすべてのエージェントタイプに適用されるため、すべてのセッションで受信されます。エージェント固有の手順は、その特定のエージェントタイプのセッションにのみ適用されます。セッションは、グローバル指示と関連するエージェント固有の指示の両方から指示を受け取ります。

## エージェントタイプのスコープ
<a name="agent-type-scoping"></a>

スコープは、特定の一連の指示を受け取るエージェントセッションを制御します。スコープオプションは 2 つあります。
+ **グローバル手順:** エージェントスペース内のすべてのエージェントタイプに適用されます。すべてのエージェントセッションがこのコンテンツを受け取ります。
+ **エージェント固有:** 選択したエージェントタイプのセッションにのみ適用されます。

エージェント固有の手順で使用できるマネージドエージェントは次のとおりです。
+ **チャット** - チャットセッション中のアドホックな質問とリクエスト。
+ **インシデントのトリアージ** - アラームフィルタリング、重要度分類、初期スコープ。
+ **インシデント RCA** - 証拠の収集と検証による根本原因分析。
+ **インシデントの軽減** - 短期修復と長期修正の推奨事項。
+ **評価** - エージェントのパフォーマンススコアリングとポリシーコンプライアンスチェック。

## コンテンツサイズのガイダンス
<a name="content-size-guidance"></a>

会話や調査を開始するたびに、エージェントは他の操作を行う前に指示全体を読み取ります。エージェントにはセッションごとに一定量の作業メモリがあり、指示ではその一部が使用されます。ファイルが大きいほど、質問、調査、エージェントが読み取るログ、および独自の推論の余地が少なくなります。より短く、焦点を絞った指示により、エージェントは問題を解決するための容量を増やすことができます。
+ **ハード制限:** 25 KB
+ **推奨サイズ:** 120 行 (ほとんどの設定で推奨)

すべてのセッションに存在する必要があるガイダンスに指示を集中させます。特定のタスクにのみ適用される特殊な調査手順については、[DevOps エージェントスキル](about-aws-devops-agent-devops-agent-skills.md)代わりに の使用を検討してください。

## 例
<a name="example"></a>

次の例は、すべてのエージェントセッションに適用される調査ガイダンス、レスポンスフォーマット標準、およびセキュリティ要件を含む、適切な形式のエージェント指示を示しています。

```
# Agent Instructions

## Investigation approach
- Always check CloudWatch alarms and recent deployments before proposing a root cause.

## Response format
- Lead with a one-sentence summary of findings before listing details.
- Include the AWS region and resource identifier for any resource you reference.
- Use bullet points for lists of findings or recommendations.

## Security
- Never log, display, or suggest storing credentials or secrets in plaintext.
- When recommending IAM changes, follow least-privilege principles.
```

## エージェントの指示の設定
<a name="setting-agent-instructions"></a>

エージェントの指示を設定する前に、エージェントスペースが必要です。詳細については、「[エージェントスペースの作成](getting-started-with-aws-devops-agent-creating-an-agent-space.md)」を参照してください。

各エージェントには、指示のセットが 1 つだけあります。新しいコンテンツを保存すると、そのエージェントの既存のコンテンツが上書きされます。

**グローバル指示を設定するには (すべてのエージェントに適用):**

1. エージェントスペースオペレーターウェブアプリのエージェント****ページに移動します。

1. **グローバル手順**の横にある**表示** を選択します。

1. エディタにマークダウンの手順を入力します。

1. **[保存]** を選択します。

**特定のエージェントに指示を設定するには:**

1. エージェントスペースオペレーターウェブアプリのエージェント****ページに移動します。

1. **マネージドエージェント**で、設定するエージェントの横にある**表示**: **チャット**、**インシデントのトリアージ**、**インシデント RCA**、**インシデントの軽減**、または**評価**を選択します。

1. エディタにマークダウンの手順を入力します。

1. **[保存]** を選択します。

## エージェントの指示の管理
<a name="managing-agent-instructions"></a>

AWS DevOps エージェントは、オペレーターウェブアプリを通じてエージェント指示の管理機能を提供します。

**手順の表示:** **エージェント**ページに移動し、**グローバル手順**または特定のマネージドエージェントの横にある**表示**を選択します。エディタに現在のコンテンツが表示されます。**プレビュー**タブを使用してレンダリングされたマークダウンを表示するか、**コード**タブを使用して未加工のマークダウンを表示します。

**編集手順:** 前述のようにエージェントを開き、エディタでコンテンツを変更して、**保存**を選択します。

**ファイルからの指示のアップロード:** エージェントを開き、エディタで**アップロード**ボタンを選択してコンピュータからマークダウンファイルをアップロードします。

**ダウンロード手順:** エージェントを開き、エディタ**のダウンロード**ボタンを選択して、現在のコンテンツをファイルとしてダウンロードします。

**手順の削除:** エージェントを開き、エディタで**削除**ボタンを選択し、削除を確認します。このアクションを元に戻すことはできません。再度必要になる場合は、まずコンテンツをダウンロードすることを検討してください。