> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# エージェント

> すべてのチームとプロジェクトにわたるすべてのエージェントを、システム全体のビューから監査および確認します。

エージェントタブは、EK 内のすべてのエージェントに対する**読み取り専用のシステム全体の監査面**です。スーパーアドミンがエージェントのインベントリを作成し、完全な設定を確認し、プロジェクトやチームとの相関関係を把握し、コンプライアンスやガバナンスレポート用に結果をエクスポートできます。個々のプロジェクトに移動せずにすべてを行えます。

<Note>
  エージェントタブではエージェントの編集や削除はできません。エージェントへの変更は、適切なプロジェクトロールを持つユーザーが、所有プロジェクト内から行う必要があります。
</Note>

## 前提条件

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

## 場所

**スーパーアドミン → ユーザーとワークスペース → エージェント**に移動します。

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

## エージェントテーブル

テーブルはデフォルトで\*\*最終更新日（降順）\*\*でソートされています。この順序はページ送り間でも安定しており、前後へのページネーションでセッション中の行がシャッフルされることはありません。

| 列              | 説明                                                                                        |
| -------------- | ----------------------------------------------------------------------------------------- |
| **エージェント**     | エージェントの名前。空の場合は「無題」にフォールバックします。                                                           |
| **エージェント ID**  | チャットおよびプロジェクトルートで使用されるパブリックエージェント識別子。モノスペースで切り詰めて表示されます — フル値を表示するにはホバーしてください。            |
| **プロジェクト**     | 所有プロジェクトの名前、2行目にプロジェクト ID が表示されます。                                                        |
| **チーム**        | プロジェクトを所有するチーム。                                                                           |
| **作成者**        | エージェントの最初のバージョンを作成したユーザー。バージョン履歴以前のレガシーエージェントの場合はプロジェクトオーナーにフォールバックします。名前とメールアドレスが表示されます。 |
| **作成日**        | エージェントの作成時刻（ローカルタイムゾーン）。                                                                  |
| **更新日**        | 最終更新時刻。デフォルトのソート列です。                                                                      |
| **メモリ**        | オン/オフバッジ。`NULL` はオフとして処理されます。                                                             |
| **プロンプトライブラリ** | プロンプトライブラリ機能のオン/オフバッジ。`NULL` はオフとして処理されます。                                                |
| **ブロック**       | エージェントにアタッチされたビルディングブロックの数。                                                               |
| **アクション**      | 目のアイコン — [詳細表示モーダル](#view-details-modal)を開きます。                                            |

<Note>
  値が `NULL` または空の場合、タイムスタンプを含むすべての場所にダッシュ（`—`）が表示されます。
</Note>

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

タブは検索ボックスがアクティブかどうかに応じて、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状態セマンティクス。                                                        |

<Note>
  プロジェクトと作成者のドロップダウンは最大**1,000エントリ**に制限されています。上限に達した場合、ドロップダウンの下に琥珀色のヒントが表示されます。リストに表示されないプロジェクトや作成者を見つけるには検索ボックスを使用してください — 検索はフルテーブルに対して実行されます。
</Note>

**検索とフィルターをクリア**ボタンを使用して、検索ボックスとすべてのドロップダウンを一度にリセットします。

## 詳細表示モーダル

任意の行の目のアイコンをクリックすると、そのエージェントの完全な設定が表示されます。モーダルは開くたびにライブデータを再取得します。

**ヘッダーグリッド** — 主要な設定フィールドの概要：

| フィールド                                 | 説明                        |
| ------------------------------------- | ------------------------- |
| エージェント名 / エージェント ID                   | 識別子                       |
| プロジェクト（名前 + ID）                       | 所有プロジェクト                  |
| チーム（名前 + ID）                          | 所有チーム                     |
| 作成者（名前 + メール + ユーザー ID）               | 初版の著者（プロジェクトオーナーにフォールバック） |
| Temperature                           | 小数点以下2桁でフォーマット            |
| 作成日 / 最終更新日                           | タイムスタンプ                   |
| ビルディングブロック                            | アタッチされたブロックの数             |
| メモリ有効 / プロンプトライブラリ                    | 機能フラグ                     |
| URL マスク / ソース充実化 / インライン引用 / リンクフィルター | レスポンス動作フラグ                |
| Google を使用 / KB を使用                   | ソースフラグ                    |

**JSON / テキストブロック** — 生の、スクロール可能な、整形されたデータ：

* **ペルソナ** — 完全なシステムプロンプト（エクスポートとは異なり、切り詰めなし）
* **アタッチされたブロック** — ビルディングブロックの設定
* **ルール** — エージェントルール
* **ドキュメントキー** — ドキュメントスコープの設定
* **メモリ設定** — メモリの設定
* **プロンプト設定** — プロンプトライブラリの設定

空値と NULL 値はすべて `—` として表示されます。

## データの更新

**更新ボタン**（円形矢印、検索ボックスの右）は、現在のクエリ（同じページ、検索、フィルター）を再実行します。検索ボックスに保留中の入力がある場合は、新しい検索をトリガーせず、変更される予定のクエリの古い結果を表示しないようデバウンスの安定を待ちます。

テーブルクエリは**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`、… |

## 一般的なワークフロー

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

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

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

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

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

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

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

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

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

<AccordionGroup>
  <Accordion title="エージェントの読み込みに失敗した場合">
    バックエンドが2xx以外のレスポンスを返しました。ブラウザの DevTools → Network でステータスコードを確認してください。完全なエラー詳細はバックエンドログの `Error fetching agents` にあります。
  </Accordion>

  <Accordion title="フィルタードロップダウンにプロジェクトまたは作成者が表示されない場合">
    ドロップダウンは1,000エントリに制限されています。ドロップダウンの下にある琥珀色の「Showing first 1000…」ヒントを確認してください。代わりに検索ボックスを使用してください — フルテーブルをクエリします。
  </Accordion>

  <Accordion title="検索結果の行数が期待より少ない場合">
    検索結果は1レスポンスあたり200行に制限されています。サマリーラインに真の一致数が表示されます。フィルターを追加するかクエリを絞り込んで、結果セットを200件以下に抑えてください。
  </Accordion>

  <Accordion title="作成者列に実際の著者ではなくプロジェクトオーナーが表示される場合">
    エージェントはバージョン履歴が存在する前に作成されました。これらのレガシーエージェントには、プロジェクトオーナーが意図的なフォールバックとして使用されます。
  </Accordion>

  <Accordion title="メモリまたはプロンプトライブラリがオフと表示されるが、機能は設定済みに見える場合">
    列は `NULL` をオフとして扱います。これはランタイム動作と一致します。値がオンであるべき場合は、データベースで直接 `agents.memory_enabled` または `agents.prompt_library_enabled` を確認してください。
  </Accordion>

  <Accordion title="エクスポートファイルに約500文字以降のテキストが含まれていない場合">
    ペルソナはエクスポート時に意図的に500文字に切り詰められます。完全なシステムプロンプトを表示するには詳細表示モーダルを開いてください。
  </Accordion>

  <Accordion title="すべてのリクエストで 403 Unauthorized が発生する場合">
    お客様のアカウントにはスーパーアドミンのフラグが立てられていません（`users.is_admin = true`）。システム管理者にお問い合わせください。
  </Accordion>
</AccordionGroup>