Выжимка из книги Ли Боцзе «Глубокое понимание AI Agent: принципы проектирования и инженерная практика» (Pine AI, v2.0, 2026).

4. Инструменты

5 категорий, разные по риску: - восприятие (read) - выполнение (exec) - сотрудничество - срабатывание события (hook) - коммуникация с пользователем (question).

По умолчанию — универсальный инструмент (LLM пишет код/скрипты), специализированный — только при: - безопасность/права/аудит, - сложные параметры, - очень высокая частота, - различия платформ. Skill vs инструмент — по тем же факторам + частоте изменений + силе модели.

Объединяй похожие функции параметром. Описание = «когда использовать» + явные границы — большинство ошибок от незнания ограничений, не возможностей. 1-5 примеров вызова поднимают точность сильнее JSON Schema. Чинить описание обычно эффективнее смены модели.

Никогда не делай тихую нормализацию параметров — создаёт недиагностируемое расхождение модель/реальность. Код как оркестратор нескольких вызовов — экономит на порядки токенов vs прогон через контекст.

MCP/Skill Hub: description — недоверенный ввод (отравление описания), фикс версий серверов, минимальные credentials, риск tool shadowing.

100 инструментов — иерархия по источнику + семантический предотбор (49%→74%). Агент декларирует потребность на естественном языке, подгрузка динамически; схема дописывается в конец контекста. Skills — самый лёгкий путь к прогрессивному раскрытию.

Восприятие: контекстное сжатие вывода на уровне инструмента; поиск — структурированный список с пагинацией; чтение — offset/limit с явным усечением; read-only — кэшируй и параллель без опаски; мультимодальность — текст (дёшево) vs нативное изображение (важна разметка/пространство).

Выполнение (высокая цена ошибки): валидация без умной коррекции → контроль доступа с семантическим разбором команд → проверка необратимых (Proposer-Reviewer разных семейств или смена модальности). Sidecar — лёгкая модель видит ТОЛЬКО структурные поля (риск инъекции через текст). Автопроверка сразу (linter после записи). Изоляция: процесс < контейнер < microVM. Идемпотентность для повторяемых операций. Наблюдаемость: логи, аудит, метрики.

Сотрудничество: маркируй источники в промпте суб-агента ([FROM_MAIN]/[FROM_USER]/[TOOL_RESULT]); стандартизируй формат вывода; примитивы spawn/cancel/send_message/list_agents; HITL — таймаут + консервативный дефолт, решения человека обобщай по случаям, не сразу в правило.

Продолжение следует...