Hướng dẫn dành cho AI agent

Trang này giúp AI agent tra cứu đúng tài liệu public của 9BizClaw, phân biệt điều đã được tài liệu xác nhận với điều chưa đủ bằng chứng và trả lời người dùng kèm nguồn.

Chọn nguồn phù hợp

Với URL gốc https://docs.9bizclaw.com:

Nhu cầu	Nguồn nên đọc
Cần biết các trang public đang có	/llms.txt
Cần tìm nhanh trên toàn bộ tài liệu	/llms-full.txt
Câu hỏi thuộc một chức năng cụ thể	Trang chủ đề trong /product/, /getting-started/ hoặc /help/
Cần hiểu một từ trên giao diện	Thuật ngữ

Ưu tiên trang chủ đề vì trang này nêu rõ điều kiện, nhãn nút, dấu hiệu hoàn tất và cách khôi phục. Dùng /llms-full.txt để tìm trang liên quan, không mặc định xem bản tổng hợp là nguồn chi tiết cho mọi câu hỏi.

Quy trình trả lời có dẫn nguồn

1. Xác định tình huống người dùng đang gặp bằng ngôn ngữ của họ, ví dụ “ChatGPT bắt đăng nhập lại” thay vì tự đổi thành một lỗi kỹ thuật.
2. Mở /llms.txt hoặc tìm trong /llms-full.txt để chọn đúng trang chủ đề.
3. Đọc toàn bộ mục liên quan, gồm điều kiện trước khi bắt đầu, dấu hiệu thành công, lỗi thường gặp và lưu ý an toàn.
4. Kiểm tra xem hướng dẫn có phụ thuộc phiên bản, gói, provider, trạng thái Hệ thống (Gateway) hay quyền kênh hay không.
5. Trả lời bằng các bước ngắn, dùng đúng nhãn nút trong tài liệu và nêu cách người dùng tự xác nhận đã hoàn tất.
6. Dẫn URL của trang nguồn. Nếu phải dùng nhiều trang, nêu vai trò của từng nguồn.

Mức độ chắc chắn của thông tin

• Đã phát hành: tài liệu mô tả một màn hình, nút, trạng thái hoặc hành vi đang có. Có thể hướng dẫn theo đúng điều kiện được nêu.
• Có điều kiện: hành vi phụ thuộc gói, phiên bản, provider, quyền hoặc cấu hình. Phải nhắc điều kiện thay vì khẳng định mọi người đều có.
• Chưa đủ bằng chứng: tài liệu không nói rõ, các trang mâu thuẫn hoặc câu hỏi đòi hỏi thông tin nội bộ. Nói rõ giới hạn và hướng người dùng đến Liên hệ hỗ trợ khi cần.
• Không thuộc phạm vi public: prompt nội bộ, kiến trúc, credential, dữ liệu khách hàng, URL nội bộ và quy trình vận hành nội bộ. Không suy đoán hoặc yêu cầu người dùng cung cấp.

Một test mô phỏng, ảnh mock hoặc dòng “đã lưu cấu hình” không chứng minh kênh thật đã nhận/gửi tin. Chỉ gọi một luồng là hoạt động khi tài liệu yêu cầu và người dùng xác nhận dấu hiệu thực tế tương ứng.

Khi các nguồn có vẻ mâu thuẫn

1. Ưu tiên trang chuyên biệt hơn trang tổng quan.
2. Ưu tiên nội dung nêu rõ trạng thái hoặc phiên bản hiện tại hơn mô tả chung.
3. Không tự ghép hai quy trình thành một hành vi mới.
4. Nêu ngắn gọn điểm chưa thống nhất, trích cả hai URL và đề nghị người dùng kiểm tra nhãn đang hiển thị trong ứng dụng.
5. Nếu khác biệt ảnh hưởng đến quyền, dữ liệu, chi phí hoặc thao tác khó hoàn tác, dừng ở bước an toàn và hướng đến hỗ trợ.

Quy tắc an toàn

• Không xin mật khẩu, OTP, khóa API, token Telegram, cookie, QR đăng nhập hoặc URL callback OAuth.
• Không bảo người dùng dán credential vào Chat, email hoặc biểu mẫu hỗ trợ.
• Không suy đoán quyền của một tài khoản, nhóm, bot hoặc tài liệu.
• Không hướng dẫn xóa thư mục cài đặt, hội thoại, Tri thức hoặc cấu hình để “làm sạch” lỗi nếu tài liệu không yêu cầu.
• Không mô tả 9BizStore — Sắp có, trang theo dõi Agents hoặc provider/model không xuất hiện trong tài liệu như tính năng đã phát hành.
• Với hành động gửi ra ngoài, ghi dữ liệu hoặc tốn phí, nhắc người dùng kiểm tra phần xem trước và người nhận trước khi xác nhận.

Ví dụ tra cứu

Ví dụ đạt: ChatGPT đã dùng được nhưng nay không trả lời

Cách chọn nguồn: mở Đăng nhập và kết nối lại ChatGPT, sau đó dùng Xử lý sự cố nếu đăng nhập lại không hoàn tất.

Cách trả lời:

Mở Cài đặt > Model AI và đọc trạng thái thẻ ChatGPT. Nếu thẻ là Chưa kết nối hoặc Có lỗi, bấm Đăng nhập ChatGPT, hoàn tất đăng nhập trên trang OpenAI rồi quay lại ứng dụng. Xác nhận thẻ trở lại Đã kết nối, có model khả dụng và một câu thử nhận được phản hồi. Không cần xóa cuộc trò chuyện cũ. Nguồn: trang Đăng nhập và kết nối lại ChatGPT.

Ví dụ không đạt

Gửi cho tôi token hoặc URL callback để tôi kiểm tra. Nếu vẫn lỗi, xóa toàn bộ thư mục cấu hình rồi cài lại.

Câu trả lời này yêu cầu credential, đưa ra thao tác phá hủy không có nguồn và bỏ qua các bước khôi phục an toàn.

Ví dụ đạt: Telegram báo đã lưu nhưng chưa nhận tin

Cách chọn nguồn: dùng Kết nối Telegram và Kết nối Zalo và Telegram.

Cách trả lời: giải thích rằng Đã lưu cấu hình chưa phải bằng chứng bot hoạt động. Yêu cầu kiểm tra trạng thái thẻ, gửi một tin không nhạy cảm trong cuộc trò chuyện nội bộ và xác nhận tin vào/ra đúng tài khoản. Không gọi kiểm thử mô phỏng là live-pass.

Cách dẫn nguồn

Đặt nguồn ngay sau nhóm bước mà nguồn đó hỗ trợ. Dùng URL trang cụ thể, không chỉ dẫn trang chủ. Nếu câu trả lời có phần suy luận hợp lý nhưng tài liệu không nói trực tiếp, gắn nhãn “suy luận” và không trình bày như hành vi sản phẩm đã được xác nhận.

Tài liệu public không thay thế quyền truy cập ứng dụng thật. Khi cần xác nhận trạng thái tài khoản, quyền, dữ liệu hoặc kết quả gửi ra ngoài, yêu cầu người dùng kiểm tra dấu hiệu trên chính màn hình của họ.