調用鏈使用教學

功能介紹

調用鏈（又稱「trace」）為用戶提供對話嘅洞察能力，幫助用戶覺察模型、知識庫、MCP、網絡搜索等喺對話過程中嘅具體表現。佢係一個基於 OpenTelemetry 實現嘅可觀測工具，通過端側採集、存儲、處理數據實現可視化，為定位問題、優化效果提供量化評估依據。

每次對話對應一條 trace 數據，一條 trace 由多個 span 組成，每個 span 對應 Cherry Studio 嘅一個程式處理邏輯例如調用模型會話、調用 MCP、調用知識庫、調用網絡搜索等。trace 以樹結構展示，span 為樹節點，主要數據包括耗時、token 使用量，當然喺 span 詳情仲可以查看佢具體嘅輸入輸出。

開啟 Trace

默認情況下，Cherry Studio 安裝之後，Trace 係隱藏狀態。需要喺「設置」-「常規設置」-「開發者模式」入面開啟，如下圖：

而且對於以前嘅會話唔會產生 Trace 記錄，只會喺新嘅問答產生之後先會產生 Trace 記錄。所產生嘅記錄儲存在本地，如需徹底清除 Trace，可以通過「設置」-「數據設置」-「數據目錄」-「清除緩存」進行清除，亦可手動刪除 ~/.cherrystudio/trace 底下嘅文件進行清除，如下圖：

場景介紹

全鏈路查看

喺 Cherry Studio 對話框入面點擊調用鏈可以查看調用鏈嘅全鏈路數據。無論喺對話過程中調用了模型、定係網絡搜索、知識庫、MCP，都可以喺調用鏈窗口入面睇到全鏈路調用數據。

查看鏈路中模型

如果想要查看調用鏈入面模型嘅詳情，可以點擊模型調用節點，查看其輸入、輸出詳情。

查看鏈路中網絡搜索

如果想要查看調用鏈入面網絡搜索嘅詳情，可以點擊網絡搜索調用節點，查看其輸入、輸出詳情。喺詳情入面，可以睇到調用網絡搜索查詢嘅問題同佢返回嘅結果。

查看鏈路中知識庫

如果想要查看調用鏈入面知識庫嘅詳情，可以點擊知識庫調用節點，查看其輸入、輸出詳情。喺詳情入面，可以睇到調用知識庫查詢嘅問題同佢返回嘅答案。

查看鏈路中 MCP 調用情況

如果想要查看調用鏈入面 MCP 嘅詳情，可以點擊 MCP 調用節點，查看其輸入、輸出詳情。喺詳情入面，可以睇到調用此 MCP Server tool 嘅入參同 tool 嘅返回。

問題同建議

當前功能由阿里雲 EDAS 團隊提供，如有問題或建議，請入釘釘群（群號：21958624）同開發者進行深入溝通。

\