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

# 呼び出しチェーン使用ガイド

## 機能紹介

OpenTelemetry ベースの [OpenTelemetry](https://opentelemetry.io/docs/languages/js/) 実装された可観測性ツールです。端末側でデータを自動収集・保存・処理することで、会話の背後にある完全な実行プロセスを可視化し、各処理段階（たとえばモデル呼び出し、知識ベース検索、MCP ツール呼び出し、または Web 検索）の所要時間、入出力、トークン使用状況を確認するために使われます。問題の特定や効果の最適化に向けた定量評価の根拠を提供します。

新しい会話リクエストごとに 1 件の trace データが生成されます。1 つの trace は複数の span で構成され、各 span は Cherry Studio の 1 つの処理段階に対応します。たとえば、モデル呼び出し、知識ベース検索、MCP ツール呼び出し、または Web 検索です。Trace ウィンドウではこれらの span をツリー構造で表示し、階層ごとに展開して詳細を確認できます。

<figure><img src="/files/993b37b6efb47cc91638dc3d7e384ee5b29d62fd" alt=""><figcaption><p>コールチェーン全体の表示</p></figcaption></figure>

## Trace を有効にする

Trace はデフォルトで非表示です。まず開発者モードを有効にする必要があります：

1. 開く `設定 → 一般設定`
2. を見つけて **開発者モード**
3. 有効にする **開発者モードを有効化**

<figure><img src="/files/6075c10924aa56a7a3683828bd457fac98ce871b" alt=""><figcaption><p>一般設定で開発者モードを有効にする</p></figcaption></figure>

{% hint style="info" %}
有効化後、それ以前に生成された会話には Trace は再生成されません。以降の新しい Q\&A のみがコールチェーンを記録します。
{% endhint %}

Trace データはローカルのアプリデータディレクトリに保存されます。通常は手動で処理する必要はありません。完全に削除する場合は、 `設定 → データ設定 → データディレクトリ`、 **キャッシュをクリア**を使用するか、データディレクトリを開いて trace 関連のキャッシュを削除してください。

一般的なデータディレクトリ：

* **macOS**に由来する：`~/Library/Application Support/CherryStudio`
* **Windows**に由来する：`%APPDATA%\CherryStudio`
* **Linux**に由来する：`~/.config/CherryStudio`

<figure><img src="/files/029f40a2a6d0f2bfe13ca2a66b665a320bb26ac3" alt=""><figcaption><p>データディレクトリとキャッシュ削除の入口</p></figcaption></figure>

## シナリオ紹介

### 全チェーン確認

Cherry Studio のチャット画面でコールチェーンボタンをクリックすると、この会話の完全なチェーンを開けます。会話中にモデル、Web 検索、知識ベース、または MCP を呼び出した場合でも、コールチェーンウィンドウで対応するノードを確認できます。

<figure><img src="/files/57b955f342b7e5180dc1140afa9a97e674896156" alt=""><figcaption><p>会話メッセージ横のコールチェーン入口</p></figcaption></figure>

<figure><img src="/files/62e6bb6b91d68f565db5a70ab2d6cf78b71f445b" alt=""><figcaption><p>コールチェーンのツリービュー</p></figcaption></figure>

### モデル呼び出しの確認

モデル呼び出しノードをクリックすると、このモデルリクエストの所要時間、トークン使用量、入力と出力を確認できます。

<figure><img src="/files/a5b22453047d57e8992c2fce5f971b442fb23184" alt=""><figcaption><p>モデル呼び出しノードを選択</p></figcaption></figure>

<figure><img src="/files/4203e47c3fc8458e5e429351fc413d68dab3c751" alt=""><figcaption><p>モデル呼び出しの入力</p></figcaption></figure>

<figure><img src="/files/bdf58d28ef19828e76a27bf679c1ae30162e3576" alt=""><figcaption><p>モデル呼び出しの出力</p></figcaption></figure>

### Web 検索の確認

Web 検索ノードをクリックすると、検索リクエストの質問、返された結果、そして後続でモデルに渡されるコンテキストを確認できます。

<figure><img src="/files/c9d7a99260dad08745a4f5c52574c99bb1132d27" alt=""><figcaption><p>Web 検索ノードを選択</p></figcaption></figure>

<figure><img src="/files/8af11477f639e147fbc423574a2c3a1d51eeeedd" alt=""><figcaption><p>Web 検索の入力</p></figcaption></figure>

<figure><img src="/files/00dfe0e160aa0aae14a67578c8df9cb621ed4d6f" alt=""><figcaption><p>Web 検索の返却結果</p></figcaption></figure>

### 知識ベース検索の確認

知識ベースノードをクリックすると、検索クエリ、ヒットした内容、および知識ベースがモデルに返したコンテキストを確認できます。

<figure><img src="/files/1f057111c79c79b55f538a21f91f360c01ac2eb0" alt=""><figcaption><p>知識ベースノードの詳細</p></figcaption></figure>

### MCP 呼び出しの確認

MCP ノードをクリックすると、MCP Server tool の入力パラメータ、戻り値、所要時間を確認でき、ツール呼び出しが期待どおりかを切り分けるのに役立ちます。

<figure><img src="/files/f5a614d2a8e4ad4893ffb619dfe79ac5030c5b8e" alt=""><figcaption><p>MCP 呼び出しの詳細</p></figcaption></figure>

<figure><img src="/files/a1fd3d3cd44ffeefb7ed11d70941cbb06e9f9206" alt=""><figcaption><p>MCP の返却結果</p></figcaption></figure>

## 問題と提案

コールチェーンの表示に異常がある場合、またはさらに可観測性を拡充したい場合は、 [フィードバックと提案](/docs/jp/question-contact/suggestions.md) に記載の公式チャネルを参照してください。フィードバック時には、Trace のスクリーンショット、使用したモデル、知識ベース / MCP / Web 検索を有効にしているかどうか、そして再現可能な質問内容を添えることをおすすめします。

***

### 💡 ヘルプの取得とフィードバックの送信

設定や使用の過程で疑問、Bug、機能改善の提案がある場合は、 [フィードバックと提案](/docs/jp/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/jp/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.