---
id: tools
title: ツールリファレンス
category: advanced
order: 160
keywords: [ツール, tools, リファレンス, ReadToolDoc, 一覧]
---

## ツールとは

ツールは、エージェントがタスクの中で使う「できること」です。ファイルの読み書き、Web 検索、ブラウザ操作、ドキュメント解析など、エージェントは LLM の推論とツール呼び出しを交互に繰り返してタスクを進めます。

どのツールが使えるかは **ワークスペースのツールポリシー** で決まります。標準カテゴリ（Read / Write / Web / Office など）はデフォルトで有効です。SSH・ブラウザ操作・Bash（任意コマンド実行）などのセンシティブなカテゴリはデフォルト無効で、ワークスペースのオーナーが **設定 → ツール** タブで明示的にオンにする必要があります。ポリシーの詳細は [ワークスペースとメンバー](./21-workspaces.md) を参照してください。

movement の開始時には、その movement で使えるツールの一覧と 1 行サマリが自動でエージェントに提示されます。Piece の指示文にツールの使い方を書く必要はありません。

## カテゴリ別の概要

以下はカテゴリの全体像です。網羅的なツール一覧ではありません (ツールは追加・変更されるため、最新の一覧は後述の方法で確認してください)。

| カテゴリ | できること | 例 |
|---|---|---|
| ファイル / シェル | ワークスペースのファイル操作とコマンド実行（Read は Excel / Word / PDF / PPTX / メールも拡張子で自動判定して読む） | Read / Write / Edit / Bash / Glob / Grep |
| Web / 検索 | Web 検索・取得・ダウンロード | WebSearch / WebFetch / DownloadFile |
| 技術ドキュメント | Microsoft Learn の公式ドキュメントを検索・取得 | SearchMicrosoftLearn / FetchMicrosoftLearn |
| ブラウザ | 実ブラウザでのページ操作 | BrowseWeb |
| Office / ドキュメント | Excel / Word / PDF / PPTX は Read で解析（前処理・画像化は専用ツール） | Read / SplitExcelSheets / PdfToImages |
| データ | SQLite データベース操作 | SQLite |
| 画像 | 画像の読み取り・注釈 | ReadImage / AnnotateImage |
| レビュー | LLM による一括レビュー | BatchReviewTextWithLLM |
| スライド | PPTX スライド生成 | AddSlide / BuildPptx / SetTheme |
| チェックリスト | タスク内の進捗チェックリスト | CreateChecklist / CheckItem |
| SSH | リモート実行・転送・対話コンソール | SshExec / SshUpload / SshConsoleSend |
| オーケストレーション | サブタスクの生成 | SpawnSubTask |
| 地図 | 場所検索・経路・逆ジオコーディング | SearchPlaces / GetDirections |
| メディア | 文字起こし・動画検索・字幕取得 | TranscribeAudio / SearchYouTube / GetYouTubeTranscript |
| カレンダー | ワークスペースのカレンダーへ予定を登録・参照 | AddCalendarEvent / ListCalendarEvents |
| その他 | X(旧Twitter)検索・Amazon 検索など | XSearch / SearchAmazon |

SSH 系の詳しい使い方は [SSH リモート操作](./14-ssh.md) を参照してください。

### ブラウザのスクリーンショット

ブラウザ操作ツール（`BrowseWeb`・`BrowseWithSession`）でページのスクリーンショットを撮ると、縦に長いページは既定で **1 画面ぶん（ビューポート高さ）ごとに区切った複数枚**（`page-001.png`, `page-002.png` …）に自動分割して保存します。1 画面に収まるページは 1 枚のままです。全体を縦長の 1 枚で撮りたいときはフルページ指定に切り替えられます。どちらのツールでも同じ挙動です（詳細は `ReadToolDoc({ name: "BrowseWeb" })`）。

### テキストの文字コードとバイナリの扱い

Read と Grep は、UTF-8 以外で保存されたテキストも読めます。Windows で保存した日本語の `.txt` や、Excel から出した CSV に多い **Shift_JIS（CP932）**、そのほか EUC-JP なども自動で判別し、UTF-8 に変換して表示・検索します。Read の先頭には検出したエンコーディングが注記されます。Edit で書き換えたときは元のエンコーディングのまま保存するので、Windows 側のツールがそのまま使えます。

画像・ZIP・実行ファイルなどの本物のバイナリは、これまでどおり Read が拒否します。Grep も対象フォルダに画像などのバイナリが混じっていた場合は自動でスキップするので、検索結果にバイナリの断片が紛れ込みません。画像を内容まで読みたいときは `ReadImage` を使ってください。

### 大きすぎる出力の自動切り詰め

Read と Bash に加えて、**Grep の検索結果も残コンテキスト予算に収まるよう自動で切り詰められる**ようになりました。緩いパターンでマッチが数万行に及ぶような場合、先頭部分だけが返り、冒頭に「自動切り詰め」の注記（元の件数と、pattern を具体的にする・`glob` や `path` で範囲を絞るといった対処の案内）が付きます。結果が途中で終わっているのは不具合ではなく、この保護が働いた状態です。

### PDF・Excel を途中から読むときの範囲指定

Read の `offset`／`limit`（行指定）と `byte_offset`／`byte_length` は**テキストファイル専用**です。PDF・Excel・Word ではこれらは無視されます。PDF を特定のページだけ読むときは `page_range`（例 `"5-10"`）、Excel は `sheet` と `range`（例 `"A1:D50"`）を使います。誤って PDF に `offset` を渡した場合は、無視して先頭に戻る代わりに、正しいパラメータへの案内が出力に付きます。

## 常時利用できるメタツール

一部のツールは、ワークスペースのツールポリシーやカテゴリ設定に関係なく常に利用できます。エージェントが「自分の状況を確認する」「足りないものを補う」ための土台になるツール群です。

- `ReadToolDoc` — 任意のツールの詳細ドキュメント (手順・引数・gotcha) を取得する。例: `ReadToolDoc({ name: "BrowseWeb" })`
- `ReadSkill` / `ListSkills` / `InstallSkill` — Skill の一覧・本文取得・追加（→[スキル](./11-skills.md)）
- `RequestTool` — タスクに足りないツールの利用を申請する。チャット上でオーナーが承認すると、その場で使えるようになる
- `ReadUserMemory` / `UpdateUserMemory` — ワークスペースのメモリを読み書きする（→[メモリ](./12-memory.md)）
- `CreateChecklist` / `CheckItem` / `GetChecklist` — タスク内の進捗チェックリスト
- `MissionUpdate` — 長時間タスクで、目標・進捗に加えてユーザー制約・決定事項・現在の焦点をピン留めするメモ（Mission Brief）を更新する
- `SearchTaskConversation` / `ReadTaskConversation` — このタスクの過去のやり取り（コメント＋実行ログ）を検索し、前後の文脈を読み直す。「前に何を言ったか」を聞き直す前にエージェントが自分で思い出すために使う
- `SearchWorkspaceTasks` — 同じワークスペース内の**他タスク**の会話を横断検索する（`SearchTaskConversation` は現在タスクのみ）。タスクの状態は問わず、同じワークスペースを見られるメンバーの範囲で検索する。検索結果はツール名や添付ファイル名までしか出さない要約だが、`around_ref` で前後を辿ると元のコメント本文をそのまま読める
- `GetMyOrchestratorState` — 自分が今どのワークスペース・タスクで動いているかを把握する
- `ReadAppDoc` / `ListAppDocs` — アプリ内のヘルプ・ドキュメントをエージェント自身が読む（`#help` のヘルプ応答などで使われる）

各ツールの function definition は 1 文に圧縮されているため、詳しい使い方はこの `ReadToolDoc` で取得する設計です。

## 最新の一覧と詳細を見る

ツールは追加・名称変更されることがあります。常に最新の状態を確認するには次を使ってください。

- 設定 → Tools (admin 専用): カテゴリ別にツールの有効化・上限・外部サービス連携を設定。Web & Search / Browser Runtime / Media & Documents / External Services などのセクションに分かれます。設定画面の見方は [設定](./17-settings.md) を参照
- ReadToolDoc: 個々のツールの完全な仕様。エージェント自身も実行中にこれを参照します

このページのカテゴリ表はあくまで概要です。「どのツールが今このタスクで使えるか」はワークスペースのツールポリシーと admin の Tools 設定で決まります。
