メインコンテンツへスキップ
エージェントタブは、EK 内のすべてのエージェントに対する読み取り専用のシステム全体の監査面です。スーパーアドミンがエージェントのインベントリを作成し、完全な設定を確認し、プロジェクトやチームとの相関関係を把握し、コンプライアンスやガバナンスレポート用に結果をエクスポートできます。個々のプロジェクトに移動せずにすべてを行えます。
エージェントタブではエージェントの編集や削除はできません。エージェントへの変更は、適切なプロジェクトロールを持つユーザーが、所有プロジェクト内から行う必要があります。

​
前提条件

スーパーアドミンにフラグが立てられたユーザーのみがこのタブにアクセスできます。すべてのバックエンドエンドポイントは管理者のステータスを個別に検証し、UI 外から行われる直接 API 呼び出しを含む、他のすべてのユーザーには 403 Unauthorized を返します。

​
場所

スーパーアドミン → ユーザーとワークスペース → エージェントに移動します。 タブはダッシュボードのメインコンテンツエリアに、アプリライセンス、プロジェクト、チーム、チームボット、ユーザーとともに表示されます。

​
エージェントテーブル

テーブルはデフォルトで**最終更新日（降順）**でソートされています。この順序はページ送り間でも安定しており、前後へのページネーションでセッション中の行がシャッフルされることはありません。
値が NULL または空の場合、タイムスタンプを含むすべての場所にダッシュ（—）が表示されます。

​
検索モードとリストモード

タブは検索ボックスがアクティブかどうかに応じて、2つのモードで動作します。

​
リストモード（デフォルト）

  • 検索ボックスが空のときにアクティブ
  • テーブルは1行12件でページネーション
  • ページネーションコントロールに Page X of Y が表示
  • フィルターは通常通り適用；フィルター変更時にページ1にリセット

​
検索モード

  • 検索ボックスに入力すると即座にアクティブ化（400ミリ秒のデバウンス）
  • ページネーションは非表示；バックエンドが1回のレスポンスで最大200件の一致行を返す
  • 真の一致数が200件を超える場合、サマリーラインに 4815 match(es) (showing first 200 — narrow the search to see more) と表示されます — クエリを絞り込むかフィルターを追加して残りを表示
  • 検索はエージェント名、エージェント ID、プロジェクト名、作成者名/メールに対して大文字・小文字を区別しない部分一致を同時に行います
  • _ や % 文字を含む UUID の貼り付けは安全です — これらの文字はワイルドカードとして扱われません
  • 最大クエリ長：100文字
ドロップダウンフィルターは両方のモードで検索の上に積み重なるため、テキスト検索をプロジェクト、作成者、機能フィルターと同時に組み合わせることができます。

​
フィルター

検索バーの下に4つのフィルターが表示されます。フィルターのいずれかを変更するとページが1にリセットされます。
プロジェクトと作成者のドロップダウンは最大1,000エントリに制限されています。上限に達した場合、ドロップダウンの下に琥珀色のヒントが表示されます。リストに表示されないプロジェクトや作成者を見つけるには検索ボックスを使用してください — 検索はフルテーブルに対して実行されます。
検索とフィルターをクリアボタンを使用して、検索ボックスとすべてのドロップダウンを一度にリセットします。

​
詳細表示モーダル

任意の行の目のアイコンをクリックすると、そのエージェントの完全な設定が表示されます。モーダルは開くたびにライブデータを再取得します。 ヘッダーグリッド — 主要な設定フィールドの概要： JSON / テキストブロック — 生の、スクロール可能な、整形されたデータ：
  • ペルソナ — 完全なシステムプロンプト（エクスポートとは異なり、切り詰めなし）
  • アタッチされたブロック — ビルディングブロックの設定
  • ルール — エージェントルール
  • ドキュメントキー — ドキュメントスコープの設定
  • メモリ設定 — メモリの設定
  • プロンプト設定 — プロンプトライブラリの設定
空値と NULL 値はすべて — として表示されます。

​
データの更新

更新ボタン（円形矢印、検索ボックスの右）は、現在のクエリ（同じページ、検索、フィルター）を再実行します。検索ボックスに保留中の入力がある場合は、新しい検索をトリガーせず、変更される予定のクエリの古い結果を表示しないようデバウンスの安定を待ちます。 テーブルクエリは30秒間キャッシュされるため、訪れたことのあるページやフィルターステート間を移動すると即座に表示されます。

​
エクスポート

エクスポートドロップダウン（右上）は、現在のビュー（すべてのアクティブな検索語とフィルターを含む）をダウンロード可能なファイルにストリーミングします。

​
一般的なワークフロー

​
プロジェクト内のすべてのエージェントを検索

  1. スーパーアドミン → エージェントを開きます。
  2. プロジェクトフィルタードロップダウンでプロジェクトを選択します。
  3. 必要に応じてメモリまたはプロンプトライブラリでフィルタリングします。
  4. エクスポートをクリックして結果をファイルに保存します。

​
作成者別にエージェントを監査

  1. 作成者フィルタードロップダウンでユーザーを選択します。
  2. ドロップダウンにユーザーがいない場合は、名前またはメールを検索ボックスに入力します — 検索はフルテーブルに対して実行されます。

​
特定のエージェントの完全な設定を確認

  1. エージェント名で検索するか、agent_id を検索ボックスに貼り付けます。
  2. 目のアイコンをクリックします。
  3. ヘッダーグリッドで高レベルの設定を、JSON ブロックでペルソナ、ルール、アタッチされたブロック、設定を確認します。

​
コンプライアンスレポートを作成

  1. フィルターを適用してスコープを定義します。
  2. エクスポート → XLSX（または CSV）をクリックします。
  3. ファイルは100,000行まで、画面上のビューと完全に一致します。

​
トラブルシューティング

バックエンドが2xx以外のレスポンスを返しました。ブラウザの DevTools → Network でステータスコードを確認してください。完全なエラー詳細はバックエンドログの Error fetching agents にあります。
ドロップダウンは1,000エントリに制限されています。ドロップダウンの下にある琥珀色の「Showing first 1000…」ヒントを確認してください。代わりに検索ボックスを使用してください — フルテーブルをクエリします。
検索結果は1レスポンスあたり200行に制限されています。サマリーラインに真の一致数が表示されます。フィルターを追加するかクエリを絞り込んで、結果セットを200件以下に抑えてください。
エージェントはバージョン履歴が存在する前に作成されました。これらのレガシーエージェントには、プロジェクトオーナーが意図的なフォールバックとして使用されます。
列は NULL をオフとして扱います。これはランタイム動作と一致します。値がオンであるべき場合は、データベースで直接 agents.memory_enabled または agents.prompt_library_enabled を確認してください。
ペルソナはエクスポート時に意図的に500文字に切り詰められます。完全なシステムプロンプトを表示するには詳細表示モーダルを開いてください。
お客様のアカウントにはスーパーアドミンのフラグが立てられていません（users.is_admin = true）。システム管理者にお問い合わせください。