> 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/developer-tools/trace.md).

# Цепочка вызовов и режим разработчика

Цепочка вызовов используется для просмотра запросов к модели, вызовов инструментов и взаимодействий MCP, происходящих внутри одного диалога или задачи Agent. Она подходит для поиска и устранения неполадок и анализа производительности, но не является функцией, которую нужно включать для повседневного общения.

<figure><img src="/files/694c35e0789a37c0e8789070b8cfb2a8f67deb2f" alt="从运行环境、认证网络到 Agent 绑定和调用链的 MCP 排错流程图"><figcaption><p>При отладке вызовов MCP сначала проверьте сервер и аутентификацию, затем с помощью цепочки вызовов определите, дошёл ли запрос до этапа Agent и выполнения инструмента.</p></figcaption></figure>

## Способ включения

{% stepper %}
{% step %}

### 1. Откройте 【Настройки】→【Система】

В разделе 【Режим разработчика】 включите 【Включить режим разработчика】.
{% endstep %}

{% step %}

### 2. Перезапустите Cherry Studio

Режим разработчика вступает в силу после перезапуска. Перед перезапуском следует проверить состояние задач Agent, которые уже выполняются.
{% endstep %}

{% step %}

### 3. Воспроизведите проблему один раз

Повторно отправьте минимальное тестовое сообщение, оставив только необходимые модель и инструменты, чтобы уменьшить число лишних вызовов.
{% endstep %}

{% step %}

### 4. Откройте цепочку вызовов

В правой панели диалога или Agent откройте 【Цепочка вызовов】, выберите узел и просмотрите входные данные, выходные данные, время выполнения и состояние. В задаче Agent также можно увидеть имя Agent, действие и количество вызовов инструментов.
{% endstep %}
{% endstepper %}

## Как читать распространённые узлы

| Узел              | На что проверять                                     | Частые вопросы                                                        |
| ----------------- | ---------------------------------------------------- | --------------------------------------------------------------------- |
| Запрос к модели   | Модель, вход, выход, токены и состояние              | Ошибки поставщика, слишком длинный контекст, пустой вывод             |
| Вызов инструмента | Имя инструмента, параметры, результат                | Неверные параметры, ожидание разрешений, аномальный ответ инструмента |
| Вызов MCP         | Название сервиса, тип соединения, вход и выход       | Разрыв соединения с сервером, сбой аутентификации, удалённая ошибка   |
| Выполнение Agent  | Agent, действие, количество инструментов и состояние | Ошибка подзадачи, процесс не завершился                               |
| HTTP-запрос       | Метод, URL, статус и ответ                           | Неверный адрес, проблемы с сетью или аутентификацией                  |

{% hint style="danger" %}
Цепочка вызовов может содержать prompt'ы, содержимое файлов, заголовки запросов и параметры инструментов. Перед тем как делиться скриншотами или экспортированной информацией, обязательно удалите API Key, Authorization, Cookie, почту, локальные пути и бизнес-данные.
{% endhint %}

## Случай пользователя: инструмент MCP возвращает пустой результат

Сначала на странице настроек MCP убедитесь, что сервер работает нормально, затем попросите Agent вызвать только один инструмент. Цепочка вызовов показывает, что запрос дошёл до сервера, но вывод пустой, значит проблема скорее на стороне данных или параметров сервера, а не в том, что Agent не привязан; если узла MCP вообще нет, вернитесь к проверке привязки в Agent 【MCP】.

<details>

<summary>Почему после включения всё ещё не видно цепочку вызовов?</summary>

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

</details>


---

# 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/developer-tools/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.