Vận hành agent Core X

Thao tác hiện có

Danh mục discovery của bản đang kết nối là nguồn chuẩn. Các thao tác Core X gồm kiểm tra trước (agent.preflight), console theo hồ sơ (agent.console_get), quyền giữ (sessions.ensure, sessions.agent_attach, sessions.lease_release, operations.get), bàn giao người (sessions.handoff_request, sessions.handoff_resume), danh tính đã đo (profiles.effective_fingerprint, profiles.consistency_report), tạo danh tính (personas.contexts_list, profiles.create_from_context), sai lệch (profiles.drift_list, profiles.drift_accept), nhiễu (profiles.noise_status, profiles.noise_upgrade), chẩn đoán lối ra (profiles.exit_diagnostics), sức khỏe/cấp phát máy (workers.health_get, workers.provision_preview, workers.provision_run) và phân phối lõi (core.freshness_get, workers.core_channel_set). Trang tham chiếu sinh từ cùng hợp đồng đầu vào/đầu ra. Tên MCP đổi dấu chấm thành gạch dưới; CLI dùng browlix call <operation> key=value --json. SDK dùng cùng danh mục, không kết nối dữ liệu riêng.

Giữ quyền cho agent không phải vé CDP. sessions.attach vẫn cấp vé CDP dùng cùng máy; sessions.agent_attach giữ quyền đọc/ghi. Chế độ ghi cần thêm agent.act. Khi thử lại phải gửi cùng idempotency_key đã chọn. Lệnh nâng nhiễu/cài bổ sung dùng command_id. Không tạo khóa thử lại mới sau khi mất phản hồi.

Vân tay đo có thể null: đó là chưa đo, không phải đã áp dụng. Nâng nhiễu cần session.start, hồ sơ đã đóng và expected_epoch; sau đó vẫn cần duyệt sai lệch. Cài bổ sung chỉ xếp hàng thao tác Linux đã đồng ý, không phải đã cài xong.

Kết quả và quyền

Kết quả agent giữ ok, operation_id, state_version, retryable và next. Từ chối có code, remediation_key và outcome; REST có thêm đối tượng error thông thường cho chương trình khách cũ. ACTION_OUTCOME_UNKNOWN trả HTTP 202 và bước tra cứu: đọc operations.get hoặc gửi lại cùng khóa thử lại. Không coi 202 là hoàn tất. SESSION_LEASE_HELD, SESSION_EPOCH_CHANGED, HUMAN_CONTROL_ACTIVE và IDEMPOTENCY_KEY_REUSED là từ chối, không phải lý do thử lại mù quáng. FORBIDDEN và NOT_FOUND giữ ranh giới quyền. Khóa thu hồi bị từ chối ở cấp yêu cầu.

Preflight, bàn giao, đọc sức khỏe máy, sai lệch và chẩn đoán lối ra đã có trong danh mục hiện tại. Có thao tác không chứng minh máy đã hoàn tất công việc. Công cụ snapshot/state trang còn chờ bộ xử lý từ worker; không dùng báo cáo null thay cho quan sát thành công.

Phản hồi

Sau khi dùng công cụ, gửi lỗi, vướng mắc hoặc tài liệu thiếu bằng feedback_submit; theo dõi qua feedback_list, feedback_get và feedback_comment. Kèm correlation ID và bằng chứng đã che bí mật, không gửi token, cookie hay thông tin xác thực. Phản hồi từ agent.

Kiểm tra trước và bàn giao người

agent.preflight cần quyền agent.preflight, không chỉ session.read. Phản hồi thành công vẫn có thể mang ready=false; đọc mọi yếu tố chặn trước khi mở. Số đo trống, thiếu hoặc cũ không chứng minh sẵn sàng. Console chỉ trả hồ sơ được xem, trạng thái quyền giữ, thao tác và các trường ngân sách cho phép; không trả mã băm yêu cầu, định danh bên giữ, nội dung kết quả lưu hay nội dung trang.

Yêu cầu bàn giao và tiếp tục cần command_id, idempotency_key rõ ràng và epoch vừa đọc. Giữ cả hai khóa khi thử lại. PAUSING và RESUME_PENDING là trạng thái chờ, không chứng minh đã giữ quyền. Tra thao tác và console đến khi máy xác nhận có chữ ký. Hiện việc trả quyền cần phiên đăng nhập của người: khóa API bị từ chối với HUMAN_CONTROL_ACTIVE, kể cả khóa của chủ sở hữu. Agent phải nhờ người vận hành tiếp tục trong console; không tự giả xác minh của người.

Danh tính, sai lệch và thay đổi máy

Liệt kê ngữ cảnh mới đã đo rồi dùng ID cho profiles.create_from_context. Dữ liệu kiểm tra ngữ cảnh thuộc không gian làm việc và chưa cũ; không gửi số đo phần cứng tự bịa. Duyệt sai lệch chỉ rõ sự kiện cùng hồ sơ để đường dẫn sai không duyệt nhầm hồ sơ khác. Nâng nhiễu cần hồ sơ đã đóng và epoch dự kiến. Xem trước cấp phát không xếp hàng; chạy cấp phát cần đồng ý rõ ràng. Lệnh đang chờ chỉ nghĩa đã nhận, chưa phải đã cài. Chọn kênh ổn định/beta vẫn qua cổng phát hành lõi.

Quan sát chưa đủ và phục hồi

Vân tay, sức khỏe hoặc chẩn đoán lối ra null nghĩa đọc thành công trạng thái chưa đo, không phải kết quả trình duyệt đã đo. Công cụ snapshot/state trang chưa thuộc bản này đến khi nối bộ xử lý từ worker. Kết quả thao tác chưa rõ vẫn là lỗi: CLI thoát 10, SDK từ chối và có bước tra thao tác. Không dùng khóa mới để lặp việc có thể đã hoàn tất.

Phản hồi chỉ đọc Core X có operation_id=null, không tự tạo biên nhận bền vững. Nếu mất kết nối trước khi nhận ID thao tác, SDK giữ idempotency_key rõ ràng với ACTION_OUTCOME_UNKNOWN. Gửi lại đúng yêu cầu cùng khóa để đối soát, rồi dùng ID thao tác nhận được để tra cứu. Không tự bịa ID hay tạo khóa thử lại mới.