4.1 Debugging and Error Handling (2.6%)

Phân loại lỗi, chọn cách khôi phục, và đọc trace để tách lỗi tầng tích hợp khỏi lỗi đầu ra model.

1. 429 (rate limit), 500 (api_error), 529 (overloaded) thường tạm thời → retry có backoff. 400/401/403/413 là lỗi client → sửa request hoặc credential.
2. Trace cho thấy tool trả 401/timeout → lỗi tích hợp: sửa tích hợp, báo lỗi cho Claude qua is_error, theo dõi tỉ lệ lỗi tool — đừng sửa prompt.
3. stop_reason: "model_context_window_exceeded" → giảm context (compaction, xóa tool result cũ) rồi tiếp tục.
4. Chấm eval: code (khớp chính xác/chuỗi) khi được — nhanh, tin cậy nhất; LLM chấm với rubric rõ cho tiêu chí tinh tế (kiểm tra độ tin cậy trước); người chấm chậm và đắt, hạn chế dùng. Ưu tiên nhiều ca chấm tự động hơn ít ca chấm tay.