# 呼び出しチェーン使用チュートリアル

## 機能紹介

呼び出しチェーン（「trace」とも呼ばれる）は、ユーザーに対話の洞察力を提供し、対話プロセスにおけるモデル、知識ベース、MCP、ネット検索などの具体的な挙動を把握するのに役立ちます。これは、 [OpenTelemetry](https://opentelemetry.io/docs/languages/js/) を基盤にした可観測性ツールで、エッジ側での収集、保存、処理を通じてデータを可視化し、問題の特定や効果の最適化に対する定量的な評価基準を提供します。

各対話は1つの trace データに対応し、1つの trace は複数の span で構成されます。各 span は、Cherry Studio の1つの処理ロジックに対応し、たとえばモデル呼び出し、MCP 呼び出し、知識ベース呼び出し、ネット検索呼び出しなどがあります。trace はツリー構造で表示され、span はツリーのノードです。主なデータには所要時間、トークン使用量が含まれ、もちろん span の詳細では具体的な入力と出力も確認できます。

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-a77fc14ce4cb0ffbc5adaec47be4a01f99969065%2Ftrace2.gif?alt=media" alt=""><figcaption></figcaption></figure>

## Trace を有効にする

デフォルトでは、Cherry Studio をインストールした後、Trace は非表示の状態です。「設定」-「一般設定」-「開発者モード」で有効にする必要があります。下図のとおりです。

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-51a20a658707f8b05ecb7c916294bbdc4625d126%2Fimage%20(84).png?alt=media" alt=""><figcaption></figcaption></figure>

また、以前の会話には Trace レコードは生成されず、新しい Q\&A が発生してから Trace レコードが生成されます。生成されたレコードはローカルに保存されます。Trace を完全に削除したい場合は、「設定」-「データ設定」-「データディレクトリ」-「キャッシュをクリア」で削除できます。また、\~/.cherrystudio/trace 下のファイルを手動で削除しても消去できます。下図のとおりです。

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-0c7e2a505de874126b9829e37558911bd9234999%2Fimage%20(85).png?alt=media" alt=""><figcaption></figcaption></figure>

## シナリオ紹介

### 全体チェーンの表示

Cherry Studio のダイアログで呼び出しチェーンをクリックすると、呼び出しチェーンの全体チェーンデータを確認できます。対話中にモデル、ネット検索、知識ベース、MCP を呼び出した場合でも、呼び出しチェーンウィンドウで全体チェーンの呼び出しデータを確認できます。

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-93148219202487564661df7da68d65fafac3f2da%2Fimage%20(1)%20(1)%20(1)%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-481e8ba6b2a0e70ad2995e3ab6e0e3726e0bbffd%2Fimage%20(86).png?alt=media" alt=""><figcaption></figcaption></figure>

### チェーン内のモデルを表示

呼び出しチェーン内のモデルの詳細を確認したい場合は、モデル呼び出しノードをクリックして、その入力・出力の詳細を表示できます。

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-0e8486369f67c8e71c2c07919e30c70760478561%2Fimage%20(87).png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-2d49faa56aebd28fdaf20cb9dbb2d9ca4c6cfd8e%2Fimage%20(88).png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-96f238d70d1f1a0dcd22d813bdb3af3ebe848d96%2Fimage%20(89).png?alt=media" alt=""><figcaption></figcaption></figure>

### チェーン内のネット検索を表示

呼び出しチェーン内のネット検索の詳細を確認したい場合は、ネット検索呼び出しノードをクリックして、その入力・出力の詳細を表示できます。詳細では、ネット検索呼び出しで問い合わせた問題と、その返却結果を確認できます。

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-21ecbb9de818aab2bdeff80c192e332952299caf%2Fimage%20(2)%20(1)%20(1)%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-2415d142d53d895e2509792d905ca96a013cf89f%2Fimage%20(150).png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-8e335e3aebcaa6752565ddc1dca50022f91dde0b%2Fimage%20(151).png?alt=media" alt=""><figcaption></figcaption></figure>

### チェーン内の知識ベースを表示

呼び出しチェーン内の知識ベースの詳細を確認したい場合は、知識ベース呼び出しノードをクリックして、その入力・出力の詳細を表示できます。詳細では、知識ベース呼び出しで問い合わせた問題と、その返答を確認できます。

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-4700709368687dbc376e37876bad6c08618ce9f2%2Fimage%20(152).png?alt=media" alt=""><figcaption></figcaption></figure>

### チェーン内の MCP 呼び出し状況を表示

呼び出しチェーン内の MCP の詳細を確認したい場合は、MCP 呼び出しノードをクリックして、その入力・出力の詳細を表示できます。詳細では、この MCP Server tool を呼び出した際の入力パラメータと tool の返却値を確認できます。

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-567f91c51a3c0d443acc9f1e115d045104f5e968%2Fimage%20(153).png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-7086417ba8cbb04e89d9d2ef9a5d36f6044241dc%2Fimage%20(154).png?alt=media" alt=""><figcaption></figcaption></figure>

## 問題と提案

現在の機能はアリババクラウド [EDAS](https://www.aliyun.com/product/edas) チームが提供しています。問題や提案がある場合は、DingTalk グループ（グループ番号：21958624）に参加し、開発者と直接深くコミュニケーションしてください。

\\