--- title: "Kiểm tra sức khoẻ tài khoản chỉ đọc" locale: vi url: https://tlg.builera.app/docs/agent-playbooks/check-accounts verified: 2026-10-24 app_version: "2.0" --- # 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.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`](https://tlg.builera.app/docs/reference/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`](https://tlg.builera.app/docs/reference/rest/accounts.get). 4. Nếu được cấp quyền, đọc [`stats.health`](https://tlg.builera.app/docs/reference/rest/stats.health) bằng `tools_run`. 5. Nếu cần điều tra, đọc [`alerts.list`](https://tlg.builera.app/docs/reference/rest/alerts.list) bằng `tools_run`. 6. Đọc [`audit.list`](https://tlg.builera.app/docs/reference/rest/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. > [!IMPORTANT] > Điểm dừng — hỏi người > > Nếu phát hiện cần đăng nhập lại, thay proxy, thay máy hoặc bật lại tài khoản, dừng ở báo cáo. Xin quyết định riêng trước khi chuyển sang thao tác ghi. ## 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](https://tlg.builera.app/docs/concepts/safety-states) và [quản lý tài khoản](https://tlg.builera.app/docs/guides/accounts-manage).