Cách tạo mới một AI Agent
Để tạo một AI Agent mới:- Truy cập vào mục AI Hub trên thanh điều hướng.
- Nhấn vào nút + Tạo AI Agent.

- Điền các thông tin cần thiết và cấu hình cho Agent của bạn trong bảng thiết lập:

- Name: Nhập tên nhận diện cho Trợ lý AI để dễ dàng quản lý và phân biệt các Agent trong không gian làm việc.
- System Message (Prompt): Lời nhắc hệ thống định hướng vai trò, tính cách, nhiệm vụ và các nguyên tắc giao tiếp cốt lõi của Agent. Biểu tượng cài đặt nâng cao ở góc trên bên phải cho phép bạn lựa chọn mô hình AI (LLM) và tinh chỉnh các tham số hoạt động.
- Messages: Thêm các đoạn hội thoại mẫu giữa người dùng và trợ lý để huấn luyện phong cách trả lời thực tế (kỹ thuật Few-shot learning).
- Tools (optional): Gắn tài liệu tra cứu (Knowledge), hàm API nội bộ (AI Functions), máy chủ MCP hoặc công cụ hệ thống (System Functions) để mở rộng năng lực xử lý nghiệp vụ cho Agent.
- AI Actions: Thiết lập các quy tắc để AI tự động thực hiện các hành động hệ thống (gán thẻ, kích hoạt kịch bản, chuyển cuộc trò chuyện cho nhân viên…) khi nhận diện điều kiện phù hợp trong lúc tư vấn.
- Rich Response: Bật chế độ trả về cấu trúc phản hồi JSON để hiển thị các khối nội dung trực quan như thẻ sản phẩm, danh sách cuộn ngang và nút bấm tương tác.
Thiết lập thời gian chờ phản hồi
Bạn có thể đặt thời gian AI Agent chờ trước khi gửi phản hồi bằng tính năng Bot reply delay. Tính năng này phù hợp khi khách thường gửi nhiều tin nhắn liên tiếp. Agent sẽ chờ khách nhắn xong rồi trả lời một lần, thay vì phản hồi riêng cho từng tin nhắn. Để thiết lập thời gian chờ:- Trong danh sách Agent, tìm Agent bạn muốn cấu hình.
- Nhấn menu Actions ở cuối dòng Agent.
- Chọn Bot reply delay.
- Chọn khoảng thời gian chờ và nhấn Confirm.


Cách AI Agent gửi tin nhắn phản hồi
AI Agent không chờ tạo xong toàn bộ câu trả lời rồi gửi nguyên nội dung trong một tin nhắn. Agent nhận nội dung từ mô hình AI theo thời gian thực, sau đó chuẩn bị các tin nhắn gửi ra kênh. Khi chuẩn bị phản hồi của Agent, ChatbotX áp dụng các quy tắc sau:- Khi câu trả lời có khoảng trống giữa hai đoạn văn, Agent xem đó là điểm tách tin nhắn. Đoạn văn phía sau được gửi thành một bong bóng chat mới.
- URL hoặc link ảnh được tách khỏi phần văn bản và gửi thành một tin nhắn riêng.
Giới hạn câu trả lời trong hai bóng chat văn bản
Để Agent trả lời trong một đoạn văn dài và không gửi quá hai bóng chat chứa văn bản, hãy thêm hướng dẫn sau vào System Message (Prompt):Hướng dẫn này giới hạn Agent gửi tối đa hai bóng chat chứa văn bản. URL và link ảnh được tách thành tin nhắn riêng nên không tính vào giới hạn này.
Cung cấp thông tin cho AI Agent
Để AI Agent có thể trả lời khách hàng một cách chính xác nhất, bạn cần cung cấp thông tin, dữ liệu và công cụ hỗ trợ cho Agent thông qua các phần dưới đây:Thêm thông tin vào System Message (Prompt)
System Message hoạt động như định hướng cốt lõi cho AI. Bạn có thể cung cấp các thông tin giới thiệu, phong cách trả lời, hoặc các quy tắc chung mà bạn muốn Agent tuân thủ khi giao tiếp với khách hàng trong trường Prompt.

- Lựa chọn mô hình AI (Model Selection): ChatbotX hỗ trợ tích hợp và chuyển đổi linh hoạt giữa các dòng mô hình AI hàng đầu thế giới:
- Gemini Model: Lựa chọn các phiên bản Google Gemini (ví dụ: Gemini 3.5 Flash, Gemini Pro…).
- OpenAI Model: Lựa chọn các phiên bản GPT từ OpenAI (ví dụ: GPT-5.4 Mini, GPT-4o…).
- Claude Model: Lựa chọn các phiên bản Claude từ Anthropic (ví dụ: Claude Sonnet 4.6, Claude Haiku…).
- DeepSeek Model: Lựa chọn các phiên bản DeepSeek chính hãng (ví dụ: deepseek-v4-flash, DeepSeek V3…).
- OpenRouter Model: Kết nối và sử dụng hàng trăm mô hình mã nguồn mở và thương mại khác thông qua cổng OpenRouter.
- Temperature (optional): Điều chỉnh độ sáng tạo của câu trả lời từ 0 đến 1. Giá trị thấp (0.2 - 0.4) giúp câu trả lời tập trung, chính xác và bám sát tài liệu doanh nghiệp; giá trị cao giúp câu từ linh hoạt, tự nhiên hơn.
- Max Tokens (optional): Giới hạn số lượng token tối đa cho mỗi lượt phản hồi do AI tạo ra (mặc định 2048 tokens).
Thêm tin nhắn mẫu
Phần Messages cho phép bạn bổ sung các cặp hội thoại mẫu giữa người dùng và trợ lý để định hình phong cách phản hồi thực tế:
- Cấu trúc cặp tin nhắn: Mỗi lượt hội thoại mẫu gồm tin nhắn của User (người dùng đặt câu hỏi hoặc đưa ra tình huống) và câu trả lời tương ứng từ Assistant (cách Agent nên phản hồi theo đúng chuẩn mực của doanh nghiệp).
- Lợi ích: Kỹ thuật này giúp Agent nhanh chóng nắm bắt văn phong xưng hô, độ dài câu từ và cách ứng biến trong các tình huống thực tế mà không cần diễn đạt quá phức tạp trong phần Prompt.
- Nhấn + Add more để bổ sung thêm các lượt hội thoại mẫu, hoặc nhấp vào dấu
xở góc trên mỗi khối tin nhắn để xóa bớt.
Thêm công cụ bổ trợ
Tools là những công cụ giúp AI Agent thực hiện được nhiều việc hơn ngoài việc trả lời câu hỏi thông thường. Bạn có thể mở danh sách để lựa chọn và gắn nhiều công cụ cùng lúc cho Agent:
- File (Knowledge): Cho phép Agent tra cứu thông tin từ tài liệu thực tế của doanh nghiệp. Hỗ trợ các định dạng: PDF, CSV, Excel (XLSX), DOCX, DOC, JSON, PPTX, TXT. Bạn tải tài liệu lên trong mục Knowledge, sau đó tích chọn file để Agent dùng làm nguồn tri thức tham chiếu.
- Function (AI Functions): Cho phép Agent gọi API bên ngoài để truy xuất hoặc đồng bộ dữ liệu thời gian thực trong lúc trò chuyện (ví dụ: tra cứu trạng thái đơn hàng, kiểm tra tồn kho).
- MCP Server: Kết nối Agent với các máy chủ MCP (Model Context Protocol) bên ngoài (ví dụ: tích hợp Shopify, hệ thống CRM hoặc phần mềm quản lý nội bộ) để mở rộng khả năng xử lý nghiệp vụ phức tạp.
- System Function: Các công cụ hệ thống được tích hợp sẵn trên ChatbotX:
- Connect user to Human: Tự động nhận diện nhu cầu và chuyển cuộc trò chuyện sang nhân viên hỗ trợ trực tiếp.
- Document Reader: Đọc và trích xuất nội dung từ các tệp tài liệu do người dùng gửi trực tiếp trong cuộc trò chuyện.
- Image Reader: Đọc hiểu và phân tích hình ảnh (ảnh chụp sản phẩm, biên lai chuyển khoản…) do người dùng gửi vào hộp thư.
Hành động tự động
AI Actions cho phép AI Agent tự động đưa ra quyết định và thực thi các hành động hệ thống trong lúc trò chuyện với khách hàng khi nhận diện các điều kiện cụ thể:
- When (Điều kiện kích hoạt): Nhập mô tả điều kiện bằng ngôn ngữ tự nhiên (ví dụ: khi khách hàng để lại số điện thoại và cần xác nhận đơn hàng, hoặc khi khách bày tỏ sự không hài lòng). Mô hình AI sẽ tự động phân tích ngữ cảnh cuộc trò chuyện thời gian thực để kích hoạt quy tắc khi điều kiện được thỏa mãn.
- What should the AI do? (Hành động AI cần thực hiện): Thiết lập chuỗi hành động hệ thống mà bot sẽ tự động thực hiện. Bạn có thể nhấn + Add action để gộp nhiều hành động diễn ra liên tiếp trong cùng một điều kiện.
- Send Flow: Tự động kích hoạt và gửi một kịch bản Flow cụ thể cho khách hàng (ví dụ: Flow gửi form đăng ký, Flow xác nhận thông tin).
- Assign Conversation to an Admin: Phân công cuộc trò chuyện cho một quản trị viên hoặc nhân viên tư vấn cụ thể.
- Remove Assignment: Hủy phân công người phụ trách cuộc trò chuyện.
- Transfer Conversation to Human: Tạm dừng bot và chuyển cuộc hội thoại sang chế độ chờ nhân viên hỗ trợ tiếp quản.
- Add Tag: Tự động gắn thẻ nhận diện cho liên hệ (ví dụ: gắn thẻ khách hàng tiềm năng, khách hỏi giá…).
- Remove Tag: Gỡ bỏ thẻ đã gắn khỏi liên hệ.
- Set Custom Field: Cập nhật dữ liệu vào thuộc tính tùy chỉnh của khách hàng.
- Clear Custom Field: Xóa giá trị đang lưu trong thuộc tính tùy chỉnh.
- Mark as Follow Up: Đánh dấu cuộc trò chuyện vào danh sách cần chăm sóc hoặc theo dõi tiếp theo.
- Remove from Follow Up: Bỏ đánh dấu theo dõi cuộc trò chuyện.
- Transfer Conversation to Bot: Chuyển cuộc trò chuyện trở lại cho AI Agent hoặc bot tự động tiếp tục xử lý.
- Archive: Lưu trữ cuộc trò chuyện khi đã hoàn tất tư vấn.
- Block Contact: Chặn liên hệ nếu phát hiện hành vi spam hoặc vi phạm tiêu chuẩn cộng đồng.
Tùy chỉnh Action Prompt
Ở góc trên bên phải của tiêu đề AI Actions, bạn có thể nhấp vào biểu tượng thanh trượt cài đặt để mở cửa sổ cấu hình Action prompt:
- Khớp chính xác điều kiện: Chỉ kích hoạt quy tắc khi ngữ cảnh cuộc hội thoại thỏa mãn hoàn toàn mô tả trong phần When. Tuyệt đối không suy đoán hoặc gán ghép dựa trên giả định.
- Hỗ trợ kích hoạt đồng thời: Nhiều quy tắc có thể cùng được kích hoạt trong một lượt phản hồi nếu thỏa mãn đầy đủ các điều kiện.
- Trích xuất thông tin thực tế: Khi một quy tắc yêu cầu giá trị từ cuộc trò chuyện, AI sẽ tự động lấy thông tin có thật do khách hàng cung cấp. Tuyệt đối không tự tạo hoặc suy diễn dữ liệu bị thiếu.
- Bảo mật cấu hình nội bộ: AI không bao giờ tiết lộ mã quy tắc (Rule ID), cơ chế khớp quy tắc hay các thiết lập kỹ thuật nội bộ cho khách hàng.
Phản hồi giàu tương tác
Bên cạnh câu trả lời văn bản đơn thuần, AI Agent trên ChatbotX có khả năng tự động gửi các dạng tin nhắn tương tác trực quan như thẻ sản phẩm (Card), bộ sưu tập cuộn ngang (Carousel), nút lựa chọn nhanh (Quick Replies) và tự động thực thi các hành động hệ thống. Để sử dụng tính năng này, bạn cần bật công tắc Rich Response trong bảng cấu hình Agent và dán quy tắc phản hồi JSON vào ô System Message (Prompt).