Гайд · TNWS AI

Как настроить function calling в Mistral API: tools, tool_calls и tool result

2 мин

Практическое руководство: рабочий пример, структура ответа, ограничения, негативные тесты и проверка результата для запроса «как настроить function calling Mistral».

Опишите функции в tools, получите tool_calls, выполните разрешённую операцию на сервере и добавьте результат в историю. Модель не должна получать универсальный SQL, shell или административный токен.

Рабочий пример

tools=[{"type":"function","function":{
 "name":"get_stock",
 "description":"Остаток товара по SKU",
 "parameters":{"type":"object","properties":{"sku":{"type":"string"}},"required":["sku"]}
}}]
# После ответа: parse tool_calls -> validate -> call backend
# Затем добавить tool result с соответствующим tool_call_id.

Что важно в реализации

  • Инструмент получает только минимальные полномочия.
  • Аргументы проверяются схемой и бизнес-правилами.
  • Call ID связывает результат с конкретным вызовом.
  • Ошибка сервиса возвращается явно, не маскируется нулевым остатком.

Пошаговая проверка

  1. Проверьте валидный SKU, чужой склад, пустую строку и injection.
  2. Вызов с недоступным складом не должен утечь в ответ.
  3. Повтор call ID должен быть безопасным.

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

  • Не публикуйте API-ключ и не передавайте его браузеру.
  • Не записывайте результат в базу без проверки структуры.
  • Не делайте бесконечные повторы после 401, 429 или 5xx.
  • Не называйте уверенный текст доказанным фактом.

Ограничения

Доступность моделей, контекст, лимиты и цена зависят от актуальной версии сервиса и аккаунта. Сначала запускайте небольшой тест на обезличенных данных. Для важных решений используйте первичный источник и независимую проверку.

FAQ

Можно ли использовать пример в production?

Только после добавления таймаутов, обработки ошибок, лимитов и защиты секретов.

Как выбрать модель?

Сверить текущий список моделей и возможности в официальной документации непосредственно перед внедрением.

Нужно ли проверять ответ модели?

Да: формат — валидатором, факты — источником или базой, вычисления — обычным кодом.

Почему нет фиксированной цены?

Цены меняются и зависят от модели; используйте актуальную официальную страницу тарификации.

Официальный источник

Проверено 12 сентября 2026 года: https://docs.mistral.ai/capabilities/function_calling/

Читайте также

Комментарии

Пока тихо. Скажите первое слово