Agent Manager Toolkit
Agent Manager ツールキットを使うと、プロジェクト内のエージェントを作成・管理できます:プロンプトまたは設定から生成し、エージェントを一覧・検査し、ペルソナとツールキットを更新し、設定を検証し、モック付きのエンドツーエンドテストを実行します。OAuth も API キーも使用しません — アクセスは EKB のプロジェクト所属と Agents 権限に基づきます。
このツールキットは主に Autopilot(Build モード) や類似のビルドサーフェスから使用します。通常の顧客インテゲーションとしてすべてのエージェントにネストすることを目的としていません(Agent Manager 自身で作成したエージェントに Agent Manager をアタッチすることはできません)。
前提条件
- 対象プロジェクトでエージェントを編集する権限(作成/更新/削除/クローン/テストには Agents の編集権限)
- 読み取り専用操作(一覧、取得、検証、接続チェック)のプロジェクト所属
- 読み取り専用の Autopilot システムプロジェクトで作業する場合、作成・変更操作では常に対象プロジェクトを選択する
利用可能なツール
| ツール | 説明 |
|---|---|
| Get Available Toolkits | プラットフォームレジストリからツールキット名と説明を一覧表示(Agent Manager は除外)。 |
| Create Agent from Prompt | 自然言語の説明からエージェントを作成。対象プロジェクトが必要。 |
| Create Agent from Config | 明示的な名前、ペルソナ、ツールキット JSON、オプション(temperature、エージェントタイプ、出力形式、任意の MCP サーバー)からエージェントを作成。 |
| List Agent Templates | 組み込みのエージェントテンプレートを一覧表示。 |
| List Agents | プロジェクト内のエージェントを一覧表示。 |
| Get Agent | 1つのエージェントの詳細をすべて返す。 |
| Clone Agent | エージェントを新しい名前でクローン。 |
| Delete Agent | エージェントを完全に削除。 |
| Update Agent | ペルソナおよび/またはツールキット設定の全体を置き換え。 |
| Get Agent Toolkits | エージェントにアタッチされたツールキットを一覧表示。 |
| Search Agent Toolkits by Name | 名前パターンでエージェント上のツールキットを検索。 |
| Get Agent Toolkit by ID | id またはインデックスでツールキット設定を1つ返す。 |
| Get Toolkit Schema | ツールキットのスキーマ/例を返す。名前未指定のときはツールキット名を一覧表示。 |
| Validate Agent | エージェント設定および/またはツールキットを検証(config、toolkits、または full)。 |
| Test Agent | 外部統合をモック化し、実 LLM を使ったエンドツーエンドテストを生成・実行。 |
| Get Connection Requirements | エージェント上のツールキットの OAuth/API キーの状態を報告し、接続を完了できるようにする。 |
ユースケース
- Autopilot の Build モードで、短い説明からサポートまたはリサーチエージェントの足場を作る
- 実績のあるエージェントをクローンし、ペルソナとツールキットを調整する
- エージェントを公開する前にツールキット設定を検証する
- Gmail、Jira、類似のツールキットをアタッチした後、どの接続がまだ欠けているか確認する
ヒント
- 既にそのプロジェクトの中にいない場合は、作成/更新/削除時に常に対象プロジェクトを設定する(Autopilot のデフォルトプロジェクトからは必須)。
- 本番チャットで新しく構築したエージェントに依存する前に、Validate Agent を優先する。
- Delete Agent は完全な削除 — まずエージェント id とプロジェクトを確認する。
- MCP のシークレット(API キー、Authorization ヘッダー)はエージェント JSON のプレーンテキストではなく、プラットフォームのシークレット経路で保存される。
- 既存エージェントとの日常チャットには、そのエージェントに Agent Manager は不要 — ビルド側でのみ使用する。
トラブルシューティング
| 症状 | 確認すること |
|---|---|
| エージェントを作成・更新できない | 役割にプロジェクトの Agents 編集権限が必要 |
| デフォルト / Autopilot プロジェクトに関するエラー | 変更系ツールには明示的な対象プロジェクト id を渡す |
| ツールキットが公開されない / Agent Manager をアタッチできない | 想定どおり — Agent Manager は自分が作成したエージェントにインストールできない |
| Test Agent の結果が不完全に見える | 外部統合はモック化されている;ペルソナとローカルのツール動作に注目する |
| 接続要件がまだ失敗する | 一覧のツールキットの OAuth または API キー設定を完了し、再チェックする |