Гайд · TNWS AI
Как настроить function calling в Mistral API: tools, tool_calls и tool result
Практическое руководство: рабочий пример, структура ответа, ограничения, негативные тесты и проверка результата для запроса «как настроить 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 связывает результат с конкретным вызовом.
- Ошибка сервиса возвращается явно, не маскируется нулевым остатком.
Пошаговая проверка
- Проверьте валидный SKU, чужой склад, пустую строку и injection.
- Вызов с недоступным складом не должен утечь в ответ.
- Повтор call ID должен быть безопасным.
Чего не делать
- Не публикуйте API-ключ и не передавайте его браузеру.
- Не записывайте результат в базу без проверки структуры.
- Не делайте бесконечные повторы после 401, 429 или 5xx.
- Не называйте уверенный текст доказанным фактом.
Ограничения
Доступность моделей, контекст, лимиты и цена зависят от актуальной версии сервиса и аккаунта. Сначала запускайте небольшой тест на обезличенных данных. Для важных решений используйте первичный источник и независимую проверку.
FAQ
Можно ли использовать пример в production?
Только после добавления таймаутов, обработки ошибок, лимитов и защиты секретов.
Как выбрать модель?
Сверить текущий список моделей и возможности в официальной документации непосредственно перед внедрением.
Нужно ли проверять ответ модели?
Да: формат — валидатором, факты — источником или базой, вычисления — обычным кодом.
Почему нет фиксированной цены?
Цены меняются и зависят от модели; используйте актуальную официальную страницу тарификации.
Официальный источник
Проверено 12 сентября 2026 года: https://docs.mistral.ai/capabilities/function_calling/
Читайте также
Как использовать embeddings Mistral для семантического поиска по документам
Практическое руководство: рабочий пример, структура ответа, ограничения, негативные тесты и проверка результата для запроса «как использовать embeddings Mistral».
Как отправить первый запрос в Mistral API через официальный Python SDK
Практическое руководство: рабочий пример, структура ответа, ограничения, негативные тесты и проверка результата для запроса «как подключить Mistral API».
Как получить Structured Output в Mistral API и валидировать Pydantic
Практическое руководство: рабочий пример, структура ответа, ограничения, негативные тесты и проверка результата для запроса «как получить JSON Mistral API».
Комментарии
Пока тихо. Скажите первое слово