日誌與監測 | 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 無回饋

相關閱讀

  • 應用嘅發佈方式同渠道設定,請參閱《發佈渠道》;
  • 應用權限、擁有權轉移同刪除規則,請參閱《應用管理》;
  • 對話流、智能體應用嘅編排同調試,請參閱《對話流》《智能體》。