Инструкция по вызовам

Функциональные возможности

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

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

Включение Trace

По умолчанию после установки Cherry Studio функция Trace скрыта. Для её активации перейдите в "Настройки" → "Общие настройки" → "Режим разработчика", как показано на изображении:

Trace не записывается для предыдущих сессий — записи создаются только для новых вопросов. Данные хранятся локально. Для полной очистки Trace:

  1. Перейдите в "Настройки" → "Настройки данных" → "Каталог данных" → "Очистить кеш"

  2. Или вручную удалите файлы в каталоге ~/.cherrystudio/trace

Примеры использования

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

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

Анализ моделей в цепочке

Для просмотра деталей вызова модели нажмите на соответствующий узел, чтобы изучить входные и выходные данные.

Мониторинг веб-поиска

Нажмите на узел веб-поиска для просмотра отправленного запроса и полученных результатов.

Просмотр обращений к базе знаний

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

Отслеживание вызовов MCP

Для анализа работы MCP нажмите на соответствующий узел и проверьте входные параметры и возвращаемые значения инструмента.

Проблемы и предложения

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

\

最后更新于

这有帮助吗?