Панель трассировки в Agentforce Builder

Доступно в версиях: Lightning Experience

Доступно в версиях: Enterprise Edition, Performance Edition, Unlimited Edition и Developer Edition. Требуемые дополнительные лицензии определяются типом агента.

После отправки тестового сообщения сводка взаимодействия отображает каждое событие в процессе принятия решения агентом в виде визуальной временной шкалы. В зависимости от тестового сценария, события включают:

Событие	Описание
Ввод: [сообщение]	Сообщение, начавшее этот поворот
Причина: [имя агента]	Перевал рассуждений агента с изложением того, что он решил сделать дальше и почему
Действие: [метка функции]	Действие агента, запущенное агентом (flow, Apex и прочие)
Переход к субагенту: [Целевой агент]	Агент передал разговор субагенту в одном агенте
Переход к агенту: [имя разработчика]	Агент передал разговор отдельному связанному агенту
Оценка вывода: [категория]	Оценка ответа агента перед его возвратом пользователю
Оценка инструмента MCP: [имя агента]	Оценен инструмент MCP вызов агента

Выберите любое событие в сводке взаимодействия, чтобы открыть его подробное представление во вкладке трассировки. Вкладка «Трассировка» отображает разбивку каждой миллисекунды этого события с временными интервалами для каждой подоперации. Детализируйте отдельные периоды времени, чтобы увидеть их полные выходные данные и точные данные, полученные и возвращенные агентом на этом этапе.

Вложенная вкладка «Переменные» отображает состояние каждой переменной на каждом этапе принятия решения в сеансе. Каждое событие отображает значение до запуска и значение после завершения события. Например, логическое переворачивание с «Ложь» на «Истина» после прохождения проверки условия. Используйте вложенную вкладку «Переменные» для:

• Проверьте, достигли ли правильные данные действия агента или шаблона напоминания
• Убедитесь, что правильная переменная обновлена после завершения действия
• Определите, где в сеансе переменная получила неожиданное значение

Установите начальные значения или переопределите значения в переменных контекста перед началом тестирования, потом используйте переменные во время сеанса для отслеживания изменения этих значений.

На любом этапе «Причина» вкладка «Трассировка» отображает точное напоминание, отправленное в LLM. Используйте эту информацию для понимания:

• Какой контекст был у агента, когда он выбрал субагента или решил запустить действие агента
• Если напоминание содержало ожидаемые значения переменной и инструкции
• Почему рассуждения агента привели к неожиданному результату

Просматривая трассировку, задайте встроенному помощнику Agentforce вопросы о том, что вы видите. Например, «Объясните напоминание, созданное на этом этапе рассуждения» или «Как исправить агента для обработки этого обращения?»

Прежде чем применять предложенные исправления, просмотрите их внимательно. Предложения иногда ссылаются на действия или потоки агента, которые не существуют в вашей организации, поэтому проверьте их перед внесением изменений.

Ниже указаны некоторые наиболее распространенные проблемы отладки и способы их решения.

Событие	Решение
Действие агента не сработало	Откройте этап «Причины» непосредственно перед ожидаемым действием. Просмотрите созданное напоминание, чтобы узнать, есть ли у агента контекст, необходимый для вызова действия. Потом проверьте отображение FunctionStep (Действие) после этапа «Рассуждение». В противном случае, агент решил не инициировать действие на основе его доступного контекста.
Произошел неожиданный переход субагента	Найдите TransitionStep в сводке взаимодействия. Разверните шаг «Причина» перед ним, чтобы увидеть, какой контекст привел агента к переходу. Убедитесь, что конфигурация маршрутизатора агента соответствует выраженному в тестовом сообщении намерению.
Вывод не совпал с ожиданиями	Проверьте OutputEvaluationStep в конце последовательности. Потом выполните действия «Причины» и вложенную вкладку «Переменные», чтобы определить, где решение агента отличается от ожидаемого.