AI Functions cho phép bạn kết nối AI với các luồng tự động hóa (automation workflows) lập sẵn hoặc các công cụ bên ngoài. Thông qua AI Functions, Chatbot của bạn có thể dễ dàng thu thập dữ liệu từ người dùng và kích hoạt các luồng kịch bản tương ứng để xử lý tác vụ, truy xuất dữ liệu từ API bên ngoài, sau đó trả kết quả lại cho AI tiếp tục trò chuyện. Ví dụ: Nếu một người dùng hỏi, “Thời tiết ở Hà Nội hôm nay thế nào?”, bản thân AI sẽ không có dữ liệu thời gian thực để trả lời. Tuy nhiên, bằng cách sử dụng một AI Functions, bạn có thể kích hoạt một luồng kịch bản gọi API Thời tiết và đem kết quả đó về cho AI để phản hồi lại chính xác cho khách hàng.Documentation Index
Fetch the complete documentation index at: https://chatbotx.io/docs/llms.txt
Use this file to discover all available pages before exploring further.
Cách tạo một AI Functions
Để tạo mới, hãy truy cập vào mục AI Functions trên thanh điều hướng bên trái và nhấn nút + Tạo AI Function. Màn hình cấu hình sẽ hiện ra với các trường thông tin sau:
- Tên: Tên của AI Function này. Nó nên mô tả rõ ràng mục đích hoạt động. Ví dụ: thay vì đặt tên chung chung là “thoi_tiet”, hãy dùng “get_current_weather”. Nên sử dụng tiếng Anh hoặc không dấu, và có ít nhất 2 từ trở lên.
- Mục đích (What does this trigger do?): Phần này giúp AI hiểu khi nào thì function này nên được sử dụng. Hãy giải thích chức năng của nó một cách chi tiết. (Ví dụ: “Cho phép người dùng đặt lịch hẹn khám bệnh”). Bạn không cần phải liệt kê các dữ liệu cần thu thập ở trường này.
- Thu thập dữ liệu (What data to collect?): Cấu hình các tham số bạn cần thu thập từ câu trả lời của khách hàng trước khi chạy kịch bản (ví dụ: ngày giờ, họ tên, email…). Lưu ý: tên biến phải có ý nghĩa (vd: dùng “email” thay vì “thu_thap_1” để AI có thể tự động ánh xạ chính xác thông tin từ đoạn chat).
- Tin nhắn đầu ra (What is the output message?): Đây là thông điệp nền tảng (raw data) trả về sau khi function chạy xong. (Ví dụ: “Bạn đã đặt lịch hẹn thành công”). LƯU Ý: Tin nhắn đầu ra thường sẽ không bao giờ được gửi nguyên văn. AI sẽ đọc thông báo này, tự động viết lại một câu phản hồi mượt mà hơn và gửi tiếp cho người dùng.
- ID Luồng kích hoạt (Trigger Flow ID): (Tùy chọn) Chỉ định ID của một flow (luồng kịch bản) mà bạn muốn chạy sau khi AI thu thập đủ dữ liệu yêu cầu. Trong flow này, bạn có thể lưu trữ dữ liệu người dùng, bắn webhook, gọi API dữ liệu, hoặc thậm chí là tạo lệnh chuyển chat cho nhân viên hỗ trợ (Inbox Action).
Một số ví dụ về AI Functions
Dưới đây là các ví dụ phổ biến giúp bạn hình dung cách cấu hình một AI Functions:1. Đặt lịch hẹn (Book Appointment)
- Tên:
book_appointment - Mục đích: Cho phép người dùng đặt lịch hẹn.
- Thu thập dữ liệu:
date,email,reason - Tin nhắn đầu ra: Bạn đã đặt lịch hẹn thành công.
2. Kết nối với nhân viên hỗ trợ (Human Transfer)
- Tên:
connect_user_to_human - Mục đích: Cho phép người dùng trò chuyện, liên hệ với nhân viên hỗ trợ thật. Hàm này sẽ trực tiếp kết nối họ.
- ID Luồng kích hoạt: Kích hoạt một luồng có chứa hành động Inbox (Hộp thư) để chuyển tiếp trò chuyện cho con người xử lý.
- Tin nhắn đầu ra: Bạn đã được kết nối với nhân viên hỗ trợ, chúng tôi sẽ sớm phản hồi bạn.
3. Cập nhật thời tiết (Weather API)
- Tên:
get_current_weather - Mục đích: Cho phép người dùng xem dự báo thời tiết hiện hành tại một khu vực cụ thể.
- Thu thập dữ liệu:
city - ID Luồng kích hoạt: Kích hoạt luồng chứa “Yêu cầu bên ngoài” (External Request) để gọi API thời tiết.
- Tin nhắn đầu ra:
{{data_from_api}}
4. Đăng ký nhận tin (Email list)
- Tên:
join_email_list - Mục đích: Cho phép người dùng đăng ký vào danh sách nhận bản tin (email list) của chúng tôi.
- Thu thập dữ liệu:
email - Tin nhắn đầu ra: Đăng ký thành công.
5. Lấy báo giá phí vận chuyển (Shipping Quote)
- Tên:
request_shipping_quote - Mục đích: Cho phép người dùng yêu cầu báo giá cho phí giao một kiện hàng.
- Thu thập dữ liệu:
origin_address,destination_address,dimensions,weight - ID Luồng kích hoạt: Kích hoạt luồng hệ thống tự động tính toán báo giá dựa vào cân nặng/kích thước gửi lên.
- Tin nhắn đầu ra:
{{quote}}
Sử dụng AI Functions
Sau khi bạn thiết lập xong một AI Functions, hãy đảm bảo rằng nó được bật và liên kết với AI Agent của bạn tại mục cấu hình của Agent đó.