> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/russian/advanced-basic/trace.md).

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

## описании функций

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

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

<figure><img src="/files/b9f4a780658c8931df73c9ea2ccf6ea5aabfdfb3" alt=""><figcaption><p>Общий эффект цепочки вызовов</p></figcaption></figure>

## Включить Trace

Trace по умолчанию скрыт, сначала нужно включить режим разработчика:

1. Открыть `Настройки → Общие настройки`
2. Найдите **Режим разработчика**
3. Включить **Включить режим разработчика**

<figure><img src="/files/ed8d79b41f62c0e1730752ab272080933b51b152" alt=""><figcaption><p>Включите режим разработчика в общих настройках</p></figcaption></figure>

{% hint style="info" %}
После включения ранее созданные беседы не получат Trace задним числом; цепочка вызовов будет записываться только для последующих новых вопросов и ответов.
{% endhint %}

Данные Trace хранятся в локальном каталоге данных приложения. Обычно ими не нужно управлять вручную; если требуется полностью очистить их, перейдите в `Настройки → Настройки данных → Каталог данных`и используйте **Очистить кэш**или, открыв каталог данных, удалите связанные с trace кэши.

Типичный каталог данных:

* **macOS**：`~/Library/Application Support/CherryStudio`
* **Windows**：`%APPDATA%\CherryStudio`
* **Linux**：`~/.config/CherryStudio`

<figure><img src="/files/044e4b2c4fcb3bc2af1f1209c6f4db1385b11a89" alt=""><figcaption><p>Раздел для каталога данных и очистки кэша</p></figcaption></figure>

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

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

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

<figure><img src="/files/16395887304574c96f2df200bd7879037ad16a9b" alt=""><figcaption><p>Вход в цепочку вызовов рядом с сообщением диалога</p></figcaption></figure>

<figure><img src="/files/4a5411928dd51d56ff124928a64387a35f56e202" alt=""><figcaption><p>Древовидный вид цепочки вызовов</p></figcaption></figure>

### Просмотр вызова модели

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

<figure><img src="/files/05fd694079e5a4e094a2d7379fcc3f7d3d64f2fa" alt=""><figcaption><p>Выбрать узел вызова модели</p></figcaption></figure>

<figure><img src="/files/d99f84fd55248efc23c7a10c396db599a2f5e865" alt=""><figcaption><p>Входные данные вызова модели</p></figcaption></figure>

<figure><img src="/files/7a87e2f4301d6a1e93a086551dd566903c8d294a" alt=""><figcaption><p>Выходные данные вызова модели</p></figcaption></figure>

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

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

<figure><img src="/files/9110f46f0dd7bf401f4a094bfa413aaabe3235cb" alt=""><figcaption><p>Выбрать узел веб-поиска</p></figcaption></figure>

<figure><img src="/files/40bb177939788b7d035ed7b56e80cc657db7d7af" alt=""><figcaption><p>Входные данные веб-поиска</p></figcaption></figure>

<figure><img src="/files/aec2399457a640ff1591b8453242653e551c32c5" alt=""><figcaption><p>Результаты, возвращённые веб-поиском</p></figcaption></figure>

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

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

<figure><img src="/files/c7bba0c6b60cd8efc3c28a5239e2c9c2eedf7f4d" alt=""><figcaption><p>Детали узла базы знаний</p></figcaption></figure>

### Просмотр вызова MCP

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

<figure><img src="/files/79ddf42b5b340372257753fe1dd05abbbdea1dac" alt=""><figcaption><p>Подробности вызова MCP</p></figcaption></figure>

<figure><img src="/files/58c05eddfd14dd49e088b5935814c99336562ff9" alt=""><figcaption><p>Результат, возвращённый MCP</p></figcaption></figure>

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

Если данные цепочки вызовов отображаются некорректно или вы хотите расширить возможности наблюдаемости, обратитесь к [Обратная связь и предложения](/docs/russian/question-contact/suggestions.md) официальным каналам, указанным там. При отправке отзыва рекомендуется приложить скриншот Trace, используемую модель, информацию о том, включены ли база знаний / MCP / веб-поиск, а также текст вопроса, который позволяет воспроизвести проблему.

***

### 💡 Получить помощь и отправить отзыв

Если вы в процессе настройки или использования столкнётесь с любыми вопросами, багами или предложениями по улучшению функций, пожалуйста, обратитесь к [Обратная связь и предложения](/docs/russian/question-contact/suggestions.md) официальным каналам, указанным там.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/russian/advanced-basic/trace.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.