Урок из полного доступа, первые уроки курса бесплатно Официальный курс Mistral AI Cookbook на русском
Урок 39 · Текст · ~5 мин

Коннекторы в Chat Completions

Урок 39 из 154 курса «Mistral AI Cookbook»: официальный курс Mistral AI Cookbook (Мистраль) на русском языке. Урок входит в платный доступ; первые уроки курса бесплатно.

О чём урок

Используйте коннекторы, встроенные инструменты и агенты с Chat Completions API (/v1/chat/completions) и Agent Completions API (/v1/agents/completions).

Поддержка SDK: SDK mistralai поддерживает инструменты в стиле коннекторов в chat.complete(). Обратите внимание, что при вызове инструментов ответы используют messages (массив) вместо message (объект).

Для выполнения этого руководства вам понадобится API key Mistral. В Studio перейдите в раздел API keys и создайте новый API key.

Создайте файл .env в корне вашего проекта и добавьте ваш API key Mistral:

Большинство рецептов предполагают:

  • Действительный MISTRAL_API_KEY
  • Существующий коннектор для рецептов с кастомными коннекторами — см. Создание агента-советника по базам данных для примера полного жизненного цикла коннектора, или создайте его в Studio

Mistral предлагает два API для взаимодействия с моделями:

Используйте Chat Completions, когда:

  • Вы мигрируете с OpenAI и хотите знакомый формат ответа
  • Ваш существующий код использует структуру choices[].message
  • Вам нужна совместимость с SDK в стиле OpenAI

Используйте Conversations, когда:

  • Вы создаете новые интеграции с нуля
  • Вы хотите использовать рекомендуемый, новейший API
  • Вы используете бета-функции SDK

Chat completions с инструментами возвращают ответы в формате multi_completion, где каждый choice содержит массив messages вместо одного message. Вспомогательная функция ниже обрабатывает оба формата.

Python (SDK):

TypeScript:

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

Цель: Отправьте ваш первый запрос chat completion — без инструментов, без коннекторов.

Когда использовать:

  • Проверка работоспособности вашей настройки SDK от начала до конца
  • Ознакомление со структурой ответа перед добавлением коннекторов

Python:

TypeScript:

curl:

Пример вывода:

Как это работает:

  • /v1/chat/completions — это стандартный chat endpoint, совместимый с OpenAI
  • Ответ содержит choices[], где каждый choice имеет объект message
  • Для базового completion не требуются инструменты или коннекторы

Распространенные ошибки и их исправления:

Цель: Используйте встроенный инструмент image_generation в chat completion.

Когда использовать:

  • Генерация изображений на основе пользовательских prompt'ов
  • Быстрая интеграция без кастомных коннекторов

План урока

  1. Предварительные требования
  2. Установка
  3. Необходимые переменные окружения
  4. Что вам понадобится перед началом
  5. Conversations vs Completions — Когда что использовать
  6. Чтение ответов Completion
  7. Рецепты
  8. 1. Hello World — Базовый Chat Completion

Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.

Откройте полный доступ

Вы прошли бесплатные уроки. Выберите тариф, чтобы продолжить обучение.

Курсы Mistral AI 1 490 ₽ Разовый платёж, навсегда
  • Все курсы от Mistral AI (1 шт.)
  • Именной сертификат по каждому пройденному курсу
Оплатить
Полный доступ 4 900 ₽ Разовый платёж, навсегда
  • Все 77 курсов от 11 AI-провайдеров
  • Библиотека промптов и новые курсы
Оплатить

Безопасная оплата через Robokassa: СБП, карты, электронные кошельки. Доступ откроется в этом браузере и придёт письмом. Уже оплатили? Восстановить доступ

Полезные гиды