Call Chain Usage Tutorial

Feature Introduction

The call trace (also known as "trace") provides users with insight into conversations, helping users perceive the specific behavior of the model, knowledge base, MCP, web search, etc. during the conversation. OpenTelemetry An observability tool implemented with, which enables visualization by collecting, storing, and processing data from the client side, providing quantitative evaluation for troubleshooting and optimization.

Each conversation corresponds to one trace record. A trace consists of multiple spans, and each span corresponds to a processing logic in Cherry Studio such as invoking a model session, calling MCP, querying the knowledge base, or performing a web search. Traces are displayed as a tree structure with spans as tree nodes. Main data includes duration and token usage, and span details also show specific inputs and outputs.

Enable Trace

By default, Trace is hidden after Cherry Studio is installed. You need to enable it in "Settings" - "General Settings" - "Developer Mode", as shown below:

Trace records are not generated for previous sessions; they are only created after new Q&A occurs. The generated records are stored locally. To completely clear Trace, go to "Settings" - "Data Settings" - "Data Directory" - "Clear Cache", or manually delete files under ~/.cherrystudio/trace, as shown below:

Scenario Introduction

Full-path View

Click Call Trace in the Cherry Studio dialog to view end-to-end call trace data. Whether the conversation invoked the model, web search, knowledge base, or MCP, you can see the full-path call data in the call trace window.

View Models in the Trace

To view details of a model in the call trace, click the model call node to see its input and output details.

View Web Search in the Trace

To view details of a web search in the call trace, click the web search call node to see its input and output details. In the details you can view the query sent to the web search and the returned results.

View Knowledge Base in the Trace

To view details of the knowledge base in the call trace, click the knowledge base call node to see its input and output details. In the details you can view the query sent to the knowledge base and the returned answer.

View MCP Calls in the Trace

To view details of MCP in the call trace, click the MCP call node to see its input and output details. In the details you can view the parameters passed to this MCP Server tool and the tool's response.

Questions and Suggestions

This feature is provided by Alibaba Cloud EDAS team. If you have questions or suggestions, please join the DingTalk group (Group ID: 21958624) to have in-depth communication with the developers.

\