Hướng dẫn Botpress: Xây dựng và Triển khai Chatbot AI

Doanh nghiệp đang gấp rút tự động hóa hỗ trợ khách hàng, đánh giá lead và quy trình nội bộ bằng các tác nhân AI. Công nghệ giờ đây đủ tốt để hữu ích, nhưng xây chatbot từ đầu đồng nghĩa với việc lắp ghép các framework như LangChain và gỡ lỗi tích hợp API. Cách đó hoạt động và có ưu điểm riêng, nhưng vòng đời phát triển sẽ chậm.

Các nền tảng như Botpress mang đến một quy trình khác. Bạn có công cụ trực quan để thiết kế luồng hội thoại. Mô hình AI bên dưới có thể giống nhau, nhưng hạ tầng để xây dựng, kiểm thử và triển khai đã sẵn sàng.

Trong bài viết này, tôi sẽ hướng dẫn bạn xây dựng tác nhân AI với Botpress. Bạn sẽ tìm hiểu kiến trúc nền tảng, xây bot đầu tiên, kết nối với các dịch vụ thực tế và triển khai lên môi trường sản xuất. Tôi cũng chia sẻ một số kỹ thuật và thực tiễn tốt tôi đúc kết được khi làm việc với nền tảng, giúp bạn tiết kiệm thời gian.

Botpress là gì?

Botpress là nền tảng để xây dựng tác nhân AI có thể trò chuyện với người dùng, kích hoạt hành động dựa trên nội dung nói chuyện và kết nối với các công cụ như Shopify, Google Sheets hoặc REST API của riêng bạn. Đối thủ cạnh tranh gồm Dialogflow, Rasa, Microsoft Bot Framework và Amazon Lex.

Tổng quan nền tảng

Botpress cung cấp cả môi trường phát triển trực quan (Botpress Studio) và điều khiển lập trình qua API. Giao diện trực quan cho phép các thành viên không kỹ thuật thiết kế luồng hội thoại, trong khi nhà phát triển có thể viết mã. Một số nền tảng như Rasa ưu tiên mã nguồn, sẽ đơn giản hơn nếu bạn là lập trình viên đơn lẻ thoải mái với YAML và Python.

Với Botpress, bạn xác định bot cần làm gì (hướng dẫn và quy trình), bot biết gì (kho kiến thức và bảng dữ liệu), và bot có thể thực hiện hành động nào (tích hợp và mã tùy chỉnh). Nền tảng xử lý phần hạ tầng: lưu trữ, mở rộng và điều phối.

Kiến trúc và các lớp của Botpress. Ảnh: Tác giả

So với xây dựng từ đầu bằng các framework như LangChain, Botpress cung cấp các thành phần sẵn sàng cho sản xuất. So với nền tảng thuần no-code, Botpress cho phép bạn viết mã thực sự khi công cụ trực quan dựng sẵn không đáp ứng được nhu cầu.

Ai sử dụng Botpress?

Nền tảng phục vụ từ nhà phát triển độc lập xây chatbot đầu tiên đến doanh nghiệp triển khai tác nhân trên nhiều kênh. Các trường hợp sử dụng phổ biến gồm tự động hóa hỗ trợ khách hàng, đánh giá lead, đặt lịch hẹn và hệ thống trợ giúp nội bộ.

Theo một câu chuyện khách hàng của Botpress, Ruby Labs báo cáo tỷ lệ giải quyết 98% sau khi áp dụng giải pháp của họ. Những con số này đến từ các nghiên cứu điển hình của nhà cung cấp và cần được diễn giải trong bối cảnh.

Thiết lập Botpress

Giờ tôi sẽ chỉ bạn cách thiết lập Botpress, cụ thể là cấu hình Botpress CLI và SDK cho quy trình "bot-as-code".

Cài đặt

Để bắt đầu, bạn cần:

• Node.js phiên bản 18 trở lên (khuyến nghị LTS)

• Trình quản lý gói: npm, pnpm hoặc yarn

• Trình soạn thảo mã. VS Code hoặc Cursor được khuyến nghị mạnh cho hỗ trợ TypeScript.

Để cài đặt, thực hiện các bước sau:

1. Mở terminal hoặc command prompt

2. Cài đặt Botpress CLI toàn cục bằng npm:

npm install -g @botpress/cliĐược hỗ trợ bởi

3. Xác minh cài đặt bằng cách kiểm tra phiên bản:

bp --versionĐược hỗ trợ bởi

Tôi khuyến nghị chạy Node.js và Botpress CLI bên trong WSL2 (Windows Subsystem for Linux) để tránh các lỗi thường gặp về đường dẫn và quyền trên Windows.

Nếu bạn gặp lỗi khi chạy bp trong PowerShell, bạn có thể cần điều chỉnh chính sách thực thi. Mở PowerShell với quyền Administrator và chạy: Set-ExecutionPolicy RemoteSigned.

Phát triển cục bộ

Phát triển cục bộ cho phép bạn dùng GitHub để quản lý phiên bản, TypeScript để đảm bảo kiểu, và các công cụ như GitHub Copilot để tự động sinh mã. Cách tiếp cận này xem chatbot như bất kỳ dự án phần mềm nào khác.

Cấu hình ban đầu

Sau khi cài CLI, bạn cần kết nối môi trường cục bộ với tài khoản Botpress Cloud của bạn.

1. Xác thực

Đăng nhập vào tài khoản để liên kết khóa CLI của bạn.

bp loginĐược hỗ trợ bởi

Lệnh này sẽ mở cửa sổ trình duyệt để ủy quyền cho CLI.

2. Khởi tạo dự án 

Tạo thư mục mới cho bot và khởi tạo cấu trúc.

mkdir my-first-bot
cd my-first-bot
bp initĐược hỗ trợ bởi

Làm theo hướng dẫn để chọn mẫu TypeScript.

3. Thiết lập biến môi trường 

Tạo tệp .env ở thư mục gốc dự án để lưu khóa nhạy cảm (như thông tin kết nối cơ sở dữ liệu hoặc khóa API bên thứ ba). Không bao giờ commit tệp này lên Git.

4. Triển khai để thử nghiệm 

Đẩy bot cục bộ lên cloud để thử nghiệm trong Studio.

bp deployĐược hỗ trợ bởi

Bắt đầu với Botpress Studio

Botpress Studio là nơi bạn thực sự xây dựng bot.

Môi trường phát triển trực quan

Studio mở ra với một canvas hiển thị luồng hội thoại của bot. Mỗi node đại diện cho một bước trong hội thoại, và các kết nối giữa node thể hiện cách người dùng di chuyển qua bot. Nhấp chuột phải ở bất kỳ đâu trên canvas để tạo node mới.

Thanh bên trái hiển thị workflows, system flows, biến và schema. Thanh bên phải hiển thị inspector cho node đã chọn, nơi bạn có thể cấu hình hướng dẫn và hành động đính kèm. Dùng trình giả lập ở dưới cùng để kiểm thử bot theo thời gian thực.

Mẫu Botpress

Botpress Hub chứa các mẫu sẵn sàng cho sản xuất cho hỗ trợ khách hàng, đặt lịch hẹn, đánh giá lead và hơn thế nữa. Mẫu Kitchen Sink minh họa các khái niệm nâng cao như tải dữ liệu người dùng, định tuyến workflow và chuyển giao cho tác nhân người. Tùy chỉnh hướng dẫn, thay kho kiến thức của bạn vào và triển khai.

Tạo bot đầu tiên

Hãy xây một bot hỗ trợ khách hàng đơn giản. Tạo bot mới và đặt tên "support-bot". Bỏ qua trình hướng dẫn và vào thẳng Studio.

Trong tab Home (nếu không thấy, hãy nối node bắt đầu của bạn với một autonomous node mới), thêm hướng dẫn:

You are a helpful customer support agent. Answer questions about our products and services using the knowledge base. Be friendly, concise, and professional. If you can't answer a question, offer to connect the user with a human agent.Được hỗ trợ bởi

Bây giờ thêm kho kiến thức. Nhấp vào Knowledge Bases ở thanh bên trái, rồi Create Knowledge Base. Chọn Website làm loại nguồn và nhập URL website công ty bạn. Botpress sẽ thu thập và trích xuất thông tin.

Quay lại tab Home, cuộn đến Knowledge Bases và bật kho kiến thức bạn vừa tạo. Điều này cho phép autonomous node truy cập thông tin đó.

Hãy thử trong trình giả lập. Hỏi "Giờ làm việc của bạn là gì?" hoặc "Tôi đổi trả sản phẩm như thế nào?" Bot sẽ tìm trong kho kiến thức của bạn và phản hồi thông tin phù hợp.

Kiểm thử bot hỗ trợ khách hàng trong trình giả lập Botpress với phản hồi thời gian thực

Bot cơ bản này đã xử lý được khá nhiều hỗ trợ khách hàng. Nó trả lời câu hỏi từ website của bạn, duy trì ngữ cảnh hội thoại và phản hồi tự nhiên. Bạn xây nó trong khoảng năm phút.

Hiểu ngôn ngữ tự nhiên

Nếu bạn từng xây chatbot trước năm 2023, có thể bạn nhận thấy điều gì đó khác: Bạn không huấn luyện bộ phân loại ý định hay viết quy tắc trích xuất thực thể như với hệ thống NLU (trước thời LLM). (Và nếu bạn mới bắt đầu, chỉ cần biết rằng các nền tảng cũ đòi hỏi rất nhiều công việc huấn luyện ban đầu mà Botpress bỏ qua hoàn toàn.)

Cụ thể là: Botpress sử dụng mô hình ngôn ngữ lớn để hiểu ngôn ngữ tự nhiên. Bạn viết hướng dẫn mô tả bot cần làm gì, và LLM xử lý nhận diện ý định, trích xuất thực thể và hiểu ngữ cảnh khi chạy.

Điều này thay đổi cách bạn cấu hình. Các thực thể phổ biến như ngày, giờ và thông tin liên hệ hoạt động ngay vì LLM vốn đã hiểu các mẫu này. Thực thể đặc thù theo miền cần cách xử lý khác: bạn mô tả yêu cầu trong hướng dẫn, và tùy chọn định nghĩa schema. LLM diễn giải các yêu cầu này giống như mọi thứ khác.

Xây dựng logic hội thoại nâng cao

Bot đơn giản trả lời câu hỏi. Bot nâng cao đưa ra quyết định và tích hợp với hệ thống bên ngoài. Botpress cung cấp công cụ để xây cả hai, dù tôi cho rằng hầu hết đội ngũ thường phức tạp hóa mọi thứ quá sớm. Thường bạn không cần logic workflow cho đến khi đã chứng minh phần Hỏi & Đáp cơ bản vận hành tốt.

Kiến trúc workflow

Workflows tổ chức logic của bot thành các phần có thể quản lý. Workflow chính xử lý luồng hội thoại chủ đạo. Các workflow con xử lý tác vụ cụ thể, như đặt lịch hẹn hoặc xử lý trả hàng.

Các node trong workflow đại diện cho những bước riêng biệt. Node tiêu chuẩn thực thi chuỗi hành động từ trên xuống dưới. Autonomous node dùng LLM để quyết định hành động nào cần thực hiện và theo thứ tự nào. Entry và exit node đánh dấu nơi người dùng vào và rời workflow con.

Kiến trúc workflow mô-đun của Botpress. Ảnh: Tác giả

Logic hội thoại theo mô-đun nghĩa là chia nhỏ tác vụ phức tạp thành các phần nhỏ, có thể tái sử dụng. Xây một workflow thu thập thông tin thanh toán một lần, rồi tái sử dụng trong quy trình thanh toán, đăng ký và quyên góp. Điều này giảm trùng lặp và giúp bảo trì dễ hơn.

Mẫu router điều hướng người dùng đến workflow phù hợp dựa trên nhu cầu. Sau lời chào ban đầu, phân loại ý định của người dùng và định tuyến họ đến workflow con đúng. Cách này giữ cho mỗi workflow tập trung vào một tác vụ đơn lẻ.

Thực tiễn tốt trong thiết kế hội thoại

Bước đột phá trong hiểu ngôn ngữ là có thật, nhưng sẽ không cứu vãn một bot cấu trúc kém. Bạn vẫn cần luồng hội thoại rõ ràng và thiết kế có chủ đích. Khác biệt thực sự là bạn thiết kế ở mức cao hơn bằng cách định nghĩa bot cần làm gì thay vì huấn luyện nó nhận diện cụm từ cụ thể.

Bắt đầu bằng lời chào rõ ràng đặt kỳ vọng. Thiết kế đường đi “thuận lợi” trước, rồi thêm xử lý lỗi. Giữ mỗi autonomous node tập trung vào một nhiệm vụ khái niệm. Dùng bước xác nhận cho hành động quan trọng như thanh toán. Lập bản đồ hành trình người dùng trước khi xây workflow để xác định điểm quyết định và thông tin cần thiết.

Tôi cũng đọc rằng quá nhiều lời nhắc kiểu "bạn có chắc không?" khiến người dùng dần bấm qua mà không đọc kỹ. “Khi mọi hành động đều cần xác nhận, thì không xác nhận nào còn hiệu quả” có lẽ là một nguyên tắc hay. Hãy dành yêu cầu xác nhận cho những thao tác thực sự không thể đảo ngược: thanh toán, xóa tài khoản, mất dữ liệu.

Tự động hóa workflow

Ngoài những điều cơ bản ở đây, Botpress hỗ trợ hook cho tự động hóa vòng đời (chạy mã khi hội thoại bắt đầu, khi gửi tin nhắn, v.v.) và workflow theo lịch cho tác vụ định kỳ như nhắc lịch hẹn. Đây là các công cụ mạnh mẽ, nhưng cũng là nơi mọi thứ nhanh chóng trở nên phức tạp.

Tích hợp và Hệ sinh thái Plugin

Bot của Botpress trở nên mạnh mẽ khi kết nối với dịch vụ bên ngoài. Botpress Hub cung cấp các tích hợp dựng sẵn cho công cụ phổ biến, và bạn có thể xây tích hợp tùy chỉnh cho hệ thống nội bộ.

Tích hợp dựng sẵn

Hub bao gồm tích hợp cho nền tảng nhắn tin (WhatsApp, Slack, Microsoft Teams, Telegram), CRM (HubSpot, Salesforce), công cụ năng suất (Google Calendar, Google Drive, SharePoint) và bộ xử lý thanh toán (Stripe). Nếu bạn cần kết nối với dịch vụ phổ biến, rất có thể đã có tích hợp sẵn.

Cài đặt một tích hợp sẽ thêm thẻ mới vào khay thẻ của bạn. Ví dụ, tích hợp CRM cung cấp các thẻ để tạo liên hệ, cập nhật giao dịch và tìm kiếm bản ghi. Kéo các thẻ này vào workflow để kết nối bot của bạn.

Cấu hình diễn ra trong phần cài đặt tích hợp. Bạn cung cấp thông tin xác thực API, chọn dữ liệu cần truy cập và ánh xạ biến của bot tới các trường bên ngoài. Tích hợp xử lý xác thực, giới hạn tốc độ và khôi phục lỗi.

Tích hợp tùy chỉnh

Với hệ thống nội bộ hoặc yêu cầu đặc thù, hãy xây tích hợp tùy chỉnh bằng integration SDK. Định nghĩa giao diện tích hợp, triển khai logic kết nối và xử lý xác thực. SDK cung cấp tiện ích cho luồng OAuth và xử lý webhook. Kiểm thử cục bộ với tiện ích kèm theo trước khi triển khai. Lưu thông tin xác thực trong biến cấu hình, xác thực mọi đầu vào và triển khai xử lý lỗi phù hợp.

Mô hình giá và Tùy chọn triển khai

Giá Botpress được cấu trúc dựa trên mức sử dụng AI thay vì tính phí theo tin nhắn hay hội thoại. Đắt hay không tùy vào lưu lượng và trường hợp sử dụng của bạn. Bot hỗ trợ khách hàng đơn giản chúng ta đã xây trước đó—trả lời câu hỏi từ kho kiến thức—thực hiện một hoặc hai cuộc gọi LLM cho mỗi tin nhắn và tốn rất ít chi phí, điều này không bất ngờ vì chúng ta xây rất nhanh và chỉ là ví dụ.

Một bot phức tạp hơn cũng tìm kiếm CRM, kiểm tra tồn kho và tính phí vận chuyển sẽ thực hiện thêm các cuộc gọi LLM để xử lý dữ liệu đó, khiến chi phí AI tăng tương ứng. Nền tảng chuyển tiếp chi phí AI theo mức giá nhà cung cấp không cộng thêm, nên chi tiêu thực tế của bạn phụ thuộc vào số cuộc gọi LLM mỗi hội thoại cần và mô hình bạn chọn.

Cấu trúc giá

Botpress cung cấp nhiều gói đăng ký với các tính năng và trường hợp sử dụng khác nhau.

Bot nhà hàng tôi xây trước dùng gói miễn phí. Mô hình trả theo mức dùng cho phép bạn thử nghiệm mà không cần cam kết hàng tháng, và bạn chỉ bắt đầu trả phí khi bot thực sự xử lý hội thoại.

Triển khai và mở rộng

Botpress tự động mở rộng khi lưu lượng tăng, xử lý ổn định từ 10 đến 10.000 hội thoại. Add-on mở rộng chức năng với lưu trữ bổ sung, tăng giới hạn và tích hợp cao cấp. Tính năng Enterprise bao gồm SSO, nhật ký kiểm toán, kiểm soát truy cập theo vai trò và hỗ trợ chuyên trách.

Cộng đồng và Hỗ trợ

Tài liệu chính thức bao gồm ví dụ mã, video hướng dẫn và tài liệu tham khảo.

Máy chủ Botpress Discord có hơn 30.000 thành viên đặt câu hỏi, chia sẻ bot và học hỏi từ các nhà phát triển khác. Đội ngũ Botpress tham gia tích cực. Thảo luận trên GitHub là nơi cho yêu cầu tính năng và báo lỗi. Bạn cũng sẽ tìm thấy các mẫu do cộng đồng xây dựng bao phủ các trường hợp sử dụng phổ biến, nên bạn không phải lúc nào cũng phải bắt đầu từ con số 0.

Kết luận

Bot nhà hàng chúng ta xây khá đơn giản, nhưng cách tiếp cận tương tự áp dụng tốt cho dự án phức tạp hơn. Trình biên tập workflow trực quan và hệ thống tích hợp mở rộng tốt dù bạn xây bot FAQ cơ bản hay thứ tinh vi hơn.

Điều cốt lõi là bắt đầu nhỏ. Xây một bot làm tốt một việc, triển khai, học từ việc sử dụng thực tế và mở rộng dần. Đừng cố tự động hóa mọi thứ cùng lúc. Tập trung vào tác vụ mang lại nhiều giá trị nhất với ít phức tạp nhất.

Để xây kỹ năng AI và chatbot, hãy xem khóa Xây dựng Chatbot bằng Python và lộ trình Những điều cơ bản về ChatGPT của chúng tôi. Để có kỹ thuật prompt nâng cao chất lượng phản hồi của bot, xem Hiểu về Prompt Engineering. Với tự động hóa workflow và tác nhân AI vượt ra ngoài chatbot, hãy khám phá hướng dẫn n8n: Hướng dẫn với Ví dụ Thực tiễn và phần code-along Xây Dựng Tác Nhân AI Đầu Tiên với n8n.