調用鏈使用說明

功能介紹

調用鍊（又稱「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）同開發者進行深入溝通。

\