Chuyển đến nội dung chính

AI Agent bị timeout sau khi tạo phiếu, làm sao tránh tạo trùng?

Giữ mã thao tác qua các lần thử, kiểm tra trạng thái ở hệ thống đích và xử lý rõ trường hợp chưa biết kết quả.

Sơ đồ minh họa: Giữ mã thao tác → Kiểm tra đích → Quyết định lần thử

Đăng ngày

Khi gọi tạo phiếu bị timeout, hệ thống đích có thể đã ghi phiếu và chỉ mất phản hồi. Hãy coi kết quả là chưa xác định. Mỗi thao tác nghiệp vụ nên có một mã cố định qua các lần thử, gắn với yêu cầu đã được duyệt.

Hai trường hợp tích hợp

Nếu hệ thống đích có cơ chế chống ghi lặp, gửi cùng khóa trong lần thử lại và kiểm tra hành vi khi cùng khóa đi với nội dung khác. Nếu đích chỉ hỗ trợ mã tham chiếu, dùng mã đó để tra phiếu. Nếu đích không có cách kiểm tra đáng tin cậy, đưa thao tác vào hàng đối soát; tránh tự động tạo thêm khi chưa biết kết quả.

Tình huống mẫu

Agent gửi lệnh mở phiếu cho đơn BMB-1042. API hết thời gian chờ sau khi đích đã lưu P-071. Agent tra theo mã thao tác và nhận P-071, sau đó cập nhật kết quả. Nếu không tìm thấy ngay, cần tính đến độ trễ tra cứu; một lần tra rỗng chưa đủ chứng minh đích chưa ghi.

Kiểm thử trước khi bật ghi

Thử mất phản hồi sau khi ghi, hai yêu cầu đồng thời cùng mã và trường hợp đổi nội dung sau phê duyệt. Nhật ký cần cho biết mã thao tác, lần thử, kết quả đối soát và mã phiếu cuối cùng.

Đặt mã theo ý định đã được duyệt

Tạo mã thao tác trước lần gửi đầu tiên và lưu bền vững cùng loại hành động, đơn nghiệp vụ, nội dung được duyệt và trạng thái. Khi tác vụ được nối lại sau gián đoạn, đọc mã cũ từ bản ghi này. Mã của từng lần gọi vẫn có thể khác để chẩn đoán kỹ thuật. Nếu dùng mã lần gọi làm khóa chống trùng, lần thử lại sẽ trông giống một yêu cầu tạo mới.

Phạm vi khóa cần phù hợp với hệ thống đích, chẳng hạn theo đơn vị, tài khoản tích hợp và loại tác vụ. Cùng một đơn có thể phát sinh phiếu giao hàng và phiếu điều chỉnh, nên riêng mã đơn chưa đủ. Nếu người dùng sửa nội dung trước phê duyệt, giữ bản sửa ở trạng thái chuẩn bị. Nếu sửa sau khi thao tác đã được gửi, đối soát lần cũ trước và xử lý thay đổi qua luồng sửa hoặc hủy đã duyệt. Dùng khóa cũ cho nội dung khác có thể bị đích từ chối hoặc trả kết quả trước đó.

Lần theo diễn biến của một yêu cầu mẫu

Mở rộng tình huống BMB-1042, lúc 9 giờ nhóm vận hành duyệt tạo một phiếu. Agent ghi trạng thái đang gửi, gọi hệ thống đích và hết thời gian chờ sau 15 giây. Đích đã tạo P-071 nhưng chỉ mục tra cứu mẫu cập nhật chậm 30 giây. Lần tra đầu không ra kết quả. Thao tác giữ trạng thái chưa xác định và được đưa vào lượt tra tiếp theo. Khi chỉ mục hiện P-071, agent lưu mã phiếu và trả kết quả cho người yêu cầu.

Nếu cấu hình mẫu cho phép tối đa ba lần tra trong hai phút, khi hết ngân sách vẫn chưa thấy phiếu thì chuyển cho người đối soát. Mốc đó là thời điểm dừng tự động, chưa phải bằng chứng giao dịch thất bại. Biên bản đối soát ghi người kiểm tra, mã thao tác và căn cứ quyết định tiếp tục hay dừng. Nếu đích xác nhận chưa ghi và bảo đảm cùng khóa chống lặp, có thể gửi lại theo quy tắc đã chốt.

Xử lý phản hồi bất thường và các tác vụ đồng thời

Khi đích trả mã đã tồn tại, kiểm tra mã đó liên hệ với đúng thao tác và nội dung đã duyệt. Nếu thấy hai phiếu cùng tham chiếu, giữ trạng thái cần xử lý và chuyển người có quyền xác nhận phiếu nào phải giữ. Không tự hủy vì cả hai có thể đã được luân chuyển. Cũng cần phân biệt lỗi nhập liệu được trả rõ trước khi xử lý với mất kết nối sau lúc gửi. Lỗi nhập liệu có thể yêu cầu người dùng sửa nội dung, còn mất phản hồi cần tra kết quả trước.

Khi người dùng bấm lại trong lúc tác vụ vẫn chờ hoặc khi hàng đợi giao cùng công việc cho hai tiến trình, cả hai phải tra cùng bản ghi thao tác. Ràng buộc lưu một bản ghi cho mỗi mã và cập nhật trạng thái có điều kiện giúp tránh hai tiến trình cùng nhận quyền gửi. Nếu tiến trình dừng sau khi đích ghi nhưng trước khi lưu kết quả, tiến trình kế tiếp phải đối soát thay vì mặc định rằng chưa ai gửi. Giữ kiểm soát tại đích khi đích hỗ trợ, vì trạng thái cục bộ có thể chưa phản ánh kết quả thật.

Nghiệm thu theo số phiếu và chất lượng thông báo

Dùng dữ liệu mẫu để thử gửi lặp khi đích nhận trước mất phản hồi, timeout trước khi đích nhận, chỉ mục chậm và cùng khóa đi với nội dung khác. So số yêu cầu gửi, số thao tác nghiệp vụ và số phiếu có hiệu lực. Trường hợp P-071 cần kết thúc với đúng một phiếu được xác nhận. Với tình huống không kiểm chứng được, màn hình phải hiện đang đối soát và giữ liên kết tới lần gửi trước.

Giữ thời điểm, mã thao tác, trạng thái và mã phiếu trong nhật ký, tránh ghi nội dung nhạy cảm vượt nhu cầu kiểm tra. Đội vận hành có thể theo dõi tuổi của các yêu cầu chưa xác định để biết bản ghi nào cần can thiệp và so tỷ lệ timeout theo hệ thống đích. Nếu nhiều việc chờ ở cùng một nguồn, kiểm tra chất lượng tích hợp trước khi tăng số lần thử hoặc nới thời gian chờ.

Đọc thêm Khi AI Agent trả lời sai, thiếu dữ liệu hoặc timeout: Xử lý thế nào?.

Xem phạm vi triển khai và tình huống minh họa trên trang BMB Agent Studio.