Tài liệu

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.

Xem Markdown

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:

  1. Dừng lại.
  2. Đưa nguyên ý nghĩa của summary cho bạn.
  3. Chờ bạn đồng ý với đúng hành động và phạm vi đó.
  4. 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.

Liên quan