Загружаем паттерны…
Использование инструментов
Паттерны интеграции внешних инструментов и вызова функций
За 30 секунд
- Что это
- Подключает системы ИИ к внешним инструментам, API, базам данных и сервисам, чтобы агенты могли выполнять действия за пределами генерации текста: вычисления, извлечение данных, операции с файлами и взаимодействие с системами.
- Когда применять
- Задачи, которым нужны актуальные данные, отсутствующие в обучении, точные вычисления за пределами текста, взаимодействие с API или базами данных либо операции с файлами и системой.
- Осторожно
- Недостаточная обработка ошибок при отказе или недоступности инструментов может каскадом привести к сбоям системы и сломанным рабочим процессам.
Спросить ИИ-эксперта об этих паттернах
Откроет ассистента с готовым вопросом. Вы проверите его перед отправкой.
Обзор
Паттерны использования инструментов позволяют ИИ-системам расширять свои возможности за счёт интеграции с внешними инструментами, API, базами данных и сервисами. Они дают ИИ-агентам возможность выполнять действия, выходящие за рамки генерации текста: производить вычисления, обращаться к данным в реальном времени, выполнять код, работать с файлами или взаимодействовать с внешними системами, что значительно расширяет круг задач, которые они способны решать автономно.
Практические применения и сценарии
Анализ данных
интеграция с аналитическими инструментами и базами данных для выполнения сложной обработки и визуализации данных.
Выполнение кода
запуск и тестирование кода на различных языках программирования для проверки работоспособности и получения результатов.
Интеграция API
подключение к внешним сервисам для получения данных о погоде, финансовой информации или функций сторонних поставщиков.
Управление файлами
чтение, запись и обработка файлов и документов в различных форматах и системах хранения.
Математические вычисления
использование специализированных вычислительных инструментов для сложных математических операций и научных расчётов.
Веб-автоматизация
взаимодействие с веб-сервисами, сбор данных или автоматизация задач в браузере.
Системное администрирование
выполнение системных операций, мониторинг ресурсов и управление инфраструктурой.
Создание контента
применение специализированных инструментов для генерации изображений, монтажа видео или форматирования документов.
Почему это важно
Паттерны использования инструментов имеют основополагающее значение для создания практичных ИИ-агентов, способных взаимодействовать с реальными системами и выполнять конкретные действия. Они устраняют разрыв между способностями ИИ к рассуждению и практической пользой, позволяя агентам получать актуальную информацию, выполнять точные вычисления и решать задачи, требующие взаимодействия с внешними системами. Эта способность превращает ИИ из простого инструмента генерации текста в универсальную платформу автоматизации.
Руководство по внедрению
Когда использовать
- Задачи, требующие информации в реальном времени или актуальных данных, отсутствующих в обучающих данных
- Приложения, которым нужны точные вычисления или анализ данных, выходящие за рамки генерации текста
- Системы, которые должны взаимодействовать с внешними API или базами данных
- Рабочие процессы, требующие работы с файлами или системных операций
- Сценарии, в которых требуется проверка или выполнение сгенерированного кода
- Приложения, требующие интеграции с существующими бизнес-системами
Лучшие практики
- Проектировать надёжную обработку ошибок на случай сбоев инструментов и проблем с сетью
- Реализовать надлежащую аутентификацию и меры безопасности для доступа к инструментам
- Использовать уровни абстракции инструментов для упрощения интеграции и обслуживания
- Проверять входные данные инструментов и очищать выходные, чтобы предотвратить проблемы безопасности
- Внедрять ограничение частоты запросов и управление ресурсами при использовании инструментов
- Предоставлять понятную документацию и примеры для каждого доступного инструмента
- Отслеживать использование и производительность инструментов для поиска возможностей оптимизации
Распространённые ошибки
- Недостаточная обработка ошибок, приводящая к сбоям системы, когда инструменты недоступны
- Уязвимости безопасности из-за ненадлежащей проверки входных данных или чрезмерных разрешений
- Чрезмерная опора на инструменты в задачах, которые можно решить одними лишь возможностями ИИ
- Неудачный выбор инструментов, ведущий к неэффективному или неправильному выполнению задач
- Игнорирование влияния использования внешних инструментов на задержки и затраты
- Недостаточный мониторинг и журналирование взаимодействий с инструментами для отладки
Доступные техники
Вызов функций
Структурированный интерфейс, позволяющий ИИ вызывать внешние функции и API
Выполнение кода
Безопасно выполняет сгенерированный LLM код в изолированных средах для вычислений и обработки данных
Model Context Protocol(MCP)
Стандартизированный протокол для обмена контекстом и возможностями между ИИ-моделями и инструментами
Control Plane как инструмент(CPT)
Предоставляет агенту единый унифицированный интерфейс инструмента, тогда как внутренний control plane направляет каждый запрос к нужному инструменту, сервису или модели за ним. Промпт агента остаётся стабильным по мере развития каталога инструментов, а аутентификация, политики, ограничение частоты запросов и наблюдаемость обеспечиваются в одном месте.
Использование компьютера(CU)
Агенты работают с графическими интерфейсами (десктоп, браузер или мобильное устройство) так же, как это делает человек: считывают скриншоты и выполняют действия мышью и клавиатурой вместо вызова API. Основная сложность заключается в привязке к GUI (GUI grounding): сопоставление намерения с точными координатами пикселей на экране. Агент выполняет цикл из создания скриншота, рассуждения, действия и наблюдения, пока задача не будет завершена.
Навыки агента(AS)
Возможности, упакованные в виде самодостаточных папок. Каждый навык представляет собой файл SKILL.md с YAML-фронтматтером (имя и описание), а также с необязательными скриптами и ресурсами. Агенты обнаруживают навыки по их метаданным и загружают их через три уровня прогрессивного раскрытия: прочитать имя и описание, чтобы оценить релевантность, после активации загрузить полный файл SKILL.md, а затем по мере необходимости выполнять входящие в комплект скрипты и ресурсы. Это позволяет сохранять контекст небольшим, предоставляя при этом множество возможностей, а сам формат является открытым стандартом, принятым разными поставщиками.
Извлечение инструментов (Tool RAG)(TR)
Когда агенту доступны сотни или тысячи инструментов или MCP-серверов, загрузка каждой схемы в промпт обходится дорого и снижает точность выбора. Извлечение инструментов индексирует определения инструментов и для каждого запроса извлекает только семантически релевантные из них (поиск по эмбеддингам, активное обнаружение и переранжирование), прежде чем модель сделает выбор. RAG-MCP сообщает, что точность выбора инструментов возрастает примерно с 13 до 43 процентов при сокращении числа токенов промпта более чем вдвое.
Структурированный вывод(SO)
Гарантирует соответствие вывода модели схеме за счёт ограничения декодирования. JSON Schema, регулярное выражение или грамматика компилируются в конечный автомат, и на каждом шаге декодирования токены, которые нарушили бы схему, маскируются, так что можно сэмплировать только допустимые продолжения. В строгом режиме это делает невозможными некорректный JSON и недопустимые аргументы инструментов. Функция доступна нативно в OpenAI, Google и Anthropic, а также в открытых библиотеках, таких как Outlines и vLLM.
Код как действие (CodeAct)(CA)
Вместо того чтобы выдавать по одному JSON-вызову инструмента за ход, пространством действий агента становится исполняемый код, который оркестрирует инструменты с помощью циклов, условий и переменных. Один блок кода может вызывать множество инструментов, ветвиться в зависимости от результатов и хранить промежуточные данные в среде выполнения, а не передавать каждый результат обратно через контекстное окно. Anthropic сообщает о сокращении числа токенов примерно на 98 процентов в некоторых мультиинструментальных рабочих процессах, когда инструменты вызываются из кода через MCP.
Структурированная рефлексия (Think Tool)
Специальный «think»-инструмент без побочных эффектов (Anthropic), объявленный в схеме инструментов агента, который модель вызывает в середине траектории, чтобы добавить структурированное рассуждение между результатом инструмента и следующим действием. Вызов не имеет внешнего эффекта и не возвращает ничего полезного: он просто даёт модели контрольную точку, чтобы перечитать политику, проверить ограничения и спланировать действия, прежде чем действовать внутри длинной цепочки вызовов инструментов. Anthropic сообщает об относительном улучшении на 54 % по метрике pass^1 airline из tau-bench (0.570 против базового значения 0.370), когда инструмент сочетается с промптом, показывающим, как его использовать. Отличается от `metacognitive-monitoring`: та запись описывает общую способность отслеживать собственные рассуждения, тогда как think tool представляет собой конкретный механизм на уровне схемы инструментов для этого, отдельный от расширенного мышления или мышления во время инференса, происходящего до первого ответа.
MCP-шлюз (федерация и управление инструментами)(MCPG)
Единая управляемая точка входа MCP, которая как обратный прокси располагается перед множеством серверных MCP-серверов и федерирует их инструменты в единую курируемую, управляемую поверхность инструментов, к которой подключается агент. Каждый вызов инструмента проходит через шлюз, который обеспечивает централизованную аутентификацию, авторизацию на уровне отдельного инструмента, отделяющую личность вызывающей стороны от прав нижестоящего сервера, проверку политик, ограничение частоты запросов, ведение журнала аудита и телеметрию. Это превращает разросшуюся груду независимо развёрнутых серверов в единый контролируемый контракт интеграции, благодаря чему инструменты можно курировать, версионировать и отзывать, не затрагивая каждого агента. Отличается от `control-plane`: плоскость управления представляет собой общий паттерн предоставления единого интерфейса с внутренней маршрутизацией к любому инструменту, сервису или модели, тогда как MCP-шлюз представляет собой специфичную для экосистемы MCP реализацию, ориентированную на федерирование множества MCP-серверов и управление общей поверхностью доступа к инструментам.
Patterns Pack
Заберите весь каталог с собой: MCP-сервер, правила и навыки для редактора, и данные.
The Agent Architect
Один паттерн, один компромисс, одна история сбоя в продакшене. Короткий еженедельный брифинг для тех, кто строит агентные системы.
Одно письмо в неделю, отписка в один клик. Адрес используется только для рассылки брифинга.
От инженера, создавшего этот каталог
Проведите ревью архитектуры ваших агентов
На этой странице описан один паттерн. Ваша система использует десятки, и большинство сбоев возникает на стыках. Мы разберём весь дизайн по 288 паттернам каталога: архитектура, надёжность, оценка и стоимость, каждая находка связана с паттерном, который её устраняет.
€750 вместо €1 500, одна неделя, письменный отчёт и разбор в звонке, до 30 сентября