Руководство по использованию цепочек вызовов

Описание функции

Трассировка (также называемая «trace») предоставляет пользователю возможность видеть подробности диалога, помогая понять поведение модели, базы знаний, MCP, веб-поиска и других компонентов в процессе диалога. Это наблюдаемость, основанная на OpenTelemetry реализованная с помощью инструментов наблюдаемости, которые собирают, хранят и обрабатывают данные на стороне клиента для визуализации, предоставляя количественную основу для локализации проблем и оптимизации результатов.

Каждый диалог соответствует одной записи trace; одна trace состоит из множества span, каждый span соответствует одной логике обработки в Cherry Studio, например вызову сессии модели, вызову MCP, обращению к базе знаний, веб-поиску и т.д. Trace отображается в виде древовидной структуры, span являются узлами дерева; основные данные включают время выполнения и количество использованных токенов, а в деталях span можно просмотреть конкретные входные и выходные данные.

Включить трассировку

По умолчанию после установки Cherry Studio трассировка скрыта. Необходимо включить её в "Настройки" - "Общие настройки" - "Режим разработчика", как показано ниже:

При этом для предыдущих сессий записи trace не будут созданы — трассировка начнёт сохраняться только после появления новых вопросов и ответов. Созданные записи хранятся локально; чтобы полностью удалить трассировки, можно воспользоваться "Настройки" - "Настройки данных" - "Каталог данных" - "Очистить кэш", либо вручную удалить файлы в ~/.cherrystudio/trace, как показано ниже:

Сценарии использования

Просмотр полной трассировки

В окне диалога Cherry Studio нажмите на трассировку, чтобы просмотреть данные полной цепочки вызовов. Независимо от того, вызывалась ли в ходе диалога модель, веб-поиск, база знаний или MCP, вы сможете увидеть данные всех вызовов в окне трассировки.

Просмотр модели в цепочке

Чтобы просмотреть детали вызова модели в трассировке, нажмите на узел вызова модели и просмотрите его входные и выходные данные.

Просмотр веб-поиска в цепочке

Чтобы просмотреть детали вызова веб-поиска в трассировке, нажмите на узел вызова веб-поиска и просмотрите его входные и выходные данные. В деталях можно увидеть запрос, отправленный в веб-поиск, и возвращённые им результаты.

Просмотр базы знаний в цепочке

Чтобы просмотреть детали обращения к базе знаний в трассировке, нажмите на узел вызова базы знаний и просмотрите его входные и выходные данные. В деталях можно увидеть запрос к базе знаний и возвращённый ответ.

Просмотр вызовов MCP в цепочке

Чтобы просмотреть детали MCP в трассировке, нажмите на узел вызова MCP и просмотрите его входные и выходные данные. В деталях можно увидеть параметры вызова этого MCP Server tool и возвращаемое инструментом значение.

Вопросы и предложения

Текущую функцию предоставляет команда EDAS Alibaba Cloud; при возникновении вопросов или предложений присоединяйтесь к группе DingTalk (ID группы: 21958624) для подробного общения с разработчиками.

\