Skip to Content
MakuraConsole
Разработка

Вызов инструментов

Инструменты позволяют модели запросить выполнение функции, определённой приложением. Модель не выполняет внешнее действие сама: сервер валидирует аргументы, выполняет разрешённую операцию и возвращает результат модели.

Типовой цикл

  1. Передайте описания инструментов и JSON Schema аргументов.
  2. Получите вызов инструмента от модели.
  3. Проверьте имя, аргументы, авторизацию и лимиты.
  4. Выполните функцию с таймаутом и идемпотентностью.
  5. Передайте результат следующему запросу.
  6. Повторяйте до финального ответа, ограничивая число шагов.

Безопасность

  • Считайте аргументы модели недоверенным вводом.
  • Используйте список разрешённых функций и строгие схемы.
  • Не передавайте модели сервисные токены и секреты.
  • Требуйте подтверждение для необратимых действий.
  • Ограничивайте время, размер ответа и количество вызовов.

Выбор API

Для новых интеграций используйте Responses API. Chat Completions и Messages подходят для совместимости с существующими клиентами.