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

# カスタムエージェントの実行
<a name="custom-agents-executing-custom-agents"></a>

カスタムエージェントをオンデマンドで実行することも、トリガーを設定して自動的に実行することもできます。

## カスタムエージェントをオンデマンドで実行する
<a name="running-a-custom-agent-on-demand"></a>

カスタムエージェントは、エージェントの詳細ページまたはチャットからすぐに実行できます。

**詳細ページからカスタムエージェントを実行するには:**

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

1. 実行するカスタムエージェントを選択します。

1. **Run Now** を選択して、設定された手順でエージェントを実行します。

特定の実行に関する追加のコンテキストを提供するには、**Run Now** の横にあるドロップダウン矢印を選択し、エージェントがこの呼び出しで何に集中すべきかを説明するプロンプトを入力し、**プロンプトで実行**を選択します。プロンプトは、システムプロンプトとともに追加のコンテキストとしてエージェントに渡されます。

実行が開始されると、新しい呼び出しが「開始保留中」のステータスの**履歴**タブに表示されます。呼び出しを選択すると、その軌道がリアルタイムで表示されます。

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

チャットに名前でエージェントを実行するように依頼します。例えば、次のようになります。

```
Run my weekly-investigation-report agent.
```

```
Run certificate-checker and focus on certificates expiring in the next 7 days.
```

チャットメッセージに追加のコンテキストを指定すると、チャットはその実行のプロンプトとしてそれを渡します。追加のコンテキストを指定しない場合、エージェントは設定されたシステムプロンプトでのみ実行されます。

カスタムエージェントは一度に 1 つの呼び出ししか実行できません。エージェントがすでに実行されている場合は、別の呼び出しを開始する前に、現在の呼び出しが完了、タイムアウト、またはキャンセルされるのを待つ必要があります。

## カスタムエージェントのスケジューリング
<a name="scheduling-custom-agents"></a>

トリガーを使用すると、定義された条件に基づいてカスタムエージェントを自動的に実行できます。 AWS DevOps Agent は現在、EventBridge 互換の cron 式または rate 式を使用して定期的な間隔でエージェントを実行するスケジュールベースのトリガーをサポートしています。

**スケジュールトリガーを作成するには:**

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

1. スケジュールするカスタムエージェントを選択します。

1. [**Triggers**] タブを選択します。

1. **\+** (作成) ボタンを選択します。

1. ダイアログで、入力フィールドにスケジュール式を入力します。式は、次のいずれかの形式である必要があります。
   + **Rate 式** – 一定の間隔で実行されます。形式: `rate(value unit)`。例:
     + `rate(1 hour)` – 1 時間ごと
     + `rate(30 minutes)` – 30 分ごと
     + `rate(7 days)` – 7 日ごと
   + **Cron 式** – 特定のスケジュールで実行されます。形式: `cron(minutes hours day-of-month month day-of-week year)`。例:
     + `cron(0 9 ? * MON-FRI *)` – 毎週平日の午前 9:00 UTC
     + `cron(0 0 1 * ? *)` – 毎月 1 日午前 0 時 UTC
     + `cron(0 */6 ? * * *)` – 6 時間ごと

式が有効になると、緑色の確認メッセージが表示されます。

1. **[作成]** を選択します。

cron 式の場合、day-of-monthまたはday-of-weekの厳密に 1 つである必要があります `?` (疑問符）。スケジュール式の構文の詳細については、*「Amazon EventBridge スケジューラユーザーガイド*」の[「スケジュールタイプ](https://docs.aws.amazon.com/scheduler/latest/UserGuide/schedule-types.html)」を参照してください。

作成後、トリガーがリストに表示され、式、作成日、次にスケジュールされた実行時間が表示されます。

## トリガーの管理
<a name="managing-triggers"></a>

**Triggers** タブには、カスタムエージェント用に設定されたすべてのトリガーが表示されます。トリガーごとに、スケジュール式、作成日時、次に実行する日時を確認できます。

**トリガーの一時停止:**

削除せずにトリガーがエージェントを呼び出すのを一時的に停止するには、トリガーの横にあるトグルスイッチをオフにします。トリガーステータスは「一時停止」に変わり、再度有効にするまで起動しなくなります。トグルを再度オンにして、スケジュールを再開します。

**トリガーの削除:**

トリガーを完全に削除するには、削除するトリガーの横にある削除アイコン (ゴミ箱) を選択します。表示されるダイアログで削除を確認します。削除されたトリガーは復元できません。

## 呼び出しのキャンセル
<a name="canceling-an-invocation"></a>

実行中の呼び出しは、呼び出しの軌跡ビューまたはチャットからキャンセルできます。

**軌道ビューから実行中の呼び出しをキャンセルするには:**

1. **履歴**タブから、実行中の呼び出しを選択します。

1. 軌道ビューの上部にある**キャンセル**を選択します。

**Chat を使用して実行中の呼び出しをキャンセルするには:**

```
Cancel the running invocation of weekly-health-report.
```

呼び出しステータスが「キャンセル済み」に変わります。キャンセル前に完了した作業は、軌道に保持されます。キャンセルが発生したときに進行中のツール呼び出しは、まだ完了している可能性があります。

## ツール呼び出しの結果
<a name="tool-call-results"></a>

呼び出し中、カスタムエージェントは MCP ツールを呼び出してデータを収集し、アクションを実行し、出力を生成します。各ツール呼び出しとその結果は、呼び出しの軌跡に記録されます。

ツール呼び出しの結果は、呼び出し中にエージェントが何をしたかを明確にします。
+ **ツール呼び出し**の成功 – このツールは、エージェントが作業を続行するために使用するデータを返しました。たとえば、 はログエントリ`query_cloudwatch_logs`を返し、 は API レスポンス`use_aws`を返します。
+ **失敗したツール呼び出し** – ツールはエラーを返しました。エージェントは再試行したり、代替アプローチを試したり、出力に障害を報告したりすることがあります。

個々のツール呼び出しとその結果を呼び出し軌道で検査して、エージェントの動作を理解し、正しいリソースにアクセスしたことを検証し、予期しない結果をトラブルシューティングできます。軌道の表示の詳細については、[「呼び出し軌道の表示](custom-agents-managing-custom-agents.md)」を参照してください。