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

# カスタムエージェントの作成
<a name="custom-agents-creating-a-custom-agent"></a>

カスタムエージェントは 2 つの方法で作成できます。DevOps エージェントウェブアプリのフォームを使用するか、チャットのガイド付き会話を使用します。どちらの方法でも、エージェントスペースに同じカスタムエージェント設定が保存されます。

カスタムエージェントを作成する前に、少なくとも 1 つの接続された統合を持つエージェントスペースが必要です。詳細については、「[エージェントスペースの作成](getting-started-with-aws-devops-agent-creating-an-agent-space.md)」を参照してください。

## フォームを使用したカスタムエージェントの作成
<a name="creating-a-custom-agent-using-the-form"></a>

フォームでは、名前、システムプロンプト、およびオプションのスキルを指定して、カスタムエージェントをすばやく作成できます。MCP ツールをエージェントに割り当てるには、エージェントの作成後に Chat を使用します。

**フォームを使用してカスタムエージェントを作成するには:**

1. DevOps **Agent** ウェブアプリの Agents ページに移動します。

1. **「カスタムエージェント**」セクションで、**「エージェントの作成**」を選択します。

1. ダイアログで、**フォーム**を選択します。

1. フォームに入力します。
   + **名前** – エージェントの一意の識別子。小文字、数字、ハイフンのみを使用してください (最大 64 文字）。先頭または末尾にハイフンを使用しないでください。例: `weekly-health-report`
   + **システムプロンプト** – エージェントの動作と動作を定義する手順。Markdown で記述されます (最小 10 文字、最大 50,000 文字）。効果的なプロンプトの記述に関するガイダンスについては、[「システムプロンプトの記述](#writing-a-system-prompt)」を参照してください。
   + **スキル** (オプション) – エージェントスペースから、追加のドメインの知識や機能をエージェントに提供するスキルを選択します。検索フィールドを使用して、名前でスキルを検索します。

1. [**エージェントの作成**] を選択します。

作成後、エージェントの詳細ページにリダイレクトされ、設定を表示したり、エージェントを実行したり、トリガーを設定したりできます。

## Chat を使用したカスタムエージェントの作成
<a name="creating-a-custom-agent-using-chat"></a>

チャットは、カスタムエージェントを作成するためのガイド付きの会話型エクスペリエンスを提供します。この方法は、MCP ツールをエージェントに割り当てる場合、またはシステムプロンプトの記述を支援する場合に推奨されます。

**Chat を使用してカスタムエージェントを作成するには:**

1. DevOps **Agent** ウェブアプリの Agents ページに移動します。

1. **「カスタムエージェント**」セクションで、**「エージェントの作成**」を選択します。

1. ダイアログで、**チャット**を選択します。ダイアログが閉じ、チャットパネルに新しい会話が開き、事前設定されたメッセージが表示されます。

1. チャットでは、コラボレーションプロセスについて説明します。
   + **目的を明確に**する – エージェントの目的と範囲を確認します。
   + **重複チェック** – エージェントスペースに同様のエージェントが既に存在しないことを確認します。
   + **ツールとスキルの選択** – エージェントが必要とする MCP ツールとスキルを提案し、確認を求めます。
   + **出力タイプ** – エージェントがテキストレスポンス、アーティファクト、またはレコメンデーションを生成するかどうかを決定します。
   + **システムプロンプトの下書き** – システムプロンプトを書き込み、レビューのために表示します。満足するまで反復できます。
   + **確認** – エージェントを作成する前に、名前を提案し、すべての設定を確認します。

チャットに直接質問することで、いつでもカスタムエージェントを作成することもできます。例えば、次のようになります。

```
Create an agent that generates a weekly report of all investigations from the past week.
```

```
Create a custom agent for checking certificate expiration across all accounts.
```

```
Make me an agent that audits DynamoDB table configurations daily.
```

## システムプロンプトの記述
<a name="writing-a-system-prompt"></a>

システムプロンプトは、カスタムエージェントの最も重要な部分です。エージェントの目的、アプローチ、制約、期待される出力を定義します。適切に記述されたプロンプトは、一貫した信頼性の高い結果を生成します。

**これらのセクションを使用してシステムプロンプトを構造化します。**
+ **目標** – エージェントが 1 文または短い段落で達成すべきこと。
+ **アプローチ** – Step-by-stepの手順。
+ **制約** — エージェントがすべきこととすべきでないことの境界。例えば、読み取り専用アクセス、考慮する時間範囲、除外するサービスなどです。
+ **出力** – エージェントが生成する内容と形式。テキストを生成するか、アーティファクトを作成するか、レコメンデーションを作成するかを指定します。

**システムプロンプトの例:**

```
You are a DevOps reporting agent specializing in summarizing investigation activity.

## Goal
Generate a concise weekly report of all investigations from the past 7 days.

## Approach
1. Call `list_investigations` to fetch investigations from the last 7 days.
2. For each investigation, retrieve its title, status, root cause, and resolution time.
3. Group investigations by status and root cause category.
4. Identify trends: services most affected, average resolution time, recurring root causes.

## Constraints
- Only include investigations from the past 7 days.
- Read-only access — do not modify, close, or reassign investigations.

## Output
Produce a single artifact titled "Weekly Investigation Report" containing:
- A table listing each investigation with title, status, and resolution time.
- A chart showing investigation counts by root cause category.
- A summary paragraph with key trends and recommendations.
```

**効果的なシステムプロンプトのヒント:**
+ **ツールを具体的にする** – エージェントが呼び出すツールを認識できるように、ツール名を直接参照します (例: `list_investigations`、`use_aws`、`query_cloudwatch_logs`)。
+ **成功基準を定義する** – エージェントがいつ完了したかを知ることができるように、良い出力がどのようになるかを説明します。
+ **境界を設定する** – 意図しないアクションを防ぐためにエージェントがすべきでないことを明示的に記述します。
+ **マークダウン形式を使用する** – ヘッダー、リスト、コードブロックを使用すると、エージェントがプロンプトを簡単に解析して従うことができます。

## ツールの設定
<a name="configuring-tools"></a>

MCP ツールは、カスタムエージェントが呼び出し中に実行できるアクションを決定します。エージェントスペースで使用できるフルセットからツールを選択します。これには、接続された AWS アカウント、オブザーバビリティプラットフォーム、CI/CD パイプライン、チケットシステム、カスタム MCP サーバーのツールが含まれます。

ツールは Chat を介してのみ設定できます。エージェントの作成時にツールを割り当てるには、チャット作成方法を使用します。既存のエージェントでツールを追加または変更するには、チャットにエージェントの更新を依頼します。例えば、次のようになります。

```
Add the query_cloudwatch_logs and use_aws tools to my weekly-health-report agent.
```

```
Update certificate-checker to also use the list_resources tool.
```

```
Remove the use_kubectl tool from cluster-audit-agent.
```

ツールを選択するときは、最小特権の原則に従います。エージェントがタスクを達成するために必要なツールのみを割り当てます。これにより、意図しないアクションのリスクが軽減され、エージェントに集中できます。

## スキルの設定
<a name="configuring-skills"></a>

スキルは、カスタムエージェントに追加のドメイン知識、調査手順、または特殊な機能を提供します。カスタムエージェントが実行されると、割り当てられたスキルをロードし、呼び出し中に指示を参照できます。

作成時に (フォームまたはチャットを使用して) スキルを割り当てることも、エージェントを編集して後で追加することもできます。カスタムエージェントに割り当てられたスキルは、エージェントスペースに既に存在している必要があります。スキルの作成の詳細については、「」を参照してください[DevOps エージェントスキル](about-aws-devops-agent-devops-agent-skills.md)。

カスタムエージェントには、スキルの割り当てを必要としないアーティファクトとレコメンデーションを作成するための機能が組み込まれています。詳細については、「[カスタムエージェント出力](custom-agents-custom-agent-outputs.md)」を参照してください。

カスタムエージェントごとに最大 200 のスキルを割り当てることができます。コンテキストの消費を減らし、エージェントの集中力を向上させるために、エージェントの目的に関連するスキルを選択します。