О чём урок
Автор: Сергей Дыбский (@sergical), Sentry.
Запустите помощника поддержки на TypeScript, который ищет вымышленные заказы и отвечает на уточняющие вопросы. Sentry автоматически отслеживает вызовы Mistral SDK, включая запросы инструментов, потоковые ответы и использование токенов. Дополнительные спаны приложения показывают продолжительность локального поиска и связывают преднамеренный сбой инструмента с его трассировкой.
Скриншоты показывают вымышленные заказы и нативный Mistral SDK, протестированный через OpenRouter, что объясняет идентификатор модели. Приведенная ниже настройка использует Mistral напрямую.
Вам потребуется Node.js 24.12 или более поздней версии, pnpm, ключ API Mistral с доступом к модели, поддерживающей вызов инструментов, и проект Sentry с его DSN.
Клонируйте примеры трассировки агентов Sentry. В примере @sentry/node привязан к 11.0.0-rc.0, а @mistralai/mistralai — к 2.7.0. Этот релиз-кандидат Sentry включает нативную интеграцию Mistral.
Установите SENTRY_DSN и MISTRAL_API_KEY в .env. В примере используется mistral-small-latest; установите MISTRAL_MODEL, чтобы использовать другую модель, поддерживающую вызов инструментов. Не включайте .env в систему контроля версий.
Откройте instrument.ts в примере проекта. Нативная интеграция Mistral в Sentry включена по умолчанию, когда трассировка включена. Она автоматически трассирует chat.complete и chat.stream. Записывайте входные и выходные данные модели для вымышленных данных и сэмплируйте каждый вызов, пока вы проверяете настройку. Захват тела HTTP и локальных переменных остается выключенным; содержимое модели поступает из интеграции AI.
instrument.ts
Трассировка агентов в Node.js.
Откройте orders.ts. Он определяет инструмент, доступный Mistral, и поиск, который выполняется в вашем приложении. Две записи в памяти заменяют службу заказов с имитированной задержкой в 250 мс. Это обычный код приложения. Интеграция записывает запрос инструмента модели и результат, переданный обратно Mistral; измерение локальной функции является необязательным дополнением позже.
orders.ts
Откройте assistant.ts. Mistral выбирает идентификатор заказа, ваше приложение выполняет поиск, и второй вызов модели передает ответ. Нативная интеграция автоматически трассирует оба вызова SDK.
assistant.ts
Вызов инструментов Mistral.
Выполните эти…
План урока
- Перед началом работы
- 1. Настройка Sentry
- 2. Обзор инструмента поиска заказов
- 3. Следуйте рабочему процессу агента
- 4. Начните разговор со службой поддержки
- Приложение
- Запуск
- 5. Прочитайте разговор со службой поддержки
Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.