
Tin doanh nghiệp
Đăng ngày
Idempotency key giúp agent không tạo cùng một thay đổi hai lần
Có. Mọi công cụ của agent có thể tạo thay đổi như lập phiếu, gửi yêu cầu, ghi nhận thanh toán hoặc cập nhật trạng thái nên nhận một idempotency key ổn định. Khóa này giúp hệ thống nhận ra hai lần gọi thực chất thuộc cùng một ý định nghiệp vụ và trả lại kết quả đã có thay vì thực hiện lần nữa. Đây là lớp bảo vệ quan trọng khi agent, mạng hoặc công cụ gặp timeout, bởi không nhận được phản hồi không có nghĩa hành động chưa thành công.
Tình huống nghiệp vụ bằng dữ liệu mẫu
Một agent tạo yêu cầu mua sắm từ hội thoại đã được người dùng xác nhận. Dữ liệu mẫu gồm 1.200 phiên trong một tuần, trong đó 46 lần công cụ trả lời chậm quá ngưỡng 10 giây. Agent thử lại 31 lần. Nếu mỗi lần thử tạo một yêu cầu mới, hệ thống có thể sinh 31 phiếu trùng, tổng giá trị minh họa 428 triệu đồng. Con số này chỉ dùng để thiết kế kiểm soát, không phải kết quả của khách hàng.
Trong một phiên cụ thể, người dùng phê duyệt đề nghị mua 20 thiết bị. Lần gọi đầu đã tạo phiếu PR-1048 nhưng phản hồi bị mất. Lần gọi thứ hai mang cùng khóa phải nhận lại mã PR-1048 và trạng thái đã tạo. Nếu agent tạo khóa mới vì đổi câu diễn đạt, công cụ sẽ hiểu đó là ý định mới và có thể sinh phiếu thứ hai. Vì vậy khóa phải gắn với hành động đã được xác nhận, không gắn với chuỗi văn bản của từng lần gọi.
Chọn phạm vi và thành phần của khóa
Khóa nên duy nhất trong phạm vi tenant, công cụ và loại hành động. Một chuỗi ngẫu nhiên đủ mạnh do BMB Agent Studio tạo khi đóng gói lệnh là cách đơn giản. Bản ghi đi kèm cần lưu tenant, người khởi tạo, action type, phiên bản tham số chuẩn hóa, thời điểm tạo và thời hạn giữ kết quả. Công cụ không nên dùng một số thứ tự ngắn do agent tự tăng vì nhiều phiên có thể chạy đồng thời.
Cùng một khóa chỉ hợp lệ khi payload nghiệp vụ giống nhau. Hệ thống tính dấu vân tay từ các trường có ý nghĩa sau khi chuẩn hóa, ví dụ mã đơn vị, danh mục hàng, số lượng, đơn giá và người duyệt. Các trường quan sát như trace ID hoặc thời điểm thử lại không nên làm thay đổi dấu vân tay. Khi khóa cũ đi kèm payload khác, công cụ phải từ chối rõ ràng thay vì dùng kết quả trước hoặc thực hiện yêu cầu mới.
Thời hạn của khóa cần dài hơn cửa sổ thử lại và thời gian bất định của hệ thống phụ thuộc. Nếu agent có thể khôi phục phiên sau 24 giờ, giữ khóa 15 phút là không đủ. Với nghiệp vụ cần kiểm toán, có thể giữ ánh xạ lâu hơn dữ liệu tạm, nhưng phải áp dụng chính sách lưu trữ phù hợp và không đưa dữ liệu nhạy cảm trực tiếp vào chuỗi khóa.
Quy trình xử lý tại công cụ
Khi nhận lệnh, công cụ xác thực quyền và cấu trúc trước, sau đó thử tạo bản ghi khóa ở kho nhất quán bằng thao tác chỉ thành công một lần. Bản ghi mới có trạng thái đang xử lý. Nếu khóa đã tồn tại, công cụ so sánh dấu vân tay. Payload khác bị trả lỗi xung đột; payload giống được định tuyến theo trạng thái hiện tại.
Nếu trạng thái đã hoàn thành, công cụ trả lại cùng mã đối tượng và kết quả nghiệp vụ. Nếu đang xử lý, nó có thể trả trạng thái chờ cùng địa chỉ kiểm tra, thay vì chạy song song. Nếu lần trước thất bại trước khi có thay đổi, hệ thống cho phép tiếp tục theo quy tắc đã định. Trường hợp không xác định, ví dụ dịch vụ phụ thuộc có thể đã ghi dữ liệu, phải chuyển sang đối soát chứ không tự động phát lại.
Việc ghi kết quả nghiệp vụ và chuyển khóa sang hoàn thành cần nằm trong cùng giao dịch khi có thể. Nếu không thể vì gọi hệ thống ngoài, công cụ phải lưu mã tương quan và có bước tra cứu trạng thái từ hệ thống đích. BMB Agent Studio nên hiển thị cho người vận hành khóa, số lần thử, kết quả từng lần và đối tượng cuối cùng mà không làm lộ bí mật trong payload.
Quan hệ giữa idempotency key và retry
Retry chỉ an toàn khi hành động có cơ chế chống lặp hoặc có cách xác minh trạng thái. Agent cần tái sử dụng đúng khóa cho mọi lần thử của cùng một quyết định. Khi người dùng sửa số lượng, hủy rồi tạo lại hoặc phê duyệt một yêu cầu mới, Agent Studio phải tạo khóa mới và liên kết với yêu cầu trước để giữ lịch sử.
Ngoại lệ phải thiết kế trước
Một hành động có nhiều bước, như tạo phiếu rồi gửi thông báo, cần khóa ở cấp hành động và khóa con cho từng hiệu ứng. Nếu tạo phiếu thành công nhưng thông báo lỗi, lần thử lại chỉ nên gửi lại thông báo, không tạo phiếu mới. Với xử lý theo lô, khóa của cả lô không thay thế khóa từng phần tử; hệ thống cần trả rõ mục nào thành công, mục nào chờ và mục nào thất bại.
Hai yêu cầu giống hệt nhưng do hai người phê duyệt độc lập có thể là hai ý định khác nhau. Ngược lại, một người bấm nút hai lần thường là cùng ý định. Quy tắc tạo khóa phải dựa trên sự kiện xác nhận và phạm vi nghiệp vụ, không chỉ so sánh payload.
Tiêu chí kiểm tra trước khi vận hành
Nhóm kiểm thử nên gửi đồng thời mười yêu cầu cùng khóa và xác nhận chỉ có một đối tượng được tạo. Cần thử cùng khóa với payload khác, timeout sau khi hệ thống đích đã ghi, lỗi trước khi ghi, phiên được khôi phục sau nhiều giờ và thao tác nhiều bước lỗi ở giữa. Kết quả đạt khi mọi lần gọi cùng ý định quy về một mã nghiệp vụ, lịch sử không bị ghi đè và người vận hành xác định được trạng thái cuối.
Với bộ dữ liệu mẫu 1.200 phiên, tổng số đối tượng duy nhất phải bằng số ý định đã xác nhận, không bằng số lần gọi công cụ. Báo cáo phải tách số lần thử lại, số khóa xung đột và số trường hợp chưa thể kết luận. Đây là bằng chứng thiết thực hơn một tỷ lệ thành công chung.
Câu hỏi thường gặp
Có thể xóa khóa ngay khi hành động hoàn thành không?
Không. Phản hồi có thể đến muộn hoặc phiên có thể được khôi phục. Thời hạn giữ khóa phải bao phủ toàn bộ cửa sổ phát lại hợp lý.