コールチェーン使用チュートリアル

機能紹介

トレース（別名「trace」）はユーザーに対話の洞察を提供し、対話中のモデル、ナレッジベース、MCP、ウェブ検索などの具体的な挙動を把握するのに役立ちます。それは、 OpenTelemetry を基盤とした可観測性ツールで、クライアント側でデータを収集・保存・処理して可視化を実現し、問題の特定や効果の最適化に対する定量的な評価基準を提供します。

各対話は1つのトレースデータに対応し、1つのトレースは複数のスパンで構成されます。各スパンは Cherry Studio の1つの処理ロジック（モデルセッションの呼び出し、MCP の呼び出し、ナレッジベースの呼び出し、ウェブ検索の呼び出しなど）に対応します。トレースはツリー構造で表示され、スパンがツリーノードとなり、主なデータには所要時間やトークン使用量が含まれます。もちろんスパンの詳細では具体的な入出力も確認できます。

トレースを有効にする

デフォルトでは、Cherry Studio をインストールした後、トレースは非表示になっています。「設定」-「一般設定」-「開発者モード」で有効にする必要があります。以下の図参照：

また、過去の会話にはトレース記録は生成されず、新しいQAが発生したときにのみトレース記録が作成されます。生成された記録はローカルに保存されます。トレースを完全にクリアする必要がある場合は、「設定」-「データ設定」-「データディレクトリ」-「キャッシュをクリア」で削除するか、手動で ~/.cherrystudio/trace 以下のファイルを削除してクリアできます。以下の図参照：