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

Коннекторы в Conversations API

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

О чём урок

Используйте Connectors, встроенные инструменты и Agents в Conversations Mistral AI.

Статус API: Conversations используют client.beta.conversations. Agents используют client.beta.agents. Это бета-endpoints и могут быть изменены.

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

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

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

  • Рабочий client (см. Рецепт 1)
  • Существующий Connector для рецептов с custom-connector — см. Создание Database Advisor Agent для полного примера жизненного цикла Connector, или создайте его в Studio

Каждый рецепт в этом руководстве использует небольшой вспомогательный метод display_response для вывода текстового output модели. Conversations API возвращает список outputs; каждый output с type == "message.output" содержит ответ модели. Content может быть простой строкой или списком фрагментов content.

Python:

TypeScript:

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

Цель: Отправить ваше первое сообщение и прочитать ответ — без инструментов, без Connectors.

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

  • Проверка работоспособности вашей настройки end-to-end.
  • Ознакомление со структурой ответа перед добавлением Connectors.

Python:

TypeScript:

curl:

Пример output:

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

  • conversations.start / start_async отправляет stateless turn conversation модели.
  • Ответ содержит список outputs. Каждый из них с type == "message.output" содержит ответ модели.
  • Для базовой conversation не требуются инструменты или Connectors.

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

Цель: Предоставить модели доступ к информации из интернета в реальном времени — custom connector не требуется.

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

  • Вопрос пользователя требует актуальной информации (погода, новости, текущие события).
  • Быстрая интеграция без создания или управления Connectors.

Python:

TypeScript:

curl:

Пример output:

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

  • web_search — это встроенный tool type — создание Connector не требуется.
  • Модель автономно решает, вызывать ли поиск на основе запроса.
  • Результаты поиска автоматически включаются в ответ модели.

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

План урока

  1. Предварительные требования
  2. Установка
  3. Необходимые переменные среды
  4. Что нужно перед началом
  5. Чтение ответов Conversation
  6. Рецепты
  7. 1. Hello world — первая conversation
  8. 2. Conversation с веб-поиском

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

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

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

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

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

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