Mã lỗi của Agent AI

Khi một lệnh không làm được, Tự Động Sale trả về một mã lỗi có tên kèm việc nên làm tiếp, để Agent AI biết tự sửa rồi gọi lại hay phải dừng lại hỏi người dùng.

Trang này sinh từ mã nguồn, không sửa tay.

Lỗi trả về có dạng thế nào?

Khi một lệnh không làm được, kết quả MCP có isError: true và content[0].text là một chuỗi JSON. Kết quả lỗi không có structuredContent: outputSchema của mỗi lệnh chỉ tả dạng thành công.

Trường	Có mặt	Ý nghĩa
code	Luôn có	Mã lỗi, một trong các mã bên dưới.
message	Luôn có	Điều gì chưa làm được, viết cho người đọc.
next_step	Luôn có	Việc Agent AI nên làm tiếp.
needs_human	Luôn có	true thì dừng lại và báo người dùng việc cần làm, không tự thử cách khác.
retry_after_seconds	Khi cần chờ	Số giây nên chờ trước khi gọi lại.
fields	Khi tham số sai	Danh sách { path, problem }: tham số nào sai và sai thế nào.
deprecation	Khi lệnh sắp ngừng	Phần nào đổi và cách cập nhật, xem Thay đổi hợp đồng.

SCOPE_INSUFFICIENT

Kết nối này chưa được cấp quyền cho lệnh vừa gọi.

• Việc nên làm tiếp: Báo người dùng cấp thêm quyền cho kết nối trong trang Kết nối Agent AI, rồi kết nối lại.
• Cần hỏi người dùng: Có

NOT_FOUND

Không tìm thấy đối tượng trong tài khoản này.

• Việc nên làm tiếp: Gọi lệnh danh sách tương ứng để lấy đúng mã, rồi thử lại với mã đó.
• Cần hỏi người dùng: Không

Theo nguyên nhân cụ thể, next_step nói rõ hơn:

• Gọi list_topics để lấy đúng mã chủ đề.
• Gọi get_topic để xem các nguồn đang gắn với chủ đề.
• Hỏi người dùng đúng mã danh mục nguồn, hoặc gắn nguồn bằng text.
• Gọi list_leads để lấy đúng mã khách tiềm năng.
• Gọi list_matches để lấy đúng mã bài khớp.
• Gọi list_campaigns để lấy đúng mã chiến dịch.
• Gọi get_readiness để lấy đúng mã tài khoản Facebook.
• Gọi list_matches để lấy đúng mã bài viết (postId) làm targetRef.
• Hỏi người dùng đúng nhóm muốn đăng; chỉ dùng mã nhóm đã có trong tài khoản.
• Hỏi người dùng đúng sản phẩm, hoặc bỏ productId.

INVALID_INPUT

Tham số gửi lên không đúng mô tả của lệnh.

• Việc nên làm tiếp: Sửa các trường liệt kê trong fields theo mô tả tham số của lệnh rồi gọi lại.
• Cần hỏi người dùng: Không

Theo nguyên nhân cụ thể, next_step nói rõ hơn:

• Chủ đề chưa có tiêu chí lọc bài. Gọi update_topic với scoringCriteria rồi thử lại.
• Chủ đề chưa có chu kỳ thu thập. Gọi lại start_harvest kèm harvestIntervalMinutes.
• Loại nguồn của chủ đề không khớp với nguồn đang gắn. Đổi crawlMode bằng update_topic cho khớp loại nguồn, hoặc gắn nguồn đúng loại bằng attach_sources.
• Gửi tối đa 100 dòng, mỗi dòng một nhóm, rồi gọi lại.
• Lệnh này cần chọn tài khoản Facebook sẽ chạy. Gọi get_readiness để lấy mã tài khoản rồi gửi lại kèm profileId.
• Mẫu tin có nội dung không được phép gửi tự động. Bỏ link, email, số điện thoại khỏi tin (giữ tối đa một chỗ {ten}) rồi gọi lại.
• Bài viết này không bình luận được. Chọn bài khác từ list_matches.
• Bỏ phần nhắc tên người dạng @[...] khỏi bình luận rồi gọi lại.
• Sản phẩm đang tắt: bỏ productId hoặc nhờ người dùng bật sản phẩm.
• Bình luận kèm sản phẩm cần topicId của chủ đề có gắn sản phẩm đó; hoặc bỏ productId.
• Sản phẩm chưa có link: bỏ includeProductLink rồi gọi lại.
• Bình luận phải nhắc tên sản phẩm; thêm tên vào message rồi gọi lại.
• Loại chiến dịch này không kèm sản phẩm: bỏ các trường sản phẩm rồi gọi lại.
• Sau khi lọc, bản nháp không còn nội dung hay người nhận nào. Người nhận có thể đã bị chặn hoặc vừa được nhắm gần đây. Báo người dùng, hoặc gửi nội dung/danh sách khác.
• Gửi ít nhất một nhóm trong targets.
• Các nhóm đã chọn chưa có bài nào bình luận được; chọn nhóm khác.
• Chỉ úp được lượt đã đăng thành công; gọi get_campaign để lấy đúng mã lượt.
• Chỉ chọn các lượt đăng bằng cùng một tài khoản Facebook.
• Tài khoản đã chọn chưa đăng được vào một số nhóm; bỏ các nhóm đó hoặc chọn tài khoản khác.
• Một chiến dịch khác đang nhắm cùng mục tiêu. Gọi list_campaigns để xem chiến dịch đang có; bỏ mục tiêu trùng rồi gọi lại.
• Không khách nào đã chọn có tài khoản Facebook nhắn được. Báo người dùng: các khách này không nhắn Messenger được. Chọn khách khác từ list_leads. (cần hỏi người dùng: có)
• Khách này đã chuyển thành khách hàng nên không sửa được nữa. Không sửa khách này; báo người dùng nếu thật sự cần thay đổi.

PLAN_LIMIT

Gói hiện tại của tài khoản không cho phép thêm việc này.

• Việc nên làm tiếp: Báo người dùng nâng gói hoặc giải phóng hạn mức trong ứng dụng.
• Cần hỏi người dùng: Có

Theo nguyên nhân cụ thể, next_step nói rõ hơn:

• Gói hiện tại không cho bật lịch thu thập tự động với chu kỳ này. Không tự thử chu kỳ khác. Dùng harvest_now để thu thập từng lượt, và báo người dùng nếu muốn lịch tự động thì chọn chu kỳ hoặc nâng gói trong ứng dụng.

DEVICE_OFFLINE

Không có máy nào của tài khoản đang kết nối để nhận việc.

• Việc nên làm tiếp: Nhờ người dùng mở ứng dụng Tự Động Sale trên máy tính và giữ máy bật, rồi kiểm lại bằng get_readiness.
• Cần hỏi người dùng: Có

FB_ACCOUNT_PAUSED

Tài khoản Facebook đang được tạm dừng trong ứng dụng.

• Việc nên làm tiếp: Nhờ người dùng tiếp tục tài khoản trong ứng dụng.
• Cần hỏi người dùng: Có

FB_ACCOUNT_CHECKPOINT

Facebook đang yêu cầu xác minh tài khoản.

• Việc nên làm tiếp: Nhờ người dùng đăng nhập Facebook để xác minh, rồi xác nhận lại trong ứng dụng.
• Cần hỏi người dùng: Có

COOLDOWN

Việc này vừa chạy, cần chờ một lúc mới làm lại được.

• Việc nên làm tiếp: Chờ hết retry_after_seconds giây rồi thử lại.
• Cần hỏi người dùng: Không

TOPIC_HAS_AUTOMATION

Chủ đề đang tự bình luận hoặc tự nhắn tin nên Agent AI không được sửa hay tạo thêm việc cho nó (gắn nguồn, thu thập, theo dõi bài, soạn nháp). Tạm dừng và dừng thu thập vẫn được.

• Việc nên làm tiếp: Dừng lại và báo người dùng: chủ đề này đang tự bình luận hoặc tự nhắn tin. Người dùng tự thao tác trong ứng dụng, hoặc tắt hai công tắc đó trước rồi nhờ bạn làm tiếp.
• Cần hỏi người dùng: Có

DUPLICATE_NAME

Tài khoản đã có một mục cùng tên.

• Việc nên làm tiếp: Đặt tên khác rồi gọi lại.
• Cần hỏi người dùng: Không

Theo nguyên nhân cụ thể, next_step nói rõ hơn:

• Gọi list_topics để xem tên đã có, đặt tên chủ đề khác rồi gọi lại.

JOB_ALREADY_QUEUED

Việc này đang chạy cho chủ đề đó, chưa xong.

• Việc nên làm tiếp: Đừng gọi lại. Theo dõi tiến độ bằng lệnh đọc trạng thái mà kết quả trước gợi ý (check_with), rồi đợi việc xong.
• Cần hỏi người dùng: Không

TOOL_RETIRED

Lệnh này đã ngừng hoạt động.

• Việc nên làm tiếp: Đọc trường deprecation: dùng lệnh replacedBy nếu có, và nhắc người dùng làm mới kết nối.
• Cần hỏi người dùng: Không

INTERNAL

Tự Động Sale gặp lỗi khi xử lý lệnh.

• Việc nên làm tiếp: Thử lại sau ít phút; nếu vẫn lỗi, báo người dùng.
• Cần hỏi người dùng: Không