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

Вызов инструментов позволяет модели формировать структурированные аргументы функций. Приложение должно проверить аргументы, авторизовать и выполнить операцию, а затем вернуть результат. Сама модель никогда не выполняет функцию.

Выбор протокола

СценарийПротокол
Широкая совместимость с SDK и клиентамиChat Completions
Новые агентные сценарии OpenAIResponses API
Инструменты, работающие напрямую с ClaudeAnthropic Messages
Вызов функций в формате GeminiAPI, совместимый с Gemini

В Chat Completions функции объявляются в tools[].function. В Responses поля name, description и parameters размещаются непосредственно в инструменте с type: "function". Не переносите тела запросов из одного протокола в другой.

Контрольный список безопасного выполнения

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

Успешный ответ на текстовый запрос не доказывает, что вызов инструментов работает. Перед использованием в рабочей среде проверьте конкретное сочетание модели, протокола и клиента.

См. руководства по Chat Completions и Responses, а также справочник API.