Thực hiện Code Card: Tích hợp API tùy chỉnh vào AI Agents

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.

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ị.

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.

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.

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.