Инструкция по использованию цепочки вызовов

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

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

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

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

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

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

Описание сценариев

Просмотр полной цепочки

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

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

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

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

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

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

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

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

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

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

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

\