エージェント管理
概要
エージェントは、特定のタスクを実行するためのワークフローを定義したものです。複数のステップ（コマンド）を組み合わせて、自動化されたワークフローを構築できます。
エージェント一覧
ヘッダーの「エージェント」をクリックすると、エージェント一覧画面が表示されます。
一覧の構成
各エージェントはカード形式で表示され、以下の情報を確認できます：
- エージェント名
- 説明文
- ステップ数
- 公開/非公開ステータス
- 作成者
エージェントの操作
各エージェントカードから以下の操作が可能です：
| 操作 | 説明 |
|---|---|
| 編集 | エージェントの詳細画面を開いて編集 |
| 複製 | エージェントのコピーを作成 |
| 削除 | エージェントを削除（確認ダイアログあり） |
注意: システムエージェント（システムが自動作成したもの）は読み取り専用で、編集・削除はできません。
エージェントの作成
「エージェント作成」ボタンをクリックすると、作成モードの選択画面が表示されます。
おまかせ作成（AI支援モード）
AIがゴール（目標）に基づいてワークフローを自動提案するモードです。
手順
- 「おまかせ作成」を選択します
- 基本情報を入力します：
- エージェント名: エージェントの名前
- 説明: エージェントの用途や目的
- ワーカー: 実行に使用するワーカーを選択
- ゴールに「やりたいこと」を入力します（例：「GitHubのリポジトリからコードを取得し、テストを実行して結果をレポートする」）
- AIがゴールを分析し、ワークフローステップを提案します
- 提案されたステップを確認・修正します：
- ステップの追加・削除
- ステップの順序変更
- 各ステップの設定調整
- 必要に応じて環境変数を設定します
- 「保存」をクリックしてエージェントを作成します
カスタム作成（手動モード）
ステップを手動で一つずつ追加してワークフローを構築するモードです。
手順
- 「カスタム」を選択します
- 基本情報を入力します：
- エージェント名: エージェントの名前
- 説明: エージェントの用途や目的
- ワーカー: 実行に使用するワーカーを選択
- ワーカーの初期化コマンド（initコマンド）が自動的に最初のステップに追加されます
- ワーカーが提供するコマンド一覧からステップを追加します：
- コマンドを選択して「追加」をクリック
- 各ステップのパラメータを設定
- ステップの順序をドラッグまたは上下ボタンで調整します
- 各ステップのオプションを設定します：
- 必須（Required）: このステップが失敗した場合にワークフローが停止
- 有効（Enabled）: このステップを有効/無効化
- API使用（useInApi）: APIからの呼び出し時にこのステップを含める
- 必要に応じて環境変数を設定します
- 「保存」をクリックしてエージェントを作成します
エージェントの編集
エージェント一覧から対象のエージェントをクリックまたは編集アイコンをクリックすると、エージェント詳細画面が表示されます。
基本情報の編集
- エージェント名: 名前を変更
- 説明: 説明文を更新
- ゴール: エージェントの目標を変更（おまかせ作成で作成した場合）
ステップの管理
- ステップの追加: ワーカーのコマンド一覧から新しいステップを追加
- ステップの削除: 不要なステップを削除
- ステップの並べ替え: ドラッグ＆ドロップまたは上下ボタンで順序を変更
設定オプション
| 設定 | 説明 |
|---|---|
| エラー時停止（stopOnError） | ステップが失敗した場合にワークフロー全体を停止する |
| 自動リトライ（autoRetry） | 失敗したステップを自動的に再実行する |
| 有効/無効（Active） | エージェントを有効化/無効化する |
| 公開/非公開（Public） | 他のユーザーがこのエージェントを利用できるようにする |
環境変数
エージェント実行時に使用する環境変数を設定できます。
- 「環境変数」セクションで「追加」ボタンをクリックします
- キーと値を入力します
- 複数の環境変数を追加できます
- 不要な環境変数は削除ボタンで削除します
変更履歴
エージェント詳細画面の下部に、変更履歴がタイムライン形式で表示されます。
- 変更日時
- 変更者
- 変更内容の概要
ワーカー情報
エージェントに割り当てられたワーカーの情報が表示されます（読み取り専用）。
エージェントの削除
- エージェント一覧で対象エージェントの削除アイコンをクリックします
- 確認ダイアログが表示されます
- 「削除」をクリックして削除を確定します
注意: 削除したエージェントは復元できません。関連する会話は残りますが、エージェントは利用できなくなります。
チャットでのエージェント利用
作成したエージェントは、チャット画面のエージェント選択ドロップダウンから選択して利用できます。
- チャット画面を開きます
- エージェント選択ドロップダウンからエージェントを選択します
- メッセージを入力して送信します
- エージェントが設定されたワークフローに従って応答を生成します