Hiểu các kiểu dữ liệu cho biến
Trước khi đi sâu vào các khía cạnh thực tế của việc sử dụng các biến, hãy làm quen với các loại dữ liệu có sẵn khác nhau trong Botpress.
- Sợi dây: Chuỗi được sử dụng để lưu trữ văn bản có thể bao gồm các chữ cái, số hoặc ký tự đặc biệt. Chúng thường được sử dụng để lưu trữ tên người dùng hoặc tin nhắn do AI tạo.
- Boolean: Boolean chỉ có thể chứa hai giá trị – đúng hoặc sai. Chúng rất lý tưởng để lưu trữ thông tin nhị phân, chẳng hạn như liệu người dùng có phải là khách hàng cũ hay người dùng muốn hỏi điều gì khác.
- Con số: Như tên cho thấy, các biến số được sử dụng để lưu trữ các giá trị số có thể là số nguyên hoặc số có vị trí thập phân. Chúng rất hữu ích để lưu trữ số điện thoại, mã vùng và dữ liệu số khác.
- Ngày: Các biến Ngày sử dụng định dạng ngày/giờ ISO 8601. Nó đại diện cho một ngày hoặc một ngày và giờ.
- Sự vật: Biến đối tượng là tập hợp các cặp khóa-giá trị tương tự như từ điển hoặc bản đồ. Chúng có giá trị để lưu trữ các cấu trúc dữ liệu phức tạp như hồ sơ người dùng hoặc kết quả của lệnh gọi API.
- Mảng: Các mảng được sử dụng để lưu trữ tập hợp các biến tương tự. Chúng có thể chứa các chuỗi hoặc đối tượng, khiến chúng trở nên linh hoạt cho nhiều trường hợp sử dụng khác nhau, chẳng hạn như lưu trữ tin nhắn trước đây của người dùng hoặc cung cấp các tùy chọn để người dùng lựa chọn.
- liệt kê: Đây là một biến có tập hợp giới hạn các lựa chọn được xác định trước. Chúng phù hợp cho các tình huống như lưu trữ các ngày trong tuần hoặc các món có sẵn trên thực đơn đồ ăn.
- Mẫu: Các biến mẫu sử dụng Biểu thức chính quy (Regex) để lưu trữ các mẫu đặc biệt có thể được sử dụng để khớp với các từ hoặc số cụ thể. Chúng rất tiện lợi cho việc lưu trữ số tài khoản hoặc số chuyến bay.
Hiểu phạm vi biến
Nhiều loại biến khác nhau được bao gồm trong Botpress và chúng khác nhau tùy thuộc vào nơi chúng có thể truy cập được trong luồng chatbot của bạn. Hãy cùng khám phá các phạm vi biến khác nhau, bắt đầu từ phạm vi hạn chế nhất đến phạm vi rộng nhất:
Biến quy trình công việc
Các biến này được xác định và sử dụng trong một hoặc cùng một quy trình công việc. Chúng rất tuyệt vời cho các luồng sử dụng một lần như lưu trữ kết quả đầu ra của tác vụ AI, câu trả lời cho câu hỏi của người dùng hoặc sắp xếp dữ liệu từ các lệnh gọi API.
Có thể làm theo các bước này để tạo biến quy trình làm việc:
Bước 1. Chọn quy trình làm việc thích hợp trong menu “Explorer”.
Bước 2. Nhấp đúp vào vùng trống trong trình chỉnh sửa quy trình làm việc sẽ mở bảng Thanh tra.
Bước 3. Chỉ định tên biến, chọn kiểu dữ liệu của biến và nhấp vào nút “Thêm” để tạo biến.
Bạn có thể thêm giá trị mặc định (ban đầu) vào biến của mình từ phần “Cài đặt bổ sung”.
Các biến của quy trình làm việc đầu vào và đầu ra
Để trao đổi thông tin, quy trình làm việc có thể có các biến đầu vào và đầu ra. Đầu vào được sử dụng để nhận thông tin từ các nguồn bên ngoài hoặc các quy trình công việc khác, trong khi đầu ra cung cấp thông tin cho các nguồn bên ngoài hoặc các quy trình công việc khác. Điều này cho phép giao tiếp và trao đổi dữ liệu linh hoạt hơn trong bot.
Các bước này có thể được thực hiện để đánh dấu một biến đầu vào:
Bước 1. Tạo biến bên trong quy trình làm việc.
Bước 2. Chọn biến bằng cách nhấp vào nút nhập của quy trình làm việc trong bảng Thanh tra.
Các bước này có thể được thực hiện để đánh dấu một biến đầu ra:
Bước 1. Tạo biến bên trong quy trình làm việc.
Bước 2. Chọn biến bằng cách nhấp vào nút thoát của quy trình làm việc trong bảng Thanh tra.
Biến phiên
Tất cả các luồng đều có thể truy cập vào các biến này nhưng chỉ cho một cuộc trò chuyện duy nhất. Chúng lý tưởng để lưu trữ dữ liệu được sử dụng trong suốt cuộc trò chuyện, chẳng hạn như lịch sử trò chuyện, các mặt hàng được thu thập trong giỏ hàng ảo hoặc dữ liệu tạm thời từ lệnh gọi API.
Để tạo một biến phiên, bạn có thể viết đoạn mã sau:
session.variablename = 'Xin chào các bạn!' ;Để sử dụng biến của bạn trong thẻ văn bản, chúng tôi cần đóng biến đó trong dấu ngoặc nhọn, ví dụ: {{session.variablename}} .
Biến người dùng
Các biến người dùng sẽ theo dõi người dùng giữa các cuộc trò chuyện, cho phép dữ liệu được duy trì qua nhiều lần tương tác với chatbot. Chúng hoàn hảo để lưu trữ thông tin vẫn có liên quan đến người dùng theo thời gian, chẳng hạn như thông tin cá nhân, thẻ từ các cuộc trò chuyện trước đây hoặc tùy chọn ngôn ngữ.
Để tạo một biến người dùng:
Bước 1. Mở “Cài đặt Chatbot” từ biểu tượng Botpress nằm ở góc trên bên trái.
Bước 2. Chọn “Biến” từ các tab.
Bước 3. Xác định biến người dùng bằng cách đặt tên và chỉ định loại dữ liệu.
Bạn có thể sử dụng @user.variablename hoặc {{user.variablename}} để chỉ biến “Người dùng” trong thẻ văn bản.
Biến bot
Tất cả người dùng trong chatbot đều có quyền truy cập vào các biến này trong tất cả các cuộc hội thoại. Chúng thường được sử dụng để lưu trữ thông tin và cấu hình của nhà phát triển như lưu trữ điểm cuối cho lệnh gọi API, số phiên bản của bot hoặc tên của nó.
Hãy làm theo các bước sau để tạo biến Bot:
Bước 1. Chọn “Cài đặt Chatbot” bằng cách nhấp vào biểu tượng Botpress ở góc trên cùng bên trái.
Bước 2. Chọn “Biến” từ các tab.
Bước 3. Chỉ định tên và loại dữ liệu của biến bot.
Giống như các biến người dùng, @bot.variablename hoặc bot.variablename có thể được sử dụng để chỉ các biến bot trong thẻ.
Biến cấu hình
Chúng là một loại biến bot an toàn đặc biệt. Bạn có thể quản lý chúng từ Bảng điều khiển trên đám mây và không cần mở bot. Các biến cấu hình lý tưởng để lưu trữ thông tin nhạy cảm như mã thông báo API, địa chỉ IP riêng hoặc thông tin xác thực cơ sở dữ liệu.
Để tạo một biến cấu hình:
Bước 1. Mở “Cài đặt Chatbot” từ biểu tượng Botpress nằm ở góc trên bên trái.
Bước 2. Nhấp vào tab “Biến”.
Bước 3. Thêm một biến cấu hình và cung cấp tên cũng như giá trị của nó.
Để truy cập các biến cấu hình trong mã, bạn có thể sử dụng “env.key” trong đó “key” đại diện cho tên biến cấu hình cần truy xuất.
Sử dụng các biến trong mã
Dấu ngoặc nhọn “{{ }}” hoặc ký hiệu @ là không cần thiết khi sử dụng các biến trong mã. Cú pháp để truy cập các biến trong mã tuân theo mẫu “variabletype.variablename”. Ví dụ:
Mã số:
- quy trình làm việc.phoneNumber
- session.userAcctId
- người dùng.firstName
- bot.endpoint
- env.apiKey
Các biến có thể được gán giá trị hoặc được cập nhật trong mã. Nhưng điều quan trọng là phải đảm bảo rằng giá trị được gán khớp với kiểu dữ liệu của biến để tránh lỗi.
Phần kết luận
Các biến là nền tảng của các tương tác năng động và được cá nhân hóa trong Botpress. Bằng cách sử dụng các loại dữ liệu khác nhau và hiểu được phạm vi thay đổi, nhà phát triển có thể tạo ra các chatbot với khả năng mạnh mẽ. Cho dù bạn cần lưu trữ thông tin người dùng, kết nối với API hay truyền dữ liệu giữa các quy trình công việc và các biến trong Botpress đều mang lại sự linh hoạt và khả năng kiểm soát cần thiết.