エージェントタブではエージェントの編集や削除はできません。エージェントへの変更は、適切なプロジェクトロールを持つユーザーが、所有プロジェクト内から行う必要があります。
前提条件
スーパーアドミンにフラグが立てられたユーザーのみがこのタブにアクセスできます。すべてのバックエンドエンドポイントは管理者のステータスを個別に検証し、UI 外から行われる直接 API 呼び出しを含む、他のすべてのユーザーには403 Unauthorized を返します。
場所
スーパーアドミン → ユーザーとワークスペース → エージェントに移動します。 タブはダッシュボードのメインコンテンツエリアに、アプリライセンス、プロジェクト、チーム、チームボット、ユーザーとともに表示されます。エージェントテーブル
テーブルはデフォルトで**最終更新日(降順)**でソートされています。この順序はページ送り間でも安定しており、前後へのページネーションでセッション中の行がシャッフルされることはありません。| 列 | 説明 |
|---|---|
| エージェント | エージェントの名前。空の場合は「無題」にフォールバックします。 |
| エージェント ID | チャットおよびプロジェクトルートで使用されるパブリックエージェント識別子。モノスペースで切り詰めて表示されます — フル値を表示するにはホバーしてください。 |
| プロジェクト | 所有プロジェクトの名前、2行目にプロジェクト ID が表示されます。 |
| チーム | プロジェクトを所有するチーム。 |
| 作成者 | エージェントの最初のバージョンを作成したユーザー。バージョン履歴以前のレガシーエージェントの場合はプロジェクトオーナーにフォールバックします。名前とメールアドレスが表示されます。 |
| 作成日 | エージェントの作成時刻(ローカルタイムゾーン)。 |
| 更新日 | 最終更新時刻。デフォルトのソート列です。 |
| メモリ | オン/オフバッジ。NULL はオフとして処理されます。 |
| プロンプトライブラリ | プロンプトライブラリ機能のオン/オフバッジ。NULL はオフとして処理されます。 |
| ブロック | エージェントにアタッチされたビルディングブロックの数。 |
| アクション | 目のアイコン — 詳細表示モーダルを開きます。 |
値が
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つ以上のエージェントを持つすべてのプロジェクトのドロップダウン(名前順)。 |
| 作成者 | すべてのユニークな作成者(初版の著者、またはエージェントを持つプロジェクトのプロジェクトオーナー)のドロップダウン。名前(メール) で表示。 |
| メモリ | 3状態:すべて / 有効 / 無効。無効には FALSE と NULL の両方が含まれます。 |
| プロンプトライブラリ | メモリと同じ3状態セマンティクス。 |
プロジェクトと作成者のドロップダウンは最大1,000エントリに制限されています。上限に達した場合、ドロップダウンの下に琥珀色のヒントが表示されます。リストに表示されないプロジェクトや作成者を見つけるには検索ボックスを使用してください — 検索はフルテーブルに対して実行されます。
詳細表示モーダル
任意の行の目のアイコンをクリックすると、そのエージェントの完全な設定が表示されます。モーダルは開くたびにライブデータを再取得します。 ヘッダーグリッド — 主要な設定フィールドの概要:| フィールド | 説明 |
|---|---|
| エージェント名 / エージェント ID | 識別子 |
| プロジェクト(名前 + ID) | 所有プロジェクト |
| チーム(名前 + ID) | 所有チーム |
| 作成者(名前 + メール + ユーザー ID) | 初版の著者(プロジェクトオーナーにフォールバック) |
| Temperature | 小数点以下2桁でフォーマット |
| 作成日 / 最終更新日 | タイムスタンプ |
| ビルディングブロック | アタッチされたブロックの数 |
| メモリ有効 / プロンプトライブラリ | 機能フラグ |
| URL マスク / ソース充実化 / インライン引用 / リンクフィルター | レスポンス動作フラグ |
| Google を使用 / KB を使用 | ソースフラグ |
- ペルソナ — 完全なシステムプロンプト(エクスポートとは異なり、切り詰めなし)
- アタッチされたブロック — ビルディングブロックの設定
- ルール — エージェントルール
- ドキュメントキー — ドキュメントスコープの設定
- メモリ設定 — メモリの設定
- プロンプト設定 — プロンプトライブラリの設定
— として表示されます。
データの更新
更新ボタン(円形矢印、検索ボックスの右)は、現在のクエリ(同じページ、検索、フィルター)を再実行します。検索ボックスに保留中の入力がある場合は、新しい検索をトリガーせず、変更される予定のクエリの古い結果を表示しないようデバウンスの安定を待ちます。 テーブルクエリは30秒間キャッシュされるため、訪れたことのあるページやフィルターステート間を移動すると即座に表示されます。エクスポート
エクスポートドロップダウン(右上)は、現在のビュー(すべてのアクティブな検索語とフィルターを含む)をダウンロード可能なファイルにストリーミングします。| 設定 | 詳細 |
|---|---|
| フォーマット | CSV と XLSX |
| ファイル名 | agents-<timestamp>.csv または agents-<timestamp>.xlsx |
| 行の上限 | 100,000行。超える場合はフィルターや検索を絞り込んでください。 |
| タイムスタンプ | ブラウザのローカルタイムゾーンでフォーマット |
| ペルソナ列 | 500文字に切り詰め、末尾に ... — 完全なプロンプトは詳細表示を開いて確認 |
| 列の順序 | 安定:name、agent_id、id、project_name、project_id、team_name、team_id、creator_name、creator_email、creator_user_id、… |
一般的なワークフロー
プロジェクト内のすべてのエージェントを検索
- スーパーアドミン → エージェントを開きます。
- プロジェクトフィルタードロップダウンでプロジェクトを選択します。
- 必要に応じてメモリまたはプロンプトライブラリでフィルタリングします。
- エクスポートをクリックして結果をファイルに保存します。
作成者別にエージェントを監査
- 作成者フィルタードロップダウンでユーザーを選択します。
- ドロップダウンにユーザーがいない場合は、名前またはメールを検索ボックスに入力します — 検索はフルテーブルに対して実行されます。
特定のエージェントの完全な設定を確認
- エージェント名で検索するか、
agent_idを検索ボックスに貼り付けます。 - 目のアイコンをクリックします。
- ヘッダーグリッドで高レベルの設定を、JSON ブロックでペルソナ、ルール、アタッチされたブロック、設定を確認します。
コンプライアンスレポートを作成
- フィルターを適用してスコープを定義します。
- エクスポート → XLSX(または CSV)をクリックします。
- ファイルは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文字以降のテキストが含まれていない場合
エクスポートファイルに約500文字以降のテキストが含まれていない場合
ペルソナはエクスポート時に意図的に500文字に切り詰められます。完全なシステムプロンプトを表示するには詳細表示モーダルを開いてください。
すべてのリクエストで 403 Unauthorized が発生する場合
すべてのリクエストで 403 Unauthorized が発生する場合