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.
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.readnếu cần thống kê sức khoẻ hoặc hạn mức.audit.readnế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
- Gọi
accounts_list, tương ứng RESTaccounts.list. - Theo phân trang cho đến khi đủ phạm vi đã thoả thuận.
- Gọi
accounts_getcho từng tài khoản cần kiểm tra, tương ứngaccounts.get. - Nếu được cấp quyền, đọc
stats.healthbằngtools_run. - Nếu cần điều tra, đọc
alerts.listbằngtools_run. - Đọc
audit.listkhi cần đối chiếu thay đổi gần đây. - 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.