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

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

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

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

<figure><img src="/files/b9f4a780658c8931df73c9ea2ccf6ea5aabfdfb3" alt=""><figcaption></figcaption></figure>

## Включить Trace

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

<figure><img src="/files/18e8836b85826094fabf7df62874d02c70c6d0cb" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/2995618b280b3b3ab6c097d00ef251a1dad98d9a" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="/files/5c24c095c6a0b25461811f62bd08c8fd2a0a33b4" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/7428b8f59b799fef5fd628e6cac62d2594ef9cb6" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/c5064b4519f7840f1a485d08b54e42cb7887cb45" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/9cc8b6f22a425cc515793b58721151dcaa0560bc" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/8bddabce845399f8122274f90d0d0244c5a82c8b" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/53085b102b547ed672a2e04591de54d833c01731" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/5aa12397e214c23cab95b1fe37d223e4fd77f49d" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/a29210908a39e54c9c601f044e8699f4adc2928b" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/dff0e468cbab3c84b214e93d38ec6a346c55183b" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/5bb927d23b68075791bf7bfe18b657364046052b" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/30e52a853a9f72018c966a4000d15b4b801071e7" alt=""><figcaption></figcaption></figure>

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

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

\\


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cherry-ai.com/docs/russian/advanced-basic/trace.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.