01
Ba trạng thái, không ép kết quả chưa rõ thành thất bại
Fixture dự kiến policy-update-synthetic-v1 có bản ghi REC-017 trong records-sandbox. Chính sách dự kiến POL-REVIEW-04@v3 hiện hành yêu cầu có người phụ trách và duyệt hợp lệ trước khi ghi; v2 là bản cũ. Sau khi đủ bằng chứng, quyền và duyệt, operator-demo thuộc team-demo được phép đề xuất chuyển trạng thái từ draft sang ready_for_review. Trong một ca tổng hợp, bản ghi bắt đầu ở phiên bản 7.
Worker gửi lệnh. Dịch vụ đích đã cập nhật lên phiên bản 8 nhưng phản hồi mất trên đường về. Worker chỉ thấy timeout. Nếu coi timeout là “chưa ghi” và gửi một lệnh mới, hệ thống có thể ghi thêm sự kiện, thông báo hoặc phiên bản, dù trường trạng thái vẫn có cùng giá trị.
Vì vậy, quan sát từ phía gọi được phân thành ba kết quả:
| Trạng thái đề xuất | Bằng chứng cần có | Hành động tiếp theo |
|---|---|---|
CONFIRMED | Biên nhận hoặc kết quả tra cứu có thẩm quyền gắn đúng ý định, nội dung và bản ghi | Ghi nhận thành công; không tạo ý định ghi mới |
REJECTED | Dịch vụ xác nhận yêu cầu bị từ chối và không áp dụng, theo hợp đồng lỗi cụ thể | Sửa điều kiện hoặc xin quyết định mới; không thử lại mù |
UNKNOWN | Timeout, mất kết nối hoặc phản hồi không đủ phân xử tác động | Giữ nguyên danh tính ý định; đối soát hoặc gửi lại theo hợp đồng chống trùng còn hiệu lực |
Một mã HTTP đơn lẻ không luôn đủ phân loại. Chẳng hạn lỗi phía máy chủ có thể xảy ra sau khi đã ghi; một mã xung đột có thể chỉ thao tác đang xử lý, hoặc có thể là nội dung không khớp. Phải đọc loại lỗi và hợp đồng của đúng endpoint. Hủy chờ ở phía agent cũng không hủy được tác động đã xảy ra tại đích.
02
Chống trùng phải nằm ở nơi tác động xảy ra
So ba thiết kế trong môi trường tổng hợp, không gửi lệnh phá lỗi tới dịch vụ thật.
| Thiết kế đề xuất | Bảo vệ được gì? | Khoảng hở phải giữ trong phép thử |
|---|---|---|
| Gửi lại sau timeout, mỗi lần một khóa mới | Có thể vượt lỗi kết nối tạm thời | Dịch vụ đích nhìn thấy nhiều ý định; có thể tạo nhiều tác động |
| Khóa ổn định và sổ trạng thái phía agent | Giúp nhớ ý định qua lần khởi động lại, theo dõi và phối hợp worker | Không nguyên tử với lệnh ghi ở dịch vụ khác; đích có thể đã ghi trước khi sổ được cập nhật |
| Khóa ổn định và chống trùng nguyên tử tại đích | Đích nhận ra lần gửi lại và phân xử cạnh tranh trong phạm vi hợp đồng | Còn phụ thuộc nội dung, phạm vi khóa, thời hạn lưu, giao dịch và các tác động ngoài giao dịch |
AWS mô tả yêu cầu lưu token chống trùng và các thay đổi của thao tác theo tính nguyên tử: không để xảy ra việc đã đổi dữ liệu nhưng chưa lưu token, hoặc ngược lại. Đây là lý do sổ của agent không tự bảo vệ một dịch vụ ghi từ xa. AWS Builders’ Library — Making retries safe with idempotent APIs
Với records-sandbox, hợp đồng đề xuất như sau:
- Runtime tạo
operation_keycùng payload chuẩn hóa cho một ý định chưa duyệt, cố định và lưu bền vững. Sau đó tính digest của ý định, bao gồm khóa, đích, bản ghi, thay đổi và phiên bản kỳ vọng; xin duyệt đúng digest ấy rồi lưu tham chiếu duyệt trước khi gửi. Mọi lần gửi lại giữ nguyên khóa, nội dung và phiên bản đã được duyệt; không tạo khóa sau duyệt. - Dịch vụ đích xác thực người gọi và phạm vi thao tác. Nó phân xử theo phạm vi khóa đã quy định, chẳng hạn nhóm sở hữu + loại thao tác + khóa; không coi khóa là bằng chứng có quyền.
- Nếu khóa đã có với cùng nội dung chuẩn hóa, trả trạng thái hoặc biên nhận của chính ý định đó. Nếu nội dung khác, từ chối vì xung đột ý định. Không lấy “cùng bản ghi” làm định nghĩa “cùng ý định”.
- Với ý định mới, kiểm điều kiện phiên bản rồi ghi trạng thái mới và kết quả chống trùng trong cùng giao dịch tại đích. Nếu bản ghi đã đổi, trả xung đột để đọc và đánh giá lại.
- Dữ liệu đối soát gắn khóa với bản ghi, hash nội dung, kết quả và phiên bản sau ghi. Sau mất phản hồi, runtime tra theo khóa hoặc gửi lại đúng yêu cầu nếu hợp đồng cho phép.
Việc tra khóa cũ phải phân biệt với việc chấp nhận ý định mới. Một lần gửi lại của thao tác đã thành công ở phiên bản 7 không nên bị hiểu thành lệnh mới sai phiên bản chỉ vì bản ghi hiện là phiên bản 8. Ngược lại, một ý định khác dùng điều kiện phiên bản 7 phải bị chặn khi dữ liệu đã thay đổi.
Nếu dùng PostgreSQL cho dịch vụ tổng hợp, ràng buộc duy nhất và ON CONFLICT có thể là thành phần phân xử cạnh tranh. PostgreSQL bảo đảm kết quả insert/update nguyên tử cho ON CONFLICT DO UPDATE trong điều kiện tài liệu nêu; điều đó không tự bao phủ một HTTP call hoặc tác động nằm ngoài giao dịch dữ liệu. PostgreSQL — INSERT
03
Đếm tác động tại đích, không đếm phản hồi thành công
Một ý định có thể được gửi nhiều lần nhưng chỉ được áp dụng một lần theo hợp đồng. Ngược lại, một phản hồi thành công phía agent chưa đủ chứng minh không có ghi trùng. Phép thử phải xem trạng thái và nhật ký tại đích, không chỉ trace của worker.
| Phép đo đề xuất | Cách kiểm | Tiêu chí chấp nhận trong bộ tổng hợp |
|---|---|---|
| Số lần áp dụng cùng ý định | Bộ chấm dùng fixture_intent_id để nối mọi operation_key phát sinh với chuyển trạng thái, phiên bản và sự kiện ở đích | Ý định hợp lệ được áp dụng một lần; đổi khóa giữa các lần gửi không được che khuất tác động trùng |
| Ý định bị từ chối | So điều kiện quyền, duyệt, payload và phiên bản với thay đổi thực tế | Không có thay đổi do ý định không đủ điều kiện |
| Báo thành công sai | Đối chiếu trạng thái agent báo với biên nhận và trạng thái đích | Không báo CONFIRMED khi chưa có bằng chứng tương ứng |
| Kết quả chưa rõ | Đếm ca còn UNKNOWN, lý do và thời gian chờ đối soát | Mỗi ca phải được giải quyết hoặc bàn giao rõ; không đổi thành thất bại/thành công cho đẹp số |
| Khôi phục sau khởi động lại | Dừng worker ở từng điểm rồi đọc lại sổ ý định và đích | Giữ được khóa và nội dung cũ; không sinh một ý định mới để tiếp tục ý định chưa rõ |
| Cạnh tranh và cập nhật mới hơn | Hai worker cùng khóa; hai khóa khác nhau cùng phiên bản kỳ vọng | Cùng ý định không trùng; ý định cũ không ghi đè dữ liệu mới hơn |
| Chi phí phục hồi | Số lần gửi, tra cứu, thời gian phục hồi và tải tới đích | Công bố sau khi kiểm đúng; giới hạn số lần và thời gian phải chốt trước chạy |
Toàn bộ các ô kết quả hiện là CHƯA ĐO. “Một lần áp dụng” là điều kiện muốn kiểm, không phải số liệu đã đạt. Khi công bố cần ghi số ca, số lần lặp, điểm gây lỗi và phần nào của đích được quan sát. fixture_intent_id thuộc bộ chấm tổng hợp, không tự cấp một cơ chế chống trùng cho baseline: bộ chấm cần biết hai khóa khác nhau có cùng ý định, nhưng dịch vụ đích ở baseline không được âm thầm dùng nhãn này để gộp chúng.
Backoff và jitter giúp phân tán lần gửi lại; chúng không tạo ra chống trùng. Khóa worker giúp giảm cạnh tranh; nó cũng không đủ nếu một worker hết hạn thuê vẫn còn lệnh đang đến đích. Nếu dùng fencing token để chặn worker cũ, chính dịch vụ đích phải kiểm token đó, không chỉ lưu nó trong log phía agent.
04
Những ranh giới làm hợp đồng chống trùng mất tác dụng
| Ca sai tổng hợp | Cách lỗi xuất hiện | Hành vi mong đợi |
|---|---|---|
| Ghi xong, mất phản hồi | Agent không biết đích đã commit | Giữ UNKNOWN; lấy lại biên nhận hoặc gửi lại cùng khóa trong hợp đồng còn hiệu lực |
| Sổ agent chưa lưu thành công thì worker dừng | Sổ báo đang gửi dù đích đã đổi | Tiếp tục từ cùng ý định; không dựa riêng trạng thái sổ để kết luận chưa ghi |
| Hai worker cùng khóa | Cả hai cùng đọc thấy “chưa có” rồi gửi | Đích phân xử nguyên tử; không dùng chuỗi “đọc trước rồi ghi” thiếu ràng buộc |
| Cùng khóa, khác nội dung | Mô hình tạo lại payload sau lỗi | Từ chối nội dung không khớp; giữ bản đã được duyệt để đối soát |
| Khóa hết thời hạn lưu | Đích đã quên lần xử lý đầu | Không giả định gửi lại vẫn được bảo vệ; đối soát đủ mạnh hoặc bàn giao |
| Bản ghi đã có thay đổi mới | Ý định cũ đến muộn với phiên bản 7 | Chặn cập nhật có điều kiện không còn đúng; không tự ghi đè hoặc đổi phiên bản kỳ vọng |
| Đọc bản sao chưa cập nhật | Tra cứu chưa thấy khóa dù đích đã ghi | Không coi “không thấy” là bằng chứng chưa xử lý; dùng kênh đối soát phù hợp |
Không có một TTL dùng chung cho mọi API. Ví dụ tài liệu Stripe phân biệt hành vi idempotency của API v1 và v2; với v1, khóa có thể bị loại sau khi đã lưu ít nhất 24 giờ, cùng khóa sau khi bị loại được xử lý như yêu cầu mới, và tham số không khớp bị từ chối. Cần kiểm đúng endpoint và phiên bản đang tích hợp, không sao chép con số này thành cấu hình mặc định cho records-sandbox. Stripe — Idempotent requests
Nếu một thao tác vừa đổi bản ghi vừa gửi thông báo sang hệ thống khác, phải xác định riêng tác động nào nằm trong giao dịch. Ghi bản ghi và một outbox trong cùng giao dịch có thể giữ ý định gửi, nhưng việc chuyển sự kiện và xử lý phía nhận còn cần hợp đồng riêng. Phạm vi fixture đầu tiên chỉ có bản ghi và nhật ký trong dịch vụ tổng hợp; không gửi thông báo ra ngoài.
05
Ba ca gây lỗi có chủ đích
Mỗi ca có snapshot và case_id riêng; reset bản ghi, kho chống trùng và sổ ý định giữa các ca. Các lần gửi lại bên trong cùng một ca phải giữ lịch sử và khóa cũ, không reset giữa chừng. Môi trường dịch vụ và worker độc lập cho nghiên cứu này chưa được thiết lập. Console phía trên đã kiểm trường hợp mất phản hồi và gửi lại trên đích bộ nhớ phiên.
Đích ghi xong, worker không nhận được trả lời.
Ca retry-commit-response-lost: gây mất phản hồi ngay sau điểm commit. Khởi động lại worker rồi tiếp tục cùng ý định. Đầu ra mong đợi: nhận lại đúng kết quả đã có, bản ghi chuyển từ phiên bản 7 sang 8 một lần, không có tác động thứ hai trong phạm vi hợp đồng.
Hai worker cùng nhận một ý định.
Ca retry-concurrent-workers: cho hai worker gửi cùng khóa và payload đồng thời. Sau đó thêm một yêu cầu dùng khóa cũ nhưng payload khác, và một ý định mới còn dùng phiên bản kỳ vọng cũ. Đầu ra mong đợi: lần gửi trùng được quy về cùng thao tác; payload khác bị từ chối; cập nhật dựa trên phiên bản cũ không ghi đè.
Yêu cầu đến muộn sau thời hạn chống trùng.
Ca retry-expired-key-stale-read: mô phỏng khóa không còn trong kho chống trùng, trong khi một kênh đọc cập nhật chậm chưa phản ánh tác động cũ. Đầu ra mong đợi: không tự tạo khóa mới hoặc khẳng định chưa ghi; dùng nguồn đối soát có thẩm quyền hoặc giữ UNKNOWN và bàn giao.
06
Lưu ý định đã duyệt, không nhờ mô hình nhớ lần gửi trước
Thứ tự đề xuất là tạo khóa và payload → chuẩn hóa, cố định và lưu bền → tính digest → duyệt digest → lưu tham chiếu duyệt → gửi nguyên ý định. Digest bao phủ operation_key và các trường quyết định tác động; không đưa approval_ref được cấp sau đó hoặc dữ liệu từng lần gửi như thời điểm retry vào phần được băm, để tránh vòng phụ thuộc và thay đổi digest khi gửi lại.
Payload đã duyệt cần được cố định. Model có thể giải thích hoặc đề xuất sửa một ý định; nó không được âm thầm đổi nội dung dưới khóa cũ. Nếu phải tạo ý định mới, cần giải quyết quan hệ với ý định trước và kiểm lại quyền, duyệt, bằng chứng cùng phiên bản bản ghi. Khóa, payload hoặc phiên bản kỳ vọng thay đổi thì digest cũ không còn cấp quyền cho ý định mới.
{
"status": "PROPOSED_NOT_EXECUTED",
"fixture": "policy-update-synthetic-v1",
"case_id": "retry-commit-response-lost",
"fixture_snapshot": null,
"reset_between_cases_only": true,
"target": "records-sandbox",
"actor": "operator-demo",
"group": "team-demo",
"operation_key": "demo-intent-REC-017-review-001",
"record_id": "REC-017",
"expected_record_version": 7,
"change": {
"status": "ready_for_review"
},
"approval_ref": null,
"approved_payload_hash": null,
"target_idempotency_contract": null,
"on_timeout": "UNKNOWN",
"observed_target_receipt": null,
"measurements": null
}Đây là ý định tổng hợp dự kiến, chưa phải yêu cầu đủ điều kiện gửi: các trường duyệt, hash và hợp đồng đích còn trống. Dịch vụ ngoài và worker của nghiên cứu chưa được triển khai; bộ kiểm cục bộ phía trên đã có cơ chế gây mất phản hồi sau ghi. Khóa mẫu để dễ đọc; triển khai sau này cần quy tắc sinh khóa tránh va chạm, không đưa dữ liệu nhạy cảm vào khóa.
Trước thử nghiệm phải khai báo phạm vi khóa, cách chuẩn hóa payload, TTL và cửa sổ gửi lại, hành vi khi cùng khóa đang xử lý, cách tra cứu kết quả, tính nhất quán của kênh đọc và phạm vi giao dịch. Chưa biết một mục thì giữ là chưa biết, không suy từ việc API có header mang tên Idempotency-Key.
Ba mục tham khảo bên dưới trình bày đặc tả nghiên cứu tác nhân AI, chưa được thực thi với mô hình. Không gian kiểm tra phía trên chạy riêng các quy tắc truy hồi, quyền ghi và khôi phục ngay trong trình duyệt; mở tài liệu không gọi mô hình hoặc API ngoài.
07
Không hứa “đúng một lần” cho cả chuỗi chỉ bằng một khóa
Hồ sơ hiện đề xuất các điều kiện để thử lại một thao tác cụ thể; chưa xác minh một hệ thống đích nào đáp ứng chúng. Chống trùng có phạm vi: endpoint, danh tính/nhóm, nội dung, thời hạn và tác động được bao phủ. Không mở rộng bảo đảm đó sang mọi công cụ của tác nhân hoặc mọi hệ thống phía sau.
Nếu đích không hỗ trợ chống trùng, cập nhật có điều kiện hoặc đối soát đáng tin cậy, lựa chọn đề xuất là dừng ghi khi kết quả còn chưa rõ và bàn giao thông tin đủ để xử lý. Dừng có kiểm soát có thể là kết quả đúng; “agent tự chạy tiếp” không phải tiêu chí cao hơn tính toàn vẹn của bản ghi.
Chỉ chuyển hồ sơ sang kết luận thực nghiệm khi đã gây lỗi trong môi trường tổng hợp, kiểm tác động tại đích và công bố phần còn chưa phân xử. Muốn xem bằng chứng trước khi hình thành ý định ghi, đọc hồ sơ truy hồi; muốn xem ai chịu trách nhiệm hợp nhất đề xuất, đọc hồ sơ điều phối.
Nguồn và phạm vi sử dụng
Đọc ngày 16/11/2026. Ba nguồn hỗ trợ các ranh giới kỹ thuật; không nguồn nào xác nhận fixture hoặc website này đã hoạt động.
- AWS Builders’ Library — Making retries safe with idempotent APIs. Phạm vi đọc: client request ID, lưu token cùng thay đổi theo tính nguyên tử, yêu cầu đến muộn và cùng ID nhưng khác ý định. Giao thức của
records-sandboxlà đề xuất, không phải dịch vụ AWS đang được dùng. - Stripe API — Idempotent requests. Phạm vi đọc: khóa, tham số, vòng đời khóa và khác biệt API v1/v2. Ví dụ dùng để cho thấy hợp đồng tùy dịch vụ/phiên bản; không đề xuất tích hợp thanh toán.
- PostgreSQL — INSERT, mục ON CONFLICT. Phạm vi đọc: phân xử xung đột duy nhất và bảo đảm nguyên tử insert/update. Không diễn giải thành giao dịch nguyên tử xuyên dịch vụ.