Вызов инструментов
Инструменты позволяют модели запросить выполнение функции, определённой приложением. Модель не выполняет внешнее действие сама: сервер валидирует аргументы, выполняет разрешённую операцию и возвращает результат модели.
Типовой цикл
- Передайте описания инструментов и JSON Schema аргументов.
- Получите вызов инструмента от модели.
- Проверьте имя, аргументы, авторизацию и лимиты.
- Выполните функцию с таймаутом и идемпотентностью.
- Передайте результат следующему запросу.
- Повторяйте до финального ответа, ограничивая число шагов.
Безопасность
- Считайте аргументы модели недоверенным вводом.
- Используйте список разрешённых функций и строгие схемы.
- Не передавайте модели сервисные токены и секреты.
- Требуйте подтверждение для необратимых действий.
- Ограничивайте время, размер ответа и количество вызовов.
Выбор API
Для новых интеграций используйте Responses API. Chat Completions и Messages подходят для совместимости с существующими клиентами.