Call Chain Instructions

Feature introduction

The invocation chain (also called a "trace") provides users with insight into conversations, helping them perceive the specific behavior of the model, knowledge base, MCP, web search, etc. during the conversation. OpenTelemetry An observability tool implemented based on

OpenTelemetry that collects, stores, and processes data from the client side to enable visualization, providing quantitative evaluation basis for locating issues and optimizing performance.

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

Enable Trace

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

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

Scenario Introduction

Full-chain View

Click the invocation chain in the Cherry Studio dialog to view full-chain data. Whether the model, web search, knowledge base, or MCP was called during the conversation, you can view the full-chain invocation data in the invocation chain window.

View Models in the Chain

If you want to view details of a model in the invocation chain, click the model call node to see its input and output details.

View Web Search in the Chain

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

View Knowledge Base in the Chain

If you want to view details of a knowledge base call in the invocation chain, click the knowledge base call node to see its input and output details. In the details you can see the query to the knowledge base and the answer it returned.

View MCP Calls in the Chain

If you want to view details of an MCP in the invocation chain, click the MCP call node to see its input and output details. In the details you can see the input parameters to this MCP Server tool and the tool's return.

Questions and Suggestions This feature is provided by Alibaba Cloud EDAS

If you have questions or suggestions, please join the DingTalk group (Group ID: 21958624) for in-depth communication with the developers.