日誌與監測 | LanSphere 使用手冊

日誌與監測

本篇介紹 LanSphere 應用的執行觀測能力:透過「對話日誌」分頁檢視執行記錄並進行標註,透過「資料看板」分頁掌握整體執行指標,以及按需匯出日誌進行歸檔與分析。適合負責應用營運與品質優化的開發人員、管理員與擁有者閱讀。

應用上線後,持續觀測執行狀況是保障服務品質的關鍵。建議你結合三個工具形成日常營運閉環:在資料看板中發現趨勢與異常,在對話日誌中定位具體問題,透過標註累積優化素材。

對話日誌

應用詳情頁的「對話日誌」分頁按應用類型展示執行記錄,工作流與對話類應用的日誌結構有所不同。

提示:「對話日誌」分頁同時承載日誌檢視與標註能力,也可理解為「對話日誌與標註」。智慧體應用同樣提供該分頁,使用方式一致。

工作流日誌

工作流是單輪自動化應用,日誌按執行次數記錄,每條包含以下欄位:

欄位 說明
狀態 本次執行的結果狀態
開始時間 執行觸發的時間
執行耗時 從觸發到結束的總耗時
Token 總數 本次執行消耗的大模型 Token 總量
輸入 / 輸出 工作流接收的輸入與最終返回的輸出
節點中間過程 各節點在執行中的輸入、輸出等中間資料

對話流與智慧體日誌

對話類應用的日誌按對話維度組織:

  • 每個對話展示包含的訊息數量;
  • 每條訊息記錄輸入、輸出、耗時與 Token 消耗;
  • 同時展示使用者對回答的回饋(好評 / 差評)。

檢視單條執行詳情

點擊單條日誌可檢視完整執行詳情:

  • 工作流:逐節點檢視輸入、輸出與中間過程,還原完整執行鏈路;
  • 對話類應用:逐條訊息檢視對話上下文,還原互動過程。

當應用執行異常或回答不符合預期時,建議先按時間或狀態找到問題日誌,再透過單條執行詳情逐步定位問題發生在哪個節點或哪條訊息,隨後回到「應用開發」分頁針對性調整編排、提示詞或知識庫設定。

標註

在對話日誌中,你可以對回答進行標註,持續優化應用的回答品質:

  • 好評 / 差評:標記回答品質,快速區分優質回答與問題回答;
  • 標註回覆:為不理想的回答補充期望的回覆內容,記錄正確的應答方式。

操作場景舉例:

  1. 定期篩查差評較多的話題,判斷問題是出在知識庫內容缺失、提示詞約束不足,還是編排邏輯不當;
  2. 對典型問題回答新增標註回覆,作為後續優化的參照;
  3. 將標註累積用於完善提示詞、補充知識庫內容或調整編排邏輯,形成「發現問題—標註記錄—優化應用」的持續改進閉環。

標註是一項需要長期堅持的工作。建議將標註納入應用的日常營運流程,安排專人定期處理差評記錄,並在每次應用優化後回頭驗證同類問題的回答是否改善。

資料看板

「資料看板」分頁以視覺化圖表展示應用的整體執行狀況,主要指標包括:

指標 說明
執行成功率 應用成功完成執行的比例,反映服務穩定性
平均回應時間 應用回應請求的平均耗時,反映服務效能
Token 用量 大模型 Token 消耗情況,反映使用規模與成本趨勢
工具呼叫分佈 各類工具被呼叫的分佈情況,反映能力使用結構

圖表支援按時間範圍篩選。你可以對比不同時段的指標變化:例如成功率突然下降時,縮小時間範圍定位異常起點,再回到對話日誌中查找對應時段的失敗記錄;Token 用量異常增長時,可結合日誌排查是否存在異常呼叫。

日誌匯出

當需要歸檔留存或在平台外深入分析日誌時,可將日誌匯出為 JSON 檔案。

權限

僅擁有者與管理員可見「匯出」按鈕,其他角色無法匯出日誌。

操作步驟

  1. 開啟應用的「對話日誌」分頁,點擊「匯出」;
  2. 在彈出視窗中選擇時間範圍,共九檔可選:
今天 過去 7 天 過去 4 週
過去 3 月 過去 12 月 本月至今
本季度至今 本年至今 所有時間
  1. 確認後匯出 JSON 檔案,檔案名形如 對話日誌_20260729_120000.json,即「對話日誌_匯出日期_匯出時間.json」。

提示:所選時間範圍內無資料時,系統提示「無符合條件的日誌」,請調整時間範圍後重試。

匯出檔案說明

匯出內容的欄位構成與「對話日誌」分頁的展示口徑一致,按應用類型組織:

  • 工作流應用:包含各次執行的狀態、開始時間、耗時、Token 總數、輸入輸出與節點中間過程;
  • 對話流與智慧體應用:包含對話維度的訊息數量,以及逐條訊息的輸入、輸出、耗時、Token 與使用者回饋。

其中使用者回饋以編碼記錄:

編碼 含義
1 好評
0 差評
2 無回饋

相關閱讀

  • 應用的發佈方式與渠道設定,請參閱《發佈渠道》;
  • 應用權限、擁有權轉移與刪除規則,請參閱《應用管理》;
  • 對話流、智慧體應用的編排與偵錯,請參閱《對話流》《智慧體》。