Khắc phục sự cố

Agent không trả lời

Cần kiểm tra gì khi một agent hoặc chatbot im lặng, hiển thị thông báo lỗi hoặc đưa ra câu trả lời chung chung.

Một agent có thể không trả lời trong khung chat thử nghiệm của builder, trong chatbot trên trang web của bạn hoặc qua API. Nguyên nhân hầu như luôn nằm ở một trong những điểm cần kiểm tra dưới đây. Hãy làm theo thứ tự từ trên xuống, vì những điểm đầu tiên là phổ biến nhất và cũng nhanh nhất để loại trừ.

Triệu chứng#

  • Bạn gửi một tin nhắn và không nhận được phản hồi nào.
  • Khung chat hiển thị lỗi thay vì câu trả lời.
  • Khách truy cập chatbot thấy “Oops! Something went wrong. Please contact website owner!”

Các nguyên nhân thường gặp, theo thứ tự#

1. Workspace đã hết credit#

Agent không thể chạy nếu không có credit. Hãy tìm thông báo Read-only mode và kiểm tra số credit ở cuối thanh bên. Người gọi API nhận được “Insufficient credits to perform this action. Please recharge your credits.” Khách truy cập chatbot thấy “Sorry, you’ve reached your payment limit.” Xem hết credit.

2. Gói đăng ký đã kết thúc hoặc workspace ở chế độ chỉ đọc#

Nếu gói đăng ký đã bị hủy, workspace sẽ không hoạt động và các lượt chạy bị từ chối với “This workspace is inactive because its subscription ended.” Chỉ chủ sở hữu mới có thể chọn lại gói.

3. Một ứng dụng mà agent cần chưa được kết nối#

Nếu một công cụ cần tài khoản mà bạn chưa kết nối, bạn sẽ thấy cảnh báo như “Slack integration is required, but was not found” hoặc “Component is not integrated”, và lượt chạy đi tới công cụ đó sẽ thất bại với “is not configured. Please set up the integration first.” Mở Integrations và kết nối nó. Xem tích hợp bị ngắt kết nối.

4. Memory đang bật nhưng chưa chọn danh mục#

Trong builder của agent, Memory cần có một danh mục. Builder cảnh báo “Pick a category, or turn Memory off. The agent refuses to run while Memory is on with none picked.” Hãy chọn một danh mục trong Advanced, hoặc tắt memory. Xem memory và lịch sử trò chuyện.

5. Thay đổi của bạn đã được lưu nhưng chưa được xuất bản#

Các chỉnh sửa được lưu dưới dạng bản nháp. Những người dùng agent đang hoạt động, bao gồm chatbot trên trang web của bạn, vẫn thấy phiên bản được xuất bản gần nhất cho tới khi bạn bấm Publish changes. Một trigger hiển thị “Publish to activate” cho tới khi bạn làm điều đó. Xem chia sẻ và xuất bản.

6. Chatbot đang tắt hoặc bị giới hạn tần suất#

Trong Chatbots, mở chatbot và kiểm tra rằng Chatbot enabled đang bật. Những khách truy cập gửi quá nhiều tin nhắn sẽ thấy “Too many requests. Please try again later or sign in to continue.” Các giới hạn nằm trong Rate Limiting trong cài đặt chatbot.

7. Một bước hoặc công cụ bị lỗi#

Một công cụ hoặc bước trong agent có thể thất bại ngay cả khi bản thân mô hình vẫn hoạt động. Mở History, tìm phiên tương ứng, bật bộ lọc Error messages và đọc sự kiện bị lỗi. Xem một lượt chạy thất bại.

Cách khắc phục#

  1. Gửi một tin nhắn thử ngắn trong khung chat của builder và ghi lại chính xác nội dung của thông báo lỗi (nếu có).
  2. Đối chiếu nội dung đó với danh sách ở trên và áp dụng cách khắc phục.
  3. Xuất bản nếu bạn đã thay đổi bất cứ điều gì, sau đó thử lại từ chính nơi bị lỗi, ví dụ như trang web của bạn.

Kiểm tra tại nơi bị lỗi

Hãy tái hiện vấn đề tại đúng nơi người dùng gặp phải, dù đó là khung chat thử nghiệm, chatbot trên trang web của bạn hay một lệnh gọi API. Mỗi nơi có cài đặt riêng, và chatbot còn có giới hạn tần suất riêng.