Giới hạn và lỗi

Mỗi slot được bao nhiêu lượt, cổng giữ dữ liệu gì, và cổng báo lỗi thì làm gì tiếp. Chưa đăng nhập thì vào /activate.

Hạn mức mỗi slot

Thiết bị3 mỗi slot

Mỗi trình duyệt đăng nhập là một thiết bị; ứng dụng nối qua trình duyệt đó không tính thêm. Đăng nhập ở thiết bị thứ 4 thì thiết bị đăng nhập lâu nhất tự đăng xuất.

Lượt gọi30 mỗi 5 giờ

Và 300 lượt mỗi 7 ngày. Mỗi lần agent gọi một công cụ tính một lượt, kể cả khi công cụ hỏi lại vì thiếu số.

Tri thức20% mỗi 7 ngày

Phần kho tri thức một slot được dùng qua các lượt đo trong 7 ngày.

Bảng số kéo về36 giờ

Số kéo ở /ads dùng được 36 giờ. Hết hạn thì kéo lại hoặc dán số vào chat.

Khoảng ngày90 ngày

Một bảng số chấm tối đa 90 ngày. Dài hơn thì chia ra nhiều lượt.

Liệt kê công cụ không tính lượt. Hết lượt thì cổng báo giờ mở lại, xem Lỗi hết lượt.

Lỗi đăng nhập và key

Cổng báo	Nghĩa là	Làm gì
401 no bearer token	Ứng dụng chưa đăng nhập.	Chạy bước đăng nhập (Authenticate, Login, Connect) hoặc thêm header Authorization.
401 thiết bị không tồn tại	Ứng dụng này đã bị gỡ khỏi slot.	Đăng nhập lại trong ứng dụng.
401 key không khớp slot	Key gõ nhầm, hoặc đã tạo key mới nên key cũ ngừng.	Tạo key mới ở trang tài khoản. Mật khẩu đăng nhập không phải key.
email hoặc mật khẩu không đúng · tạm khoá 15 phút	Gõ sai email hay mật khẩu, hoặc đã sai 5 lần liền.	Bấm «Quên mật khẩu?» để đặt lại qua email. Bị khoá thì đợi 15 phút.
401 slot đã khoá · gói hết hạn	Slot bị khoá hoặc hết hạn dùng.	Liên hệ Admatrix hoặc gia hạn gói.

Lỗi hết lượt

Cổng báo	Nghĩa là	Làm gì
403 đủ 3 thiết bị	Một máy dùng key xin chỗ khi tài khoản đã đủ 3 thiết bị.	Gỡ thiết bị không dùng ở trang tài khoản rồi gọi lại.
429 hết 30 lượt trong 5 giờ	Đã dùng hết lượt. Cổng ghi kèm giờ mở lại (giờ UTC, Việt Nam cộng 7).	Chờ tới giờ mở lại. Mức 300 lượt mỗi 7 ngày báo tương tự.
429 hết hạn mức tri thức	Slot đã dùng quá 20% kho tri thức trong 7 ngày.	Chờ vài ngày, hoặc liên hệ Admatrix.

Lỗi công cụ và số

Cổng báo	Nghĩa là	Làm gì
403 tool không được phép	Agent gọi công cụ ghi, ví dụ tạo chiến dịch.	Cổng chỉ đọc. Tự thao tác trên trình quản lý quảng cáo.
thiếu bảng số · thiếu spend · khoảng ngày không hợp lệ	Công cụ đo không có đủ số, hoặc khoảng ngày quá 90 ngày.	Dán thêm chi tiêu và khoảng ngày, hoặc kéo số ở /ads.
thiếu frequency hoặc số ngày cùng mẫu	Chỉ có lượt hiển thị thì chưa đủ để kết luận mẫu mỏi.	Thêm tần suất hoặc số ngày chạy cùng mẫu.

Hỏi đáp

Agent không thấy công cụ nào?: Ứng dụng chưa đăng nhập xong, hoặc chưa tải lại danh sách. Đăng nhập lại rồi mở phiên chat mới. Kiểm theo Kiểm tra.
Agent trả lời mà không gọi công cụ?: Nói rõ tên công cụ trong câu hỏi, ví dụ «dùng ads_audit chấm số này».
Đổi máy thì sao?: Đăng nhập trên máy mới. Đủ 3 thiết bị thì thiết bị cũ nhất tự đăng xuất. Xem Đổi máy.
Kết quả hôm qua mất rồi?: Kết quả được lưu. Hỏi agent «liệt kê việc đã lưu» hoặc mở trang tài khoản.

Cổng chỉ đọc

Không tạo, sửa, tạm dừng, xoá hay tăng ngân sách chiến dịch. Agent gọi công cụ ghi thì cổng chặn.
Không gửi tin, không đăng bài.
Kết nối Meta, Google, TikTok ở /ads chỉ dùng để kéo số 7 ngày về chấm.

Cổng giữ gì

Dữ liệu	Giữ thế nào
Bảng số kéo từ nền tảng	36 giờ, rồi hết hạn.
Kết quả đo, khung viết, yêu cầu Company Suite	Lưu thành việc, xem ở trang tài khoản hoặc bằng `list_jobs`, `get_job`.
Câu yêu cầu gửi tới công cụ	Lưu dạng chữ để cải tiến dịch vụ, không dùng vào việc khác. Không gồm bảng số.
Nội dung đoạn chat	Không lưu. Cổng chỉ nhận tham số agent gửi trong lượt gọi.

Giữ key an toàn

Một slot một key đang dùng. Tạo key mới thì key cũ ngừng ngay.
Tạo key mới không gỡ các ứng dụng đã đăng nhập bằng OAuth.
Lộ key: tạo key mới ở trang tài khoản. Mất máy: gỡ ứng dụng trên máy đó ở cùng trang.
Mã 8 số trong thư chỉ để đăng nhập, không phải key.