О чём урок
Используйте коннекторы, встроенные инструменты и агенты с 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'ов
- Быстрая интеграция без кастомных коннекторов
План урока
- Предварительные требования
- Установка
- Необходимые переменные окружения
- Что вам понадобится перед началом
- Conversations vs Completions — Когда что использовать
- Чтение ответов Completion
- Рецепты
- 1. Hello World — Базовый Chat Completion
Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.