> 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>


---

# 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.