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

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

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

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

Включить Trace

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

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

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

Просмотр полного пути

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

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

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

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

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

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

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

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

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

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

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

\