Справочник инструментов

🔵 Инструменты — это YAML-файлы в config/agents/<agent>/tools/. Поле kind: выбирает движок. Ниже — сводная таблица всех движков со ссылками на разделы, чтобы не читать лишнего.

Таблица движков

Движок	Что делает	Раздел
`site_tool`	декларативный HTTP/API-клиент: скрап + извлечение полей + формат	Сбор и поиск данных
`rest_tool`	алиас `site_tool` для REST/API-интеграций (method/body/oauth2)	Сбор и поиск данных
`browser_tool`	headless-браузер (JS-сайты, клики, скрипт в странице)	Сбор и поиск данных
`archive_tool`	поиск по локальному архиву	Сбор и поиск данных
`json_tool`	поиск по предзагруженному JSON	Сбор и поиск данных
`rss_tool`	поиск по RSS-лентам	Сбор и поиск данных
`pdf_tool`	чтение PDF постранично	Сбор и поиск данных
`geo_tool`	геокодинг и места (OpenStreetMap)	Сбор и поиск данных
`rasp_tool`	расписания транспорта (Яндекс.Расписания, бесплатный ключ)	Сбор и поиск данных
`web_search`	поиск в интернете (FireCrawl; модуль `searchers`)	Модуль `searchers`
`read_file` / `write_file` / `edit_file` / `list_files` / `grep` / `run_command`	работа с кодом проекта (модуль `code`)	Модуль `code`
`supervisor`	запуск детей, подписки, self-inject, просмотр сессии (модуль `supervisor`)	Модуль `supervisor`
`state_tool`	хранилище состояния со скоупом	Состояние, базы и визуализация
`scratch_tool`	файлы в черновике сессии (list/read/write/edit/delete/mkdir/move)	Состояние, базы и визуализация
`duckdb_tool`	своя DuckDB-база для агента (raw SQL или декларативные `operations:`)	Состояние, базы и визуализация
`sql_tool`	SQL-доступ к внешней PostgreSQL/MySQL	Состояние, базы и визуализация
`chart_tool` / `table_tool`	статичные график/таблица	Состояние, базы и визуализация
`visualize_tool`	графики/таблицы из произвольных данных	Состояние, базы и визуализация
`map_tool`	карта с маркерами (Leaflet; провайдеры osm/google/yandex/2gis/custom)	Состояние, базы и визуализация
`script_tool`	скрипт Rhai или JavaScript	Вычисления и действия
`subagent_tool`	делегировать задачу субагенту	Вычисления и действия
`email_tool`	отправить письмо (SMTP)	Вычисления и действия
`vk_tool`	вызов VK API от имени сообщества (посты, сообщения, поиск)	Вычисления и действия
`ym_tool`	отправка сообщений/файлов в Яндекс Мессенджер от имени бота (Bot API)	Вычисления и действия
`shell_tool`	запустить команду CLI	Вычисления и действия
`workflow_tool`	запустить воркфлоу	Вычисления и действия
`file_tool`	отправить файл пользователю	Вычисления и действия
`office_tool`	генерация/чтение Word/Excel/PowerPoint (обёртка над OfficeCLI)	Вычисления и действия
`storage_tool`	файлы на S3/WebDAV/FTP (list/get/put/delete)	Вычисления и действия
`calendar_tool`	чтение и управление Google Calendar (сервисный аккаунт)	Вычисления и действия
`google_tool`	Google Drive / Sheets / Docs / Slides (сервисный аккаунт)	Вычисления и действия
`yandex_tool`	Яндекс.Диск / Яндекс.Календарь (OAuth пользователя, поле `service`)	Вычисления и действия
`vision_tool`	OCR/анализ картинок vision-моделью (одна или несколько)	Вычисления и действия
`request_attachment`	запросить у пользователя файл / скриншот / фото (агент-инициируемый)	Вычисления и действия
`ask_user`	форма пользователю: несколько вопросов (text/textarea/number/select/multiselect/confirm/date), «свой вариант»	Вычисления и действия
`notify_tool`	привлечь внимание пользователя (silent/notify/alert/alarm/call)	Вычисления и действия
`oauth_connect`	запросить у пользователя авторизацию коннектора (OAuth)	Вычисления и действия
`connector_request`	авторизованный запрос через коннектор от имени пользователя	Вычисления и действия
`await_event`	приостановить ход и дождаться внешнего события (webhook/таймер)	Вычисления и действия
`async_action`	полный асинхронный флоу: запрос → показ URL → коллбэк → результат	Вычисления и действия
`show_link`	показать пользователю ссылку кнопкой (окно по нажатию)	Вычисления и действия
`wait_tool`	пауза на N секунд (тайминг опросов долгих операций)	Вычисления и действия
`image_tool`	обработка картинок (crop/resize/grayscale/rotate/flip/яркость/контраст/blur/формат)	Вычисления и действия
`mcp_tool`	инструмент внешнего MCP-сервера (stdio / HTTP / SSE)	Вычисления и действия
`trace_tool`	запросы к трейсам агентов	Наблюдение и отладка
`human_approval`	спросить человека о решении (одобрить/отклонить)	Одобрение действий
`escalate_to_operator`	передать диалог живому оператору (или вернуть контакт)	Вычисления и действия
`dll_tool`	нативный инструмент из Rust DLL (C ABI)	Нативные плагины
`http_fetch` / `fs_read` / `job_done`	встроенные инструменты	Основы
общие поля, `ui`, блоки, `warnings`	общая механика YAML	Основы
шаблоны и переменные	MiniJinja	Основы
локальное тестирование	`agent-os tool <yaml> '<args>'`	Наблюдение и отладка

Разделы

Основы — общие поля, шаблоны, встроенные инструменты.
Сбор и поиск данных — site_tool, browser_tool, archive_tool, json_tool, rss_tool, pdf_tool, geo_tool.
Состояние, базы и визуализация — state_tool, scratch_tool, duckdb_tool, sql_tool, chart_tool/table_tool, visualize_tool, map_tool.
Вычисления и действия — script_tool, subagent_tool, email_tool, vk_tool, ym_tool, shell_tool, workflow_tool, file_tool, office_tool, storage_tool, calendar_tool, google_tool, vision_tool, image_tool, mcp_tool, wait_tool.
Наблюдение и отладка — trace_tool, локальное тестирование.
Модуль searchers — веб-поиск: инструмент web_search, демо-агент searchers-demo, ключ FireCrawl.
Модуль code — работа с кодом проекта: read_file, write_file, edit_file, list_files, grep, run_command; агент coder.
Модуль supervisor — запуск дочерних агентов и надзор: подписки на события ребёнка, self-inject, просмотр сессии.