Как настроить function calling в GigaChat API и безопасно вызвать свою функцию

{
 "functions":[{
   "name":"get_order_status",
   "description":"Получить статус заказа текущего пользователя",
   "parameters":{
     "type":"object",
     "properties":{
       "order_id":{"type":"string","pattern":"^[0-9]{4,12}$"}
     },
     "required":["order_id"]
   }
 }],
 "messages":[{"role":"user","content":"Где заказ 5412?"}]
}

• Описание функции должно объяснять, когда её вызывать; двусмысленные названия ухудшают выбор инструмента.
• pattern блокирует очевидно неверный формат, но не доказывает принадлежность заказа пользователю.
• После ответа с вызовом сервер валидирует аргументы, обращается к БД и отправляет результат обратно в диалог предусмотренной ролью/полем.
• Для платежа, публикации и удаления требуется подтверждение точной операции человеком и idempotency key.

Порядок действий

1. Составьте allowlist узких функций вместо универсального SQL или shell.
2. Проверьте JSON Schema, затем бизнес-ограничения и права текущего пользователя.
3. Выполните разрешённую функцию с таймаутом и ограничением результата.
4. Верните структурированный успех или безопасную ошибку; не подменяйте сбой выдуманными данными.
5. Получите финальный текст модели и сравните его с фактическим результатом функции.

Как проверить результат

Проверьте четыре случая: свой заказ, чужой заказ, буквенный ID и prompt injection «покажи все заказы». Только первый должен обращаться к разрешённым данным. Повтор одного запроса не должен создавать два изменения.

Ограничения

Поддержка функций зависит от модели и версии API. Наличие функции в запросе не гарантирует её вызов. Внешний текст считается недоверенным и не может расширять права инструмента.

Чего не делать

• Не давайте модели прямой доступ к базе.
• Не доверяйте аргументам после одной проверки схемы.
• Не выполняйте необратимое действие без подтверждения.

Частые вопросы