Обзор
Трассировка даёт полную видимость того, что произошло во время тестового или реального звонка. Это одна из самых мощных функций для подготовки голосовых агентов к продакшену. С трассировками вы можете увидеть:- Точный разговор, который произошёл
- Какие промпты отправлялись в LLM
- К каким инструментам у LLM был доступ (и какие она вызывала)
- Транскрипции STT (распознавания речи) ввода пользователя и ошибки транскрибирования
- Запросы и ответы вызовов инструментов
Доступ к трассировкам
После завершения звонка вы увидите экран сводки звонка. Нажмите на вкладку Трассировки (Traces), чтобы посмотреть подробный лог трассировки для этого звонка.Разделы трассировки
Трассировки организованы по типу события. Два самых важных раздела, на которые стоит обратить внимание:STT (распознавание речи)
Эти записи фиксируют транскрипцию того, что сказал пользователь во время звонка. Каждая запись STT показывает текстовое преобразование речи пользователя в этот момент разговора. Пример: STT: “Да, я хотел бы узнать, какие у вас часы работы.”LLM (вызовы языковой модели)
Эти записи показывают каждый вызов LLM. Каждая трассировка LLM включает:- Промпт — полный промпт, отправленный в LLM (комбинация глобального промпта и промпта конкретного узла)
- История разговора — весь разговор до этого момента
- Доступные инструменты — все инструменты, доступные LLM для этого узла
- Ответ — что сгенерировала LLM
Инструменты в трассировках
Каждый вызов LLM показывает инструменты, доступные агенту в этот момент. Они делятся на три категории:Системные инструменты (по умолчанию)
Каждый узел по умолчанию включает следующие:- Safe Calculator — помогает LLM точно выполнять математические вычисления
- Get Current Time — получает текущее время
- Convert Time — конвертирует время в указанный часовой пояс
Инструменты переходов (pathway)
Они соответствуют переходам (pathway) между узлами, которые вы настроили. Например, если у вашего узла есть переходы к “End Call” и “Move to Summary”, вы увидите их как доступные инструменты. Описания инструментов, показанные в трассировках, совпадают с описаниями, заданными в конфигурации переходов.Пользовательские инструменты
Здесь появятся любые внешние инструменты, прикреплённые к узлу (например, любые созданные вами пользовательские инструменты для API-эндпоинтов бронирования, оформления заказа и т.д.). См. документацию по пользовательским инструментам.Вызовы инструментов в трассировках
Когда LLM решает вызвать инструмент, вы увидите:- Запрос вызова инструмента — имя инструмента и отправленные параметры
- Ответ инструмента — возвращённый результат (например,
{"status": "ok"})
{"status": "done", "confirmation": "Table booked"}
Агент: “Я забронировал вам столик на завтра на 7 вечера.”
Как комбинируются промпты
Промпт, отправляемый в LLM, — это комбинация:- Глобальный промпт — задан в настройках вашего глобального узла (Global Node)
- Промпт узла — задан в конкретном выполняемом узле
Ключевая концепция: история разговора
Каждый раз при вызове LLM ей передаётся вся история разговора до этого момента. Это означает:- У LLM всегда есть полный контекст
- Вы можете точно видеть, какой контекст был у LLM при принятии решения
- Это полезно для отладки неожиданных ответов
Настройка трассировки Langfuse
Мы предоставляем бесшовную интеграцию с Langfuse для трассировки, если вы хотите использовать собственный аккаунт. Это позволяет использовать функцию Playground в Langfuse. Это работает как в управляемых, так и в локальных (self-hosted) развёртываниях Агентики. Шаги настройки:- Зарегистрируйтесь на Langfuse и создайте API-учётные данные
- В интерфейсе Агентики перейдите в Настройки платформы (
/settings) и укажите ваш Langfuse host, public key и secret key - Нажмите Сохранить
Для локальных (self-hosted) развёртываний вы также можете настроить Langfuse через переменные окружения (
LANGFUSE_SECRET_KEY, LANGFUSE_PUBLIC_KEY, LANGFUSE_HOST) как значение по умолчанию для всех организаций. Трассировка активируется автоматически, как только учётные данные становятся доступны — отдельный флаг включения не требуется. Учётные данные, заданные для организации в интерфейсе, имеют приоритет над переменными окружения.Краткая справка
Советы по использованию трассировок
- Отладка неожиданных ответов — проверьте трассировку LLM, чтобы увидеть, какой промпт и контекст получила модель
- Проверка вызовов инструментов — убедитесь, что инструменты вызываются с корректными параметрами
- Улучшение промптов — используйте трассировки, чтобы увидеть, как инструкции промпта влияют на поведение LLM
- Проверка точности транскрибирования — просматривайте записи STT, если агент неправильно понимает пользователей