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

# カスタムエージェントの管理
<a name="custom-agents-managing-custom-agents"></a>

カスタムエージェントを作成したら、その設定を編集して呼び出し履歴を表示し、不要になったら削除できます。

## カスタムエージェントの編集
<a name="editing-a-custom-agent"></a>

カスタムエージェントは、フォームまたはチャットを使用して編集できます。フォームでは、名前、システムプロンプト、スキルを更新できます。エージェントのツールを変更するには、チャットを使用します。

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

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

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

1. エージェントの詳細ページで、**編集** を選択します。

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

1. 更新するフィールドを変更します。
   + **名前** – エージェントの識別子を更新します (作成と同じ制約: 小文字、ハイフン、最大 64 文字）。
   + **システムプロンプト** – エージェントの指示を変更します (最小 10 文字、最大 50,000 文字）。
   + **スキル** – 検索フィールドを使用してスキルを追加または削除します。

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

変更しないフィールドは、現在の値を保持します。エージェントに割り当てられたツールは、フォームで編集するときに保持されます。

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

Chat に尋ねることで、ツールを含む任意のフィールドを更新できます。例えば、次のようになります。

```
Update weekly-health-report to also check for Lambda function errors.
```

```
Add the use_kubectl tool to my cluster-audit-agent.
```

```
Change the system prompt of certificate-checker to also report certificates expiring within 30 days.
```

チャットは、現在のエージェント設定を取得し、リクエストされた変更を適用して、保存前に確認します。言及しないフィールドは変更されません。

## 呼び出し履歴の表示
<a name="viewing-invocation-history"></a>

エージェントの詳細ページには、ステータス、トリガーソース、タイムスタンプなど、カスタムエージェントのすべての呼び出しの完全な履歴が表示されます。

**呼び出し履歴を表示するには:**

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

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

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

呼び出しテーブルには、次の情報が表示されます。


| 列 | [Description] (説明) | 
| --- | --- | 
| 呼び出し | エージェントが呼び出されたときに提供されるタスクタイトルまたは説明。 | 
| ステータス | 現在の呼び出しステータス (以下を参照）。 | 
| によってトリガーされます | 呼び出しの開始方法 — スケジュールされた実行のトリガー名、またはオンデマンド呼び出しの「手動」。 | 
| 起動済み | 呼び出しが開始された日時。 | 
| 最終更新日 | 最新のステータス変更の日時。 | 

呼び出しをステータスでフィルタリングしたり、タイトルで検索したりできます。テーブルは 10 秒ごとに自動的に更新され、実行中の呼び出しの更新ステータスが表示されます。

**呼び出しステータス:**


| ステータス | 説明 | 
| --- | --- | 
| 保留中の開始 | 呼び出しはキューに入れられ、スケジュールされるのを待っています。 | 
| 実行中 | エージェントはアクティブに実行されています。 | 
| 成功 | 呼び出しは正常に完了しました。 | 
| 失敗 | 呼び出しでエラーが発生し、停止しました。 | 
| タイムアウト | 呼び出しが 1 時間のタイムアウト制限を超えました。 | 
| キャンセル | 呼び出しは、完了前に手動でキャンセルされました。 | 

## 呼び出し軌跡の表示
<a name="viewing-an-invocation-trajectory"></a>

呼び出しの軌跡は、エージェントの作業の完全なトレースを示します。1 回の呼び出し中にエージェントが生成したすべてのツール呼び出し、結果、およびテキスト出力です。

**呼び出しの軌跡を表示するには:**

1. **履歴**タブから、検査する呼び出しを選択します。

1. 軌道タイムラインを確認します。

タイムラインには、以下のステップタイプが表示されます。
+ **ツール呼び出し** – エージェントが呼び出したツールとパラメータ。
+ **ツールの結果** – 各ツールによって返されるレスポンス。
+ **テキスト出力** – 呼び出し中にエージェントが生成したメッセージ。
+ **生成された出力** – エージェントが生成したアーティファクトまたはレコメンデーション。タイムラインの最後にリンクとして表示されます。

呼び出しを実行すると、軌道はリアルタイムで更新されます。実行中の呼び出しをキャンセルするには、軌道ビューの上部にある**キャンセル**を選択します。

## カスタムエージェントの削除
<a name="deleting-a-custom-agent"></a>

**重要**  
** カスタムエージェントを削除しても、すでに進行中の呼び出しには影響しません。呼び出しの実行は、完了、タイムアウト、またはキャンセルされるまで続行されます。ただし、削除後にエージェントを再度呼び出すことはできません。

Chat を使用してカスタムエージェントを削除できます。削除は永続的であり、元に戻すことはできません。

**カスタムエージェントを削除するには:**

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

```
Delete the custom agent weekly-health-report.
```

チャットは、エージェント名とタイプを確認してから削除します。エージェントにアクティブなトリガーがある場合は、エージェントと一緒に削除されます。