5. Справочник инструментов
🔵 Инструменты — это YAML-файлы в config/agents/<agent>/tools/. Поле kind:
выбирает движок. Ниже — сводная таблица всех движков со ссылками на разделы,
чтобы не читать лишнего.
Таблица движков
| Движок | Что делает | Раздел |
|---|---|---|
site_tool |
HTTP-скрап + извлечение полей + формат | Сбор и поиск данных |
browser_tool |
headless-браузер (JS-сайты, клики, скрипт в странице) | Сбор и поиск данных |
archive_tool |
поиск по локальному архиву | Сбор и поиск данных |
json_tool |
поиск по предзагруженному JSON | Сбор и поиск данных |
rss_tool |
поиск по RSS-лентам | Сбор и поиск данных |
pdf_tool |
чтение PDF постранично | Сбор и поиск данных |
geo_tool |
геокодинг и места (OpenStreetMap) | Сбор и поиск данных |
state_tool |
хранилище состояния со скоупом | Состояние, базы и визуализация |
duckdb_tool |
своя DuckDB-база для агента | Состояние, базы и визуализация |
sql_tool |
SQL-доступ к внешней PostgreSQL/MySQL | Состояние, базы и визуализация |
chart_tool / table_tool |
статичные график/таблица | Состояние, базы и визуализация |
visualize_tool |
графики/таблицы из произвольных данных | Состояние, базы и визуализация |
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) | Вычисления и действия |
trace_tool |
запросы к трейсам агентов | Наблюдение и отладка |
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. - Вычисления и действия —
script_tool,subagent_tool,email_tool,vk_tool,shell_tool,workflow_tool,file_tool,office_tool. - Наблюдение и отладка —
trace_tool, локальное тестирование.