Agent và phiên bản

Bản nháp và bản xuất bản

Mỗi agent có hai trạng thái nội dung:

• Bản nháp (draft): nơi mọi chỉnh sửa diễn ra. Wizard và editor tự lưu nháp — rời màn giữa chừng không mất dữ liệu.
• Bản xuất bản (published): snapshot bất biến đóng băng lúc bấm xuất bản — gồm avatar, giọng, persona, cấu hình LLM, tri thức và guardrail tại thời điểm đó.

Runtime chỉ chạy bản xuất bản. Bản nháp chỉ chạy trong Playground (phiên debug riêng, không phải kênh người dùng cuối).

Con trỏ phiên bản

Agent giữ con trỏ current_published_version_id. Xuất bản một bản mới thì:

• Tạo snapshot mới, bất biến.
• Chuyển con trỏ trong một transaction.
• Phiên đang chạy giữ nguyên bản cũ tới khi kết thúc; phiên mở sau dùng bản mới.

Rollback

Rollback chỉ chuyển con trỏ về một phiên bản đã xuất bản trước đó (đổi trạng thái published ⇄ superseded cùng khoá dòng agent) và ghi audit agent.rollback. Lịch sử phiên bản không bao giờ bị sửa hay xoá — khi cần biết “lúc 10h hôm qua agent nói gì”, đọc snapshot của bản đang chạy.

Tình huống thường gặp

Tình huống	Hành vi hệ thống
Sửa nháp trong lúc phiên đang chạy	Không ảnh hưởng phiên; ảnh hưởng lần xuất bản kế
Xuất bản khi phiên đang chạy	Phiên cũ giữ bản cũ; phiên mới dùng bản mới
Rollback trong lúc có phiên	Phiên đang chạy giữ nguyên; phiên mới dùng bản được rollback
Xuất bản khi nháp trùng bản đã xuất bản	Nút xuất bản khoá (không tạo bản trùng)