О чём урок
Используйте 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 не требуется.
- Модель автономно решает, вызывать ли поиск на основе запроса.
- Результаты поиска автоматически включаются в ответ модели.
Распространенные ошибки и их исправления:
План урока
- Предварительные требования
- Установка
- Необходимые переменные среды
- Что нужно перед началом
- Чтение ответов Conversation
- Рецепты
- 1. Hello world — первая conversation
- 2. Conversation с веб-поиском
Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.