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

## ツールとは

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

どのツールが使えるかは Piece の `allowed_tools` で決まります。`allowed_tools` に載っていないツールはエージェントに一切提示されません。Piece とツールの関係は [piece を使う・作る](./05-pieces.md) を参照してください。

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

## カテゴリ別の概要

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

| カテゴリ | できること | 例 |
|---|---|---|
| ファイル / シェル | ワークスペースのファイル操作とコマンド実行 | Read / Write / Edit / Bash / Glob / Grep |
| Web / 検索 | Web 検索・取得・ダウンロード | WebSearch / WebFetch / DownloadFile |
| ブラウザ | 実ブラウザでのページ操作 | BrowseWeb |
| Office / ドキュメント | Excel / Word / PDF / PPTX の解析 | ReadExcel / ReadPdf / ReadDocx |
| データ | SQLite データベース操作 | SQLite |
| 知識検索 | ドキュメントの取り込みと検索 | SearchKnowledge / ListDocuments |
| 画像 | 画像の読み取り・注釈 | ReadImage / AnnotateImage |
| レビュー | LLM による一括レビュー | BatchReviewTextWithLLM |
| スライド | PPTX スライド生成 | AddSlide / BuildPptx / SetTheme |
| チェックリスト | タスク内の進捗チェックリスト | CreateChecklist / CheckItem |
| ノート / テンプレート | 共有ノート・ユーザーテンプレート | SearchNotes / ReadNote / RenderUserTemplate |
| SSH | リモート実行・転送・対話コンソール | SshExec / SshUpload / SshConsoleSend |
| オーケストレーション | サブタスクの生成 | SpawnSubTask |
| 地図 | 場所検索・経路・逆ジオコーディング | SearchPlaces / GetDirections |
| メディア | 文字起こし・動画字幕 | TranscribeAudio / GetYouTubeTranscript |
| その他 | X(旧Twitter)検索・Amazon 検索など | XSearch / SearchAmazon |

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

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

一部のツールは Piece の `allowed_tools` に関係なく常に利用できます。

- `ReadToolDoc` — 任意のツールの詳細ドキュメント (手順・引数・gotcha) を取得する。例: `ReadToolDoc({ name: "BrowseWeb" })`
- `ReadSkill` — Skill の本文を取得する

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

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

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

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

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