Từ yêu cầu đến điều tra và hỗ trợ
- Mở Yêu cầu trong không gian làm việc sở hữu yêu cầu. Tìm Request ID và chọn dòng tương ứng.
- Mở chi tiết đầy đủ trên trang riêng. Quay lại danh sách sẽ khôi phục bộ lọc. Liên kết không cấp quyền vào không gian khác; hãy dùng tài khoản được phép truy cập.
- Với trạng thái đang chờ hoặc chưa rõ, hãy làm mới tiến độ trước. Khi thất bại hoặc phản hồi bị gián đoạn, dùng thao tác điều tra được cung cấp để mở Agent trong ứng dụng. Điều tra không gửi lại yêu cầu gốc đến mô hình. Yêu cầu thành công thường không cần điều tra.
- Nếu vẫn cần giúp đỡ, chọn hỗ trợ con người từ yêu cầu hoặc cuộc điều tra. Kiểm tra bản xem trước cùng liên kết yêu cầu và hội thoại khi có, xóa nội dung riêng tư rồi chủ động gửi. Chỉ điều tra hay mở bản xem trước không gửi yêu cầu hỗ trợ.
- Lưu xác nhận gửi và tiếp tục cùng hội thoại trong Hỗ trợ để đọc trả lời, bổ sung thông tin thay vì gửi trùng.
Các Định Danh Công Khai Cần Ghi Nhận
Không lưu trữ ID nhiệm vụ của nhà cung cấp, URL của nhà cung cấp, định danh của nhà cung cấp, khóa Redis hoặc siêu dữ liệu thực thi nhạy cảm như bản ghi hiển thị cho khách hàng.
Những Gì Cần Ghi Nhận
Ghi lại đủ thông tin để chẩn đoán yêu cầu mà không tiết lộ bí mật:- Điểm cuối, phương thức HTTP, mô hình, mã trạng thái, dấu thời gian và độ trễ.
- Các định danh công khai:
request_id,task_id,poll_url, vàbilling_transaction_idkhi có. - Hình dạng yêu cầu đã được làm sạch: các trường nào có mặt, không phải toàn bộ lời nhắc hoặc nội dung phương tiện riêng tư.
- Phản hồi trạng thái không đồng bộ cuối cùng, bao gồm các trường lỗi công khai.
- Số lần thử lại của khách hàng và liệu lần thử lại có tạo ra một nhiệm vụ mới hay tiếp tục một nhiệm vụ hiện có.
Authorization, API keys, management tokens, signed URLs, private media URLs, toàn bộ lời nhắc, và dữ liệu cá nhân của người dùng trừ khi bạn có sự cho phép rõ ràng để giữ lại chúng.
Ma Trận Khắc Phục Sự Cố
Đối Chiếu Sử Dụng
Sử dụng Management API để đối chiếu phía máy chủ:GET /v1/management/api-keys/{keyId}/usage có thể lọc theo scene, model, modelVendor, startDate, và endDate. Sử dụng các bản ghi này thay vì lấy thông tin từ các trang bảng điều khiển hoặc dựa vào ID nhiệm vụ của nhà cung cấp.
Các phản hồi phát trực tiếp có thể được thanh toán sau khi luồng được gửi, vì vậy một tiêu đề thanh toán có thể không có ngay cả khi việc sử dụng được ghi lại sau đó. Các nhiệm vụ phương tiện không đồng bộ có thể được thanh toán sau khi lấy thông tin cuối cùng.
Mẫu Gói Hỗ Trợ
Khi liên hệ với hỗ trợ, bao gồm:request_id.task_idvàpoll_urlcho công việc không đồng bộ.billing_transaction_idkhi có.- Điểm cuối, phương thức, mô hình, dấu thời gian, và mã trạng thái.
- Hình dạng yêu cầu đã được làm sạch và nội dung lỗi công khai.
- Kết quả mong đợi của bạn và những gì người dùng thực sự thấy.
Kiểm Tra Vận Hành
- Cảnh báo về các phản hồi
401,402,429, và5xxlặp lại riêng biệt; chúng thường có các chủ sở hữu khác nhau. - Theo dõi các công việc không đồng bộ vẫn không kết thúc lâu hơn SLA sản phẩm của bạn.
- Theo dõi các nỗ lực tạo trùng lặp cho cùng một ID công việc của người dùng.
- Lấy mẫu các công việc đã hoàn thành và xác minh tài sản có thể nhìn thấy của người dùng, hồ sơ sử dụng, và bản ghi nhiệm vụ đã lưu trữ đồng ý.