從請求詳情到調查與人工支援
- 在請求所屬工作區開啟請求記錄，依 Request ID 找到並選取記錄。
- 開啟完整詳情進入獨立頁面；返回請求清單時會還原篩選。連結不會授予其他工作區的存取權，請使用已獲授權的帳戶。
- 處理中或狀態未知時，先重新整理進度。明確失敗或接收中斷時，可按需啟動站內 Agent 調查該請求，不會重送原模型請求。正常成功的請求預設不需要調查。
- 仍需協助時，從請求或調查選擇人工支援，先開啟預覽；可用時會關聯原請求和對話。核對摘要、移除私密內容，再明確提交。啟動調查或開啟預覽本身不會傳送客服請求。
- 提交後保留確認回執，在支援中繼續同一對話、查看回覆及補充資訊，避免重複提交。
要捕獲的公共識別碼
請勿將供應商任務 ID、供應商 URL、供應商識別碼、Redis 鍵或敏感執行元數據存儲為面向客戶的記錄。
要記錄的內容
記錄足夠的信息以診斷請求而不洩漏秘密：- 端點、HTTP 方法、模型、狀態碼、時間戳和延遲。
- 公共識別碼：
request_id、task_id、poll_url和billing_transaction_id（如果存在）。 - 清理過的請求形狀：哪些字段存在，而不是完整的提示或私有媒體內容。
- 終端非同步狀態響應，包括公共錯誤字段。
- 客戶端重試計數以及重試是否創建了新任務或恢復了現有任務。
Authorization、API 鍵、管理令牌、簽名 URL、私有媒體 URL、完整提示和用戶個人數據。
故障排除矩陣
使用情況對帳
使用管理 API 進行伺服器端對帳：GET /v1/management/api-keys/{keyId}/usage 可以根據 scene、model、modelVendor、startDate 和 endDate 進行過濾。使用這些記錄，而不是抓取儀表板頁面或依賴供應商任務 ID。
串流響應可能在串流發送後結算，因此即使稍後記錄使用情況，計費標頭也可能缺失。非同步媒體任務可能在終端輪詢後結算。
支援包模板
聯繫支援時，請包括：request_id。task_id和poll_url用於非同步工作。billing_transaction_id（如果存在）。- 端點、方法、模型、時間戳和狀態碼。
- 清理過的請求形狀和公共錯誤主體。
- 您的預期結果和用戶實際看到的內容。
操作檢查
- 對重複的
401、402、429和5xx響應分別發出警報；它們通常有不同的負責人。 - 跟踪在您的產品 SLA 內長時間保持非終端的非同步任務。
- 跟踪同一用戶工作 ID 的重複創建嘗試。
- 抽樣已完成的任務，並驗證用戶可見資產、使用記錄和存儲的任務記錄是否一致。