Tài liệu

Sổ tay cho AI agent

Kiểm tra sức khoẻ tài khoản chỉ đọc

Thu thập trạng thái tài khoản trong phạm vi kết nối và báo cáo điểm cần người xử lý mà không thay đổi cấu hình.

Xem Markdown

Mục tiêu

Bạn kiểm tra các tài khoản mà kết nối được phép xem và lập báo cáo có bằng chứng. Playbook này chỉ đọc: không đăng nhập, đổi proxy, bật tài khoản hay chạy thử bằng cách gửi tin.

Quyền cần

  • accounts.read để xem tài khoản.
  • stats.read nếu cần thống kê sức khoẻ hoặc hạn mức.
  • audit.read nếu cần đối chiếu cảnh báo và nhật ký.

Quyền đọc hạ tầng không tự đi kèm quyền đọc tài khoản. Chỉ dùng các thao tác mà kết nối hiện tại thực sự được phép gọi.

Hỏi người trước khi

Xác định phạm vi: kiểm tra tài khoản nào, cần báo cáo hiện trạng hay điều tra một sự cố cụ thể, và ai nhận báo cáo.

Nếu người yêu cầu “sửa luôn”, tách việc sửa khỏi lần kiểm tra này. Một yêu cầu kiểm tra không phải đồng ý đăng nhập lại, thay máy hoặc thay proxy.

Kiểm trước

Gọi whoami để xác nhận workspace, kết nối và tài khoản được cấp. Dùng tools_search tìm thao tác cần thiết và tools_describe đọc schema trước khi gọi.

Danh sách trả về chỉ phản ánh phạm vi bạn nhìn thấy. Không kết luận workspace không còn tài khoản khác nếu kết nối đang bị giới hạn tài khoản.

Các bước

  1. Gọi accounts_list, tương ứng REST accounts.list.
  2. Theo phân trang cho đến khi đủ phạm vi đã thoả thuận.
  3. Gọi accounts_get cho từng tài khoản cần kiểm tra, tương ứng accounts.get.
  4. Nếu được cấp quyền, đọc stats.health bằng tools_run.
  5. Nếu cần điều tra, đọc alerts.list bằng tools_run.
  6. Đọc audit.list khi cần đối chiếu thay đổi gần đây.
  7. Tổng hợp từng tài khoản: dữ liệu đã thấy, điểm bất thường và việc cần người quyết định.

Không biến trạng thái máy hoặc kết nối thành kết luận chắc chắn về phiên Telegram. Nêu riêng các khía cạnh tài khoản, phiên, proxy và máy nếu kết quả trả về phân biệt chúng.

Kiểm sau

Báo cáo phải ghi rõ thời điểm kiểm tra, phạm vi đã xem và các phần không đủ quyền đọc. Phân biệt “không có lỗi được trả về” với “đã kiểm tra đầy đủ”.

Không đưa khoá, phiên đăng nhập hoặc thông tin proxy bí mật vào báo cáo. Có thể dùng tên tài khoản trong môi trường được phép, nhưng tài liệu chia sẻ ra ngoài cần dữ liệu giả hoặc che thông tin.

Khi lỗi

Nếu một tài khoản không còn truy cập được, ghi nhận giới hạn quyền thay vì thử danh tính khác. Nếu dữ liệu đọc thất bại, không suy diễn rằng tài khoản đã hỏng.

Khi gặp giới hạn tần suất, chờ theo phản hồi; không mở thêm kết nối để tiếp tục đọc nhanh hơn.

Điều kiện dừng

Dừng khi đã kiểm đủ phạm vi, người yêu cầu huỷ, kết nối mất quyền hoặc dữ liệu không đủ để kết luận an toàn. Kết quả cuối là báo cáo, không phải một danh sách thay đổi đã tự thực hiện.

Xem thêm trạng thái an toàn và quản lý tài khoản.