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