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

О чём урок

Используйте 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. Распространенные ошибки и их исправления: Ошибка Причина Исправление 401 Unauthorized Неверный API key Проверьте MISTRAL_API_KEY 422 Unprocessable Entity Неверное имя модели Используйте валидную модель, например mistral-small-latest Цель: Предоставить модели доступ к информации из интернета в реальном времени — 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 с веб-поиском