日誌與監測
本篇介紹 LanSphere 應用的執行觀測能力:透過「對話日誌」分頁檢視執行記錄並進行標註,透過「資料看板」分頁掌握整體執行指標,以及按需匯出日誌進行歸檔與分析。適合負責應用營運與品質優化的開發人員、管理員與擁有者閱讀。
應用上線後,持續觀測執行狀況是保障服務品質的關鍵。建議你結合三個工具形成日常營運閉環:在資料看板中發現趨勢與異常,在對話日誌中定位具體問題,透過標註累積優化素材。
對話日誌
應用詳情頁的「對話日誌」分頁按應用類型展示執行記錄,工作流與對話類應用的日誌結構有所不同。
提示:「對話日誌」分頁同時承載日誌檢視與標註能力,也可理解為「對話日誌與標註」。智慧體應用同樣提供該分頁,使用方式一致。
工作流日誌
工作流是單輪自動化應用,日誌按執行次數記錄,每條包含以下欄位:
| 欄位 | 說明 |
|---|---|
| 狀態 | 本次執行的結果狀態 |
| 開始時間 | 執行觸發的時間 |
| 執行耗時 | 從觸發到結束的總耗時 |
| Token 總數 | 本次執行消耗的大模型 Token 總量 |
| 輸入 / 輸出 | 工作流接收的輸入與最終返回的輸出 |
| 節點中間過程 | 各節點在執行中的輸入、輸出等中間資料 |
對話流與智慧體日誌
對話類應用的日誌按對話維度組織:
- 每個對話展示包含的訊息數量;
- 每條訊息記錄輸入、輸出、耗時與 Token 消耗;
- 同時展示使用者對回答的回饋(好評 / 差評)。
檢視單條執行詳情
點擊單條日誌可檢視完整執行詳情:
- 工作流:逐節點檢視輸入、輸出與中間過程,還原完整執行鏈路;
- 對話類應用:逐條訊息檢視對話上下文,還原互動過程。
當應用執行異常或回答不符合預期時,建議先按時間或狀態找到問題日誌,再透過單條執行詳情逐步定位問題發生在哪個節點或哪條訊息,隨後回到「應用開發」分頁針對性調整編排、提示詞或知識庫設定。
標註
在對話日誌中,你可以對回答進行標註,持續優化應用的回答品質:
- 好評 / 差評:標記回答品質,快速區分優質回答與問題回答;
- 標註回覆:為不理想的回答補充期望的回覆內容,記錄正確的應答方式。
操作場景舉例:
- 定期篩查差評較多的話題,判斷問題是出在知識庫內容缺失、提示詞約束不足,還是編排邏輯不當;
- 對典型問題回答新增標註回覆,作為後續優化的參照;
- 將標註累積用於完善提示詞、補充知識庫內容或調整編排邏輯,形成「發現問題—標註記錄—優化應用」的持續改進閉環。
標註是一項需要長期堅持的工作。建議將標註納入應用的日常營運流程,安排專人定期處理差評記錄,並在每次應用優化後回頭驗證同類問題的回答是否改善。
資料看板
「資料看板」分頁以視覺化圖表展示應用的整體執行狀況,主要指標包括:
| 指標 | 說明 |
|---|---|
| 執行成功率 | 應用成功完成執行的比例,反映服務穩定性 |
| 平均回應時間 | 應用回應請求的平均耗時,反映服務效能 |
| Token 用量 | 大模型 Token 消耗情況,反映使用規模與成本趨勢 |
| 工具呼叫分佈 | 各類工具被呼叫的分佈情況,反映能力使用結構 |
圖表支援按時間範圍篩選。你可以對比不同時段的指標變化:例如成功率突然下降時,縮小時間範圍定位異常起點,再回到對話日誌中查找對應時段的失敗記錄;Token 用量異常增長時,可結合日誌排查是否存在異常呼叫。
日誌匯出
當需要歸檔留存或在平台外深入分析日誌時,可將日誌匯出為 JSON 檔案。
權限
僅擁有者與管理員可見「匯出」按鈕,其他角色無法匯出日誌。
操作步驟
- 開啟應用的「對話日誌」分頁,點擊「匯出」;
- 在彈出視窗中選擇時間範圍,共九檔可選:
| 今天 | 過去 7 天 | 過去 4 週 |
| 過去 3 月 | 過去 12 月 | 本月至今 |
| 本季度至今 | 本年至今 | 所有時間 |
- 確認後匯出 JSON 檔案,檔案名形如
對話日誌_20260729_120000.json,即「對話日誌_匯出日期_匯出時間.json」。
提示:所選時間範圍內無資料時,系統提示「無符合條件的日誌」,請調整時間範圍後重試。
匯出檔案說明
匯出內容的欄位構成與「對話日誌」分頁的展示口徑一致,按應用類型組織:
- 工作流應用:包含各次執行的狀態、開始時間、耗時、Token 總數、輸入輸出與節點中間過程;
- 對話流與智慧體應用:包含對話維度的訊息數量,以及逐條訊息的輸入、輸出、耗時、Token 與使用者回饋。
其中使用者回饋以編碼記錄:
| 編碼 | 含義 |
|---|---|
| 1 | 好評 |
| 0 | 差評 |
| 2 | 無回饋 |
相關閱讀
- 應用的發佈方式與渠道設定,請參閱《發佈渠道》;
- 應用權限、擁有權轉移與刪除規則,請參閱《應用管理》;
- 對話流、智慧體應用的編排與偵錯,請參閱《對話流》《智慧體》。

