Khái niệm
Xác nhận trước thao tác nguy hiểm
Hiểu cách ứng dụng và agent xin xác nhận trước các thao tác nguy hiểm hoặc không thể hoàn tác.
Xác nhận giúp bạn dừng lại trước thao tác có rủi ro. Nó không thay thế quyền truy cập, phạm vi tài khoản hoặc cổng an toàn. Một yêu cầu đã được xác nhận vẫn có thể bị từ chối vì thiếu quyền hay điều kiện chưa đạt.
Những loại rủi ro
Mỗi thao tác có mức rủi ro: đọc (read), ghi (write) hoặc nguy hiểm (dangerous). Một số thao tác ghi trở thành nguy hiểm tuỳ dữ liệu bạn gửi.
| Ví dụ | Vì sao cần chú ý |
|---|---|
messages.delete |
Xoá tin |
conversations.clear_history |
Xoá lịch sử hội thoại |
accounts.logout |
Đăng xuất phiên đang dùng |
accounts.kill_session |
Huỷ một phiên Telegram |
groups.delete_topic |
Xoá chủ đề và nội dung trong đó |
groups.delete_chat |
Xoá nhóm hoặc kênh cho mọi người |
jobs.redrive |
Có thể thực hiện lại một tác động |
accounts.update_settings với limitMode: free |
Bỏ các bảo vệ mềm của An toàn |
Đây là ví dụ, không phải danh sách đầy đủ. Trang tham chiếu REST của từng thao tác ghi rõ mức rủi ro và việc có cần xác nhận hay không.
Agent phải hỏi người dùng thế nào?
REST và MCP dùng cùng cơ chế. Khi nhận 409 confirmation_required, kết quả có summary (mô tả việc sắp làm) và confirm_token.
Agent phải:
- Dừng lại.
- Đưa nguyên ý nghĩa của
summarycho bạn. - Chờ bạn đồng ý với đúng hành động và phạm vi đó.
- Gọi lại với đúng dữ liệu cũ, thêm
confirm_token.
Token có hiệu lực 10 phút, dùng một lần và gắn với đúng yêu cầu đó. Đổi người nhận, tài khoản hoặc nội dung thì token cũ không dùng được. Việc bạn giao một mục tiêu chung không có nghĩa là đồng ý với mọi hành động nguy hiểm về sau.
validate_only: true giúp kiểm tra yêu cầu mà chưa thực hiện tác động.
Tên tool MCP là mã thao tác với dấu chấm đổi thành gạch dưới; ví dụ groups.delete_chat tương ứng groups_delete_chat. Tool có sẵn hay không còn tuỳ hồ sơ kết nối và phạm vi quyền.
Xoá nhóm hoặc kênh
Trong hộp thoại xoá, bạn phải gõ đúng tên đang hiển thị. Nút xoá chỉ bật khi tên nhập khớp. Khoảng trắng đầu cuối được bỏ qua, nhưng dấu và chữ hoa/thường phải đúng.
Chuyển quyền chủ và mật khẩu hai lớp
Chuyển quyền chủ chỉ người làm được, trong ứng dụng; kết nối AI không có thao tác này.
Bạn nhập mật khẩu hai lớp cho đúng lần chuyển đó. Mật khẩu được mã hoá, chỉ giao cho máy chạy nhận việc, rồi bị xoá ngay — gõ một lần, dùng một lần. Không đưa mật khẩu vào tin nhắn cho agent, nhật ký hay ví dụ API.