5. Справочник инструментов
🔵 Инструменты — это 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 |
расписания транспорта (Яндекс.Расписания, бесплатный ключ) | Сбор и поиск данных |
state_tool |
хранилище состояния со скоупом | Состояние, базы и визуализация |
duckdb_tool |
своя DuckDB-база для агента | Состояние, базы и визуализация |
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 от имени сообщества (посты, сообщения, поиск) | Вычисления и действия |
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 |
запросить у пользователя файл / скриншот / фото (агент-инициируемый) | Вычисления и действия |
oauth_connect |
запросить у пользователя авторизацию коннектора (OAuth) | Вычисления и действия |
connector_request |
авторизованный запрос через коннектор от имени пользователя | Вычисления и действия |
await_event |
приостановить ход и дождаться внешнего события (webhook/таймер) | Вычисления и действия |
async_action |
полный асинхронный флоу: запрос → показ URL → коллбэк → результат | Вычисления и действия |
show_link |
показать пользователю ссылку кнопкой (окно по нажатию) | Вычисления и действия |
image_tool |
обработка картинок (crop/resize/grayscale/rotate/flip/яркость/контраст/blur/формат) | Вычисления и действия |
mcp_tool |
инструмент внешнего MCP-сервера (stdio / HTTP / SSE) | Вычисления и действия |
trace_tool |
запросы к трейсам агентов | Наблюдение и отладка |
human_approval |
спросить человека о решении (одобрить/отклонить) | Одобрение действий |
http_fetch / fs_read / job_done |
встроенные инструменты | Основы |
общие поля, ui, блоки, warnings |
общая механика YAML | Основы |
| шаблоны и переменные | MiniJinja | Основы |
| локальное тестирование | site_tool <yaml> '<args>' |
Наблюдение и отладка |
Разделы
- Основы — общие поля, шаблоны, встроенные инструменты.
- Сбор и поиск данных —
site_tool,browser_tool,archive_tool,json_tool,rss_tool,pdf_tool,geo_tool. - Состояние, базы и визуализация —
state_tool,duckdb_tool,sql_tool,chart_tool/table_tool,visualize_tool,map_tool. - Вычисления и действия —
script_tool,subagent_tool,email_tool,vk_tool,shell_tool,workflow_tool,file_tool,office_tool,storage_tool,calendar_tool,google_tool,vision_tool,image_tool,mcp_tool. - Наблюдение и отладка —
trace_tool, локальное тестирование.