Tìm hiểu các hành động trong Botpress
Các hành động trong Botpress là các chức năng phía máy chủ được bot thực thi trong các luồng hội thoại. Họ có quyền thay đổi trạng thái của cuộc trò chuyện, gửi tin nhắn tùy chỉnh, thực thi mã tùy ý (chẳng hạn như gọi API hoặc lưu trữ dữ liệu), v.v. Về cơ bản, hành động là các hàm JavaScript thông thường, nghĩa là chúng có thể thực hiện hầu hết mọi thứ trong giới hạn của nền tảng.
Khi một hành động được Trình quản lý đối thoại (DM) gọi ra, nó sẽ nhận được một số đối số cung cấp ngữ cảnh cho hàm. Các đối số này bao gồm thuộc tính người dùng, biến phiên, biến tạm thời, biến cấp bot, sự kiện người dùng mới nhất trong cuộc hội thoại, đối số được truyền từ Visual Flow Builder và vm hộp cát có chứa một số biến môi trường.
Đăng ký hành động mới
Để thêm các hành động tùy chỉnh của bot, bạn cần tạo một tệp JavaScript (.js) và đặt nó vào dữ liệu/toàn cầu/hành động thư mục trong dự án Botpress của bạn. Thật không may, không có cách nào để thêm các hành động mới theo chương trình trong thời gian chạy. Bằng cách sử dụng các nhận xét JavaDoc trong mã của mình, bạn có thể cung cấp thông tin có ý nghĩa về các hành động như tên, mô tả, đối số và giá trị mặc định của chúng. Bạn cũng có thể ẩn một hành động trong trình soạn thảo luồng bằng cách thêm cờ @hidden true trong nhận xét JavaDoc.
Cách tạo hành động tùy chỉnh trong Botpress
Dưới đây là một số bước bạn có thể làm theo để tạo hành động tùy chỉnh trong Botpress:
Bước 1: Tạo Bot của bạn và thêm nút
Để bắt đầu, hãy tạo một bot mới trong Botpress. Sau khi bot của bạn được tạo, hãy thêm nút mới vào luồng hội thoại.
Bước 2: Thêm thông báo phù hợp vào nút của bạn
Trong nút mới tạo, hãy thêm các thông báo cần thiết để thuận tiện cho việc trao đổi nội dung với người dùng. Ví dụ: bạn có thể thêm tin nhắn văn bản để chào người dùng và hỏi tên của họ.
Bước 3: Mở Mã thực thi từ thanh bên
Điều hướng đến thanh bên trong Botpress Flow Builder và mở “Trình chỉnh sửa mã”. Đây là nơi bạn có thể xây dựng và quản lý các hành động tùy chỉnh của mình.
Bước 4: Click vào nút “Thêm hành động”
Trong phần “Thực thi mã”, nhấp vào nút “Thêm hành động”. Hành động này sẽ mở ra cửa sổ “Tạo hành động_legacy mới”.
Bước 5: Chỉ định tên cho tệp và nhấp vào nút gửi
Trong cửa sổ “Tạo action_legacy mới”, đặt tên có ý nghĩa cho tệp hành động tùy chỉnh của bạn; ví dụ: customAction.js. Khi bạn đã chỉ định tên, hãy nhấp vào nút “Gửi”. Điều này tạo ra tệp “customAction.js”.
Bước 6: Viết mã tùy chỉnh của bạn
Mở tệp “customAction.js” mới tạo. Bên trong tệp, bạn sẽ thấy mã soạn sẵn được tạo cho một hành động mới. Cung cấp mô tả có ý nghĩa cho hành động tùy chỉnh của bạn bằng cách sử dụng nhận xét thích hợp.
Bây giờ, hãy viết mã tùy chỉnh của bạn trong hàm. Mã này xác định hành vi của hành động tùy chỉnh của bạn. Bạn có thể sử dụng JavaScript để thực hiện nhiều tác vụ khác nhau như thực hiện lệnh gọi API, truy cập cơ sở dữ liệu hoặc xử lý logic phức tạp.
Bước 7: Sửa đổi nút của bạn để sử dụng hành động tùy chỉnh
Quay lại Botpress Flow Builder và sửa đổi nút nơi bạn muốn kích hoạt hành động tùy chỉnh của mình. Thêm thẻ “Thực thi mã” vào nút.
Bước 8: Chọn Tên hành động tùy chỉnh của bạn và chỉ định tham số hành động
Trong thẻ “Thực thi mã”, bạn sẽ thấy danh sách thả xuống chứa tên của tất cả các hành động tùy chỉnh của bạn. Chọn tên hành động tùy chỉnh của bạn từ danh sách. Nếu hành động tùy chỉnh của bạn yêu cầu bất kỳ tham số nào, bạn có thể chỉ định chúng trong phần “Tham số” của thẻ “Mã thực thi”.
Bước 9: Làm cho Bot của bạn thực hiện hành động
Cuối cùng, thêm một thẻ khác vào nút để khiến bot của bạn thực hiện hành động tùy chỉnh. Bạn có thể sử dụng các biến được lưu trong sự kiện (được chỉ định trong thẻ “Mã thực thi”) để truy cập vào kết quả của hành động tùy chỉnh và đưa chúng vào phản hồi của bot.
Hành động tùy chỉnh mẫu
Giả sử bạn muốn chatbot của mình cung cấp thông tin thời tiết hiện tại cho một địa điểm được chỉ định. Bạn có thể tạo hành động tùy chỉnh gọi API thời tiết và trả về dữ liệu thời tiết.
hằng trục = yêu cầu ( 'trục' );const getWeather = không đồng bộ ( người dùng , phiên, đối số) => {
vị trí const = args.location || 'Newyork' ;
const apiKey = 'your_weather_api_key' ;
const apiUrl = `https://api.weatherapi.com/v1/current.json?key=${apiKey}&q=${location}`;
thử {
phản hồi const = đang chờ axios.get(apiUrl);
const WeatherData = phản hồi.data;
return `Thời tiết hiện tại ở ${location} là ${weatherData.current.condition.text} với nhiệt độ ${weatherData.current.temp_c}°C.`;
} bắt (lỗi) {
trở lại 'Xin lỗi, tôi không thể \' t lấy thông tin thời tiết vào lúc này. Vui lòng thử lại sau.' ;
}
};
trả về getWeather( người dùng , phiên, đối số);
Hành động này lấy một số đối số nhất định bao gồm người dùng, phiên và đối số cung cấp bối cảnh và dữ liệu để hành động hoạt động. Trong ví dụ này, hành động tùy chỉnh “getWeather” lấy vị trí làm đối số hoặc mặc định là “New York” nếu không được cung cấp. Hành động này gọi API thời tiết bằng Axios, tìm nạp dữ liệu thời tiết và trả về thông báo chứa điều kiện thời tiết và nhiệt độ.
Ưu điểm của hành động tùy chỉnh
Các hành động tùy chỉnh trong Botpress mang lại một số lợi ích giúp nâng cao khả năng và chức năng của chatbot của bạn:
- Họ mở rộng chức năng chatbot ngoài khả năng tích hợp sẵn.
- Họ tạo ra các tương tác phù hợp để có trải nghiệm người dùng tốt hơn.
- Họ tìm nạp dữ liệu thời gian thực từ API để có phản hồi động.
- Họ tích hợp với các hệ thống phụ trợ và cơ sở dữ liệu.
- Họ xử lý các tình huống phức tạp bằng mã tùy chỉnh.
- Họ sử dụng lại các hành động trên các chatbot và luồng.
- Họ thực hiện xử lý lỗi tùy chỉnh và ghi nhật ký.
- Họ tối ưu hóa các nhiệm vụ sử dụng nhiều tài nguyên.
- Họ tận dụng các dịch vụ bên ngoài để mở rộng quy mô.
- Họ truy cập và chia sẻ các hành động tùy chỉnh được tạo sẵn.
Phần kết luận
Các hành động tùy chỉnh trong Botpress sẽ mở rộng khả năng của chatbot, cá nhân hóa các tương tác và tích hợp các API bên ngoài. Các nhà phát triển tạo các hàm JavaScript phía máy chủ và gọi chúng từ Botpress Flow Builder. Những hành động này cung cấp khả năng sử dụng lại mã, cải thiện hiệu suất và khả năng mở rộng giúp chatbot trở thành công cụ mạnh mẽ và linh hoạt hơn. Tận dụng các hành động tùy chỉnh trong Botpress tạo ra trải nghiệm chatbot sáng tạo và hấp dẫn.