コールチェーンと開発者モード

コールチェーンは、1回の会話やAgentタスク内で発生したモデルリクエスト、ツール呼び出し、MCPインタラクションを確認するために使います。デバッグやパフォーマンス分析に適しており、日常的なチャットで必ず有効にする必要がある機能ではありません。

MCP呼び出しを確認する際は、まずサーバーと認証を確認し、その後コールチェーンでリクエストがAgentとツール実行の段階に入っているかを判断します。

有効化方法

1

1. 【設定】→【システム】を開く

【開発者モード】エリアで【開発者モードを有効にする】をオンにします。

2

2. Cherry Studio を再起動

開発者モードは再起動後に有効になります。再起動前に実行中のAgentタスクは、先に状態を確認してください。

3

3. 問題を再現する

必要最小限のモデルとツールだけを残して、最小限のテストメッセージを再送し、不要な呼び出しを減らします。

4

4. コールチェーンを開く

会話またはAgentの右側パネルで【コールチェーン】を開き、ノードを選択して入力、出力、所要時間、状態を確認します。Agentタスクでは、Agent名、操作、ツール呼び出し回数も確認できます。

よくあるノードの見方

ノード	重点的に確認	よくある質問
モデルリクエスト	モデル、入力、出力、トークン、状態	サービス提供側のエラー、コンテキストが長すぎる、出力が空
ツール呼び出し	ツール名、パラメータ、結果	パラメータエラー、権限待ち、ツールの戻り値異常
MCP呼び出し	サービス名、接続タイプ、入力と出力	サーバー切断、認証失敗、リモートエラー
Agent実行	Agent、操作、ツール数、状態	サブタスクの失敗、フローが終了していない
HTTPリクエスト	メソッド、URL、状態、レスポンス	アドレスの誤り、ネットワークまたは認証の問題

コールチェーンには、プロンプト、ファイル内容、リクエストヘッダー、ツールパラメータが含まれる場合があります。スクリーンショットやエクスポート情報を共有する前に、API Key、Authorization、Cookie、メールアドレス、ローカルパス、業務データを必ず削除してください。

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

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

有効にしたのに、なぜコールチェーンが見えないのですか？

アプリを再起動し、再起動後にもう一度リクエストを送信したことを確認してください。有効化前に生成された履歴メッセージには、呼び出しデータは自動的に追加されません。