- Thẻ Mã Thực thi trong Botpress cho phép bạn chạy JavaScript tùy chỉnh bên trong quy trình làm việc của bot, kích hoạt các lệnh gọi API động, xử lý dữ liệu và logic được cá nhân hóa ngoài các hành động tích hợp tiêu chuẩn.
- Các trường hợp sử dụng chính bao gồm các yêu cầu API động, xử lý hậu kỳ LLM đầu ra, giới hạn tốc độ, kiểm tra quyền và kết nối các lệnh gọi API nhiều bước, cho phép các tác nhân AI xử lý các quy trình làm việc phức tạp một cách chính xác.
- Các biện pháp tốt nhất bao gồm bảo mật khóa API trong các biến môi trường, xử lý lỗi và thời gian chờ một cách hợp lý và xây dựng logic có điều kiện cho các hoạt động bot mạnh mẽ, an toàn — đảm bảo tích hợp API trơn tru và có khả năng mở rộng.
Các tác nhân AI chỉ mạnh mẽ như dữ liệu mà chúng có thể truy cập. Trong khi các mô hình ngôn ngữ lớn ( LLMs ) tạo phản hồi từ dữ liệu đào tạo, chúng không thể truy xuất giá cổ phiếu theo thời gian thực, xử lý thanh toán hoặc truy cập thông tin chi tiết về CRM, trừ khi được tích hợp với API.
API cho phép các tác nhân AI truy cập dữ liệu thời gian thực, thực hiện logic và kích hoạt hành động. Để tận dụng tối đa, các tác nhân cần mã tùy chỉnh.
Thẻ 'Thực thi mã' trong Botpress Studio cho phép bạn viết và thực thi JavaScript bên trong quy trình làm việc của bot—xử lý liền mạch các lệnh gọi API, xử lý dữ liệu và tùy chỉnh hành vi của bot.
Thẻ mã thực thi là gì?
Thẻ mã thực thi trong Botpress cho phép các nhà phát triển chạy JavaScript tùy chỉnh trong luồng của bot. Nó cho phép các chức năng sau:
- Triển khai logic tùy chỉnh: Bạn có thể thực hiện các phép tính phức tạp hoặc chuyển đổi dữ liệu theo những cách không được thực hiện trong các hành động tiêu chuẩn.
- Tương tác động: Điều chỉnh phản hồi dựa trên dữ liệu người dùng hoặc tính toán thời gian thực.
- Tích hợp dữ liệu: Kết nối liền mạch với các dịch vụ của bên thứ ba để lấy hoặc gửi dữ liệu.
- Quản lý trạng thái: Truy cập và sửa đổi trạng thái của bot để duy trì ngữ cảnh và cá nhân hóa các tương tác.
- Xử lý lỗi: Triển khai quản lý lỗi tùy chỉnh để đảm bảo hoạt động mạnh mẽ.
Thẻ Execute Code có các gợi ý mã do AI tạo ra . Nhập lời nhắc—như tìm nạp dữ liệu API—và hệ thống sẽ tạo JavaScript ngay lập tức. Sau đó, bạn có thể xem lại, chỉnh sửa và tinh chỉnh khi cần, giúp tăng tốc quá trình phát triển.
Tại sao tác nhân AI cần API bên ngoài?
Các tác nhân AI chỉ hữu ích khi dữ liệu và dịch vụ mà chúng truy cập. Mặc dù chúng có thể xử lý dữ liệu đầu vào và tạo phản hồi, nhưng chúng thiếu kiến thức thời gian thực, khả năng giao dịch và tích hợp sâu mà không có API bên ngoài.
Cho dù bạn đang tích hợp dữ liệu thời gian thực, tự động hóa quy trình làm việc hay tăng cường bảo mật, API đều giúp bot của bạn thông minh hơn, phản hồi nhanh hơn và tích hợp hơn.
5 cách sử dụng thẻ mã thực thi
Execute Code Card trong Botpress Studio hợp lý hóa các hoạt động của tác nhân AI. Việc thêm nó vào quy trình làm việc của bạn rất đơn giản — hãy làm theo hướng dẫn nhanh này:
Sau khi thêm vào, đây là những cách chính để tận dụng nó trong quy trình làm việc của bạn.
1. Cuộc gọi API động
Thay vì sử dụng các lệnh gọi API tĩnh, Thẻ thực thi cho phép bạn sửa đổi các yêu cầu một cách linh hoạt dựa trên ý định của người dùng, ngữ cảnh của bot hoặc các cuộc trò chuyện trước đó.
Ví dụ: Lấy dữ liệu tùy chỉnh dựa trên sở thích của người dùng.
Yêu cầu: Chatbot du lịch cần lấy giá khách sạn dựa trên điểm đến , ngày đi và ngân sách của người dùng.
.webp)
Lưu ý: Thẻ thực thi mã có thể tạo mã từ ngôn ngữ tự nhiên. Tuy nhiên, hãy luôn xác minh các biến được sử dụng trong mã bạn tạo trước khi triển khai quy trình làm việc vào sản xuất.
2. Hậu xử lý trên LLM Phản hồi
Trong khi Botpress cung cấp các hành động AI tích hợp, đôi khi bạn cần phải tinh chỉnh các phản hồi trước khi hiển thị cho người dùng—cho dù đó là định dạng đầu ra, lọc một số từ nhất định hay cấu trúc dữ liệu rõ ràng hơn.
Ví dụ: Viết lại không có cấu trúc LLM phản hồi vào một bảng/định dạng được xác định.
Lời nhắc: AI sẽ lấy các đề xuất về nhà hàng từ API và tôi muốn bạn định dạng chúng thành một bảng sạch trước khi hiển thị.
.webp)
3. Giới hạn tỷ lệ và thực hiện có điều kiện
Một số API, bao gồm ví kỹ thuật số, có giới hạn sử dụng. Với Execute Code Card, bạn có thể kiểm soát tương tác của người dùng bằng cách áp dụng giới hạn tỷ lệ, thiết lập các phương án dự phòng và thêm logic có điều kiện dựa trên tính khả dụng của API.
Ví dụ: Kiểm tra việc sử dụng API trước khi gọi nó
Prompt: Check API quota from https://api.monitoring.com/usage?apikey=${workflow.userApiKey} before making a request. If fewer than 5 requests remain, return an error; otherwise, proceed. Ensure proper error handling in case of failures.
.webp)
4. Xử lý quyền
Nếu bot của bạn cần xác minh người dùng trước khi cấp quyền truy cập vào một số tính năng nhất định, thẻ cho phép các luồng xác thực tùy chỉnh vượt ra ngoài Botpress tùy chọn mặc định của.
Ví dụ: Kiểm tra trạng thái đăng ký của người dùng trước khi cung cấp phản hồi AI
Prompt: Check a user's subscription via https://billing.example.com/user/{userId}. If on a free plan, prompt an upgrade; otherwise, allow access. Handle errors.
.webp)
5. Chuỗi API nhiều bước
Đôi khi, bot cần kết hợp dữ liệu từ nhiều API trước khi gửi phản hồi cuối cùng. Thẻ cho phép các quy trình làm việc phức tạp nhiều bước bằng cách tìm nạp, chuyển đổi và truyền dữ liệu một cách động.
Ví dụ: Lấy Thời tiết + Đặt chỗ Nhà hàng để Đề xuất Thời gian Khởi hành Tốt nhất
Yêu cầu: Lấy dữ liệu thời tiết và giao thông cho workflow.city bằng workflow.userApiKey. Dựa trên các điều kiện, trả về thời gian di chuyển tốt nhất. Xử lý lỗi.
.webp)
Tích hợp API liền mạch cho các tác nhân AI
Các tác nhân AI hoạt động tốt nhất khi chúng có thể khai thác dữ liệu thời gian thực, tự động hóa quy trình làm việc và kết nối với các dịch vụ bên ngoài.
Botpress Hub giúp việc này trở nên liền mạch với các tích hợp API được xây dựng sẵn, các công cụ tự động hóa và các trình kết nối sẵn sàng sử dụng—để bạn có thể tập trung vào việc xây dựng chứ không phải cấu hình.
Hãy bắt đầu tích hợp các API mạnh mẽ vào quy trình làm việc của bot ngay hôm nay—hoàn toàn miễn phí.
Câu hỏi thường gặp
1. Tôi có cần biết JavaScript để sử dụng Thẻ thực thi mã hiệu quả không?
Bạn không cần kiến thức sâu về JavaScript để sử dụng Thẻ thực thi mã hiệu quả. Botpress cung cấp các đề xuất mã hỗ trợ bởi AI, để bạn mô tả những gì bạn muốn và tạo ra mã khởi đầu mà bạn có thể điều chỉnh với nỗ lực tối thiểu.
2. Có mẫu hoặc đoạn mã mẫu nào cho các tích hợp API phổ biến không?
Đúng, Botpress cung cấp các ví dụ tích hợp và đoạn mã mẫu cho các tích hợp API phổ biến như CRM và cổng thanh toán. Bạn cũng có thể duyệt qua các diễn đàn cộng đồng để tìm các mẫu mã sẵn sàng sử dụng.
3. Tôi có thể sử dụng Thẻ thực thi mã mà không cần kinh nghiệm tích hợp API trước đó không?
Có, bạn có thể sử dụng Thẻ Thực thi Mã mà không cần kinh nghiệm tích hợp API trước đó. Giao diện thân thiện với người mới bắt đầu và Botpress Trợ lý AI của có thể tạo mã và giải thích mã, giúp người không phải là nhà phát triển cũng có thể dễ dàng học được.
4. Thẻ xử lý các yêu cầu API chạy lâu hoặc hết thời gian chờ như thế nào?
Thẻ thực thi mã hỗ trợ JavaScript không đồng bộ bằng cách sử dụng async/await, nhưng bạn cần xử lý thủ công các lỗi và thời gian chờ. Thực hành tốt nhất bao gồm việc gói các lệnh gọi API trong thử/bắt chặn và xác định luồng dự phòng nếu phản hồi bị trì hoãn hoặc không thành công.
5. Thực hành tốt nhất để triển khai xác thực và ủy quyền bằng thẻ là gì?
Khi triển khai xác thực và ủy quyền trong Thẻ thực thi mã, bạn nên lưu trữ khóa API hoặc mã thông báo trong Botpress biến môi trường, gửi chúng qua các tiêu đề bảo mật và bao gồm logic để xác thực vai trò hoặc quyền của người dùng trước khi thực hiện các hành động nhạy cảm.
%20(1).webp)
