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

# ツール一覧取得

> エージェントが内部で呼び出せるツールの一覧を取得します

# ツール一覧取得

エージェントが `POST /agent/run` / `POST /agent/run/stream` 実行時に内部で呼び出すツールの一覧を返します。クライアントがエージェントの能力を事前に把握したり、UI に機能バッジを表示したりするのに使います。

<Note>
  認証は不要です（public）。ワークスペースに依存しない静的カタログを返します。
</Note>

## リクエスト

```
GET /api/v1/agent/tools
```

ヘッダー・クエリパラメータともに不要です。

## レスポンス

```json theme={null}
{
  "tools": [
    {
      "id": "search",
      "displayName": "Web Search",
      "category": "research",
      "description": "General web search with query generation, SERP selection, scraping, and summary."
    },
    {
      "id": "x_search",
      "displayName": "X Search",
      "category": "research",
      "description": "Search posts on X (Twitter) with optional date range and account filters."
    },
    {
      "id": "plan",
      "displayName": "Plan",
      "category": "generation",
      "description": "Draft a multi-step research plan for human review before executing the full workflow."
    },
    {
      "id": "confirm_plan",
      "displayName": "Confirm Plan",
      "category": "hitl",
      "description": "Confirm a plan draft and start execution."
    },
    {
      "id": "mention_agent",
      "displayName": "Mention Agent",
      "category": "agent_integration",
      "description": "Hand off work to another agent referenced in the input via agent:// mention."
    }
  ]
}
```

### レスポンスフィールド

| フィールド                 | 型          | 説明                                                    |
| --------------------- | ---------- | ----------------------------------------------------- |
| `tools[].id`          | `string`   | ツールの内部 ID（エージェントが使う正式名）                               |
| `tools[].displayName` | `string`   | UI 表示用の英語名                                            |
| `tools[].category`    | `string`   | カテゴリ。詳細は下記                                            |
| `tools[].description` | `string`   | 機能の英語説明                                               |
| `tools[].trigger?`    | `string`   | chat-routing プロンプトでの発火条件（該当するツールのみ）                   |
| `tools[].inputs?`     | `string`   | 主要な入力パラメータ（該当するツールのみ）                                 |
| `tools[].modes?`      | `string[]` | サポートするモード（例: matrix の `create` / `edit` / `continue`） |
| `tools[].flow?`       | `string[]` | 内部ワークフローのステップ列                                        |
| `tools[].sseEvents?`  | `string[]` | このツールが発行する関連 SSE イベント名                                |
| `tools[].notes?`      | `string`   | 補足（外部エンドポイント、完了後フック等）                                 |

`trigger` / `inputs` / `modes` / `flow` / `sseEvents` / `notes` はオプショナル。ツールによって持つものと持たないものがある。

### カテゴリ

| 値                   | 意味                                                  |
| ------------------- | --------------------------------------------------- |
| `research`          | Web 検索・X 検索・ブラウザ自動化・ソース要約・RAG 検索など、情報収集を担うツール       |
| `generation`        | レポート・マトリクス・プランなど、構造化コンテンツを生成するツール                   |
| `hitl`              | ドラフトの確認・再生成・中止など、ユーザー介入フローで LLM が呼ぶツール              |
| `agent_integration` | 他エージェントへの委譲（`mention_agent`）、スキル実行、エージェント記憶の更新      |
| `internal`          | SERP 選別やブラウザ内での下請けなど、`chat-routing` から直接は呼ばれない内部ツール |

<Tip>
  本エンドポイントが返す一覧は **エージェントが持つ正本のツールセット**です。ドキュメントの説明文よりも、こちらの API レスポンスを優先してください。
</Tip>

## 使用例

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://app.snorbe.deskrex.ai/api/v1/agent/tools"
  ```

  ```python Python theme={null}
  import requests

  resp = requests.get("https://app.snorbe.deskrex.ai/api/v1/agent/tools")
  tools = resp.json()["tools"]
  for tool in tools:
      print(f"[{tool['category']}] {tool['id']} — {tool['displayName']}")
  ```

  ```typescript TypeScript theme={null}
  const resp = await fetch("https://app.snorbe.deskrex.ai/api/v1/agent/tools");
  const { tools } = await resp.json();
  for (const tool of tools) {
    console.log(`[${tool.category}] ${tool.id} — ${tool.displayName}`);
  }
  ```
</CodeGroup>

## エラーレスポンス

| HTTP ステータス | コード                 | 説明         |
| ---------- | ------------------- | ---------- |
| 429        | `TOO_MANY_REQUESTS` | レート制限超過（稀） |

## 関連

* [エージェント実行 (非ストリーミング)](/ja/api-reference/execute-agent)
* [エージェント実行 (SSE ストリーミング)](/ja/api-reference/stream-agent-run)
* [エージェント実行フロー](/ja/api-reference/agent-workflows)