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

# 呼び出しチェーンと開発者モード

コールチェーンは、1回の会話や Agent タスク内で発生したモデルリクエスト、ツール呼び出し、MCP 連携を確認するためのものです。トラブルシューティングや性能分析に適しており、日常のチャットで必ず有効にする必要がある機能ではありません。

<figure><img src="/files/d7e08ee7b11e28a916a7d60b30a643a27531d2dc" 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" %}
コールチェーンには、プロンプト、ファイル内容、リクエストヘッダー、ツールパラメータが含まれる場合があります。スクリーンショットを共有したり情報を書き出したりする前に、API Key、Authorization、Cookie、メールアドレス、ローカルパス、業務データを必ず削除してください。
{% endhint %}

### ユーザー事例：MCP ツールが空結果を返す

まず MCP 設定ページでサーバーが正常か確認し、その後 Agent に 1 つだけツールを呼び出させます。コールチェーンでリクエストがサーバーに到達したが出力が空であることが分かれば、問題は Agent がバインドされていないことよりも、サーバー側のデータやパラメータにある可能性が高いです。そもそも MCP ノードがない場合は、Agent の【MCP】でバインドを確認してください。

<details>

<summary>有効にしてもコールチェーンが見えないのはなぜですか？</summary>

アプリを再起動したうえで、再起動後にもう一度リクエストを送信しているか確認してください。有効化前に発生した過去のメッセージには、コールデータは自動では補完されません。

</details>

<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/jp/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.