6 phút đọc
Trong xu hướng phát triển của trí tuệ nhân tạo, việc kết hợp giữa mô hình ngôn ngữ lớn (LLM) và phân tích dữ liệu đang trở thành bài toán trọng tâm của nhiều doanh nghiệp. Dự án mã nguồn mở getnao/nao (được phát triển bởi nao Labs, một thành viên thuộc vườn ươm khởi nghiệp danh tiếng Y Combinator) ra đời nhằm giải quyết bài toán này bằng cách cung cấp một framework toàn diện để xây dựng và triển khai các “analytics agent” (trợ lý phân tích dữ liệu tự động). Với 1603 stars, 248 forks trên GitHub và hoạt động cập nhật gần nhất vào ngày 03/09/2026, dự án viết bằng ngôn ngữ TypeScript này đang thu hút sự chú ý lớn từ cộng đồng kỹ sư dữ liệu và nhà phát triển AI.
Xây dựng và đồng bộ hóa ngữ cảnh dữ liệu với nao-core CLI
Một trong những điểm cốt lõi của framework nao là việc thiết lập “ngữ cảnh” (context) cho trợ lý phân tích. Thay vì để AI truy vấn dữ liệu một cách tự do không định hướng, nao cho phép các nhà phát triển định hình hành vi của agent thông qua công cụ dòng lệnh nao-core cli.
Quy trình khởi tạo một dự án nao diễn ra nhanh chóng. Người dùng bắt đầu bằng việc cài đặt gói nao-core và khởi tạo dự án mới. Trong quá trình này, các cấu hình tùy chọn có thể được bỏ qua để thiết lập sau trong file cấu hình nao_config.yaml. Sau khi chuyển vào thư mục dự án, lệnh đồng bộ hóa ngữ cảnh sẽ tự động điền vào thư mục context/ các tệp tin cần thiết bao gồm dữ liệu (data), siêu dữ liệu (metadata), kho lưu trữ (repos), và các quy tắc nghiệp vụ khác.
Ngoài ra, dự án còn hỗ trợ tính năng “nao skills”. Đây là công cụ giúp người dùng tạo nhanh dự án và xây dựng ngữ cảnh phù hợp với trợ lý phân tích yêu thích của họ, giúp tối ưu hóa khả năng hiểu cấu trúc dữ liệu của mô hình.
Chạy thử nghiệm giao diện chat và kiểm thử hiệu năng truy vấn
Sau khi thiết lập và đồng bộ hóa ngữ cảnh thành công, nhà phát triển có thể khởi chạy giao diện trò chuyện của nao. Hệ thống sẽ mở một giao diện chat trực quan trên trình duyệt tại địa chỉ http://localhost:5005. Tại đây, bất kỳ người dùng nào cũng có thể đặt câu hỏi bằng ngôn ngữ tự nhiên để truy vấn dữ liệu trực tiếp từ agent phân tích.
Một tính năng kỹ thuật đáng chú ý của nao là khả năng chạy Unit test để đánh giá hiệu suất của agent trước khi đưa vào môi trường sản xuất thực tế. Người dùng có thể thực hiện việc này theo các bước sau:
- Tạo một thư mục kiểm thử có tên là
tests/. - Đưa các câu hỏi mẫu và câu lệnh SQL mong đợi tương ứng vào các file định dạng YAML.
- Chạy lệnh
nao testđể đo lường độ chính xác và hiệu năng chuyển đổi từ câu hỏi tự nhiên sang câu lệnh truy vấn dữ liệu của agent.
Phương thức triển khai linh hoạt: Docker và Self-hosted
Để đưa hệ thống vào vận hành thực tế, nao cung cấp nhiều phương thức triển khai linh hoạt từ môi trường phát triển cục bộ cho đến hệ thống đám mây quy mô lớn:
- Sử dụng Docker: Nhà phát triển có thể chạy nhanh giao diện chat của nao bằng Docker thông qua hai cách: sử dụng dự án ví dụ được đóng gói sẵn trong Docker image hoặc gắn trực tiếp thư mục dự án nao cục bộ của mình vào container. Giao diện người dùng sau đó vẫn có thể truy cập qua cổng 5005 hoặc bất kỳ URL nào được cấu hình trước.
- Triển khai tự lưu trữ (Self-hosted): Dự án hỗ trợ hướng dẫn triển khai end-to-end trên các nền tảng đám mây như Google Cloud Run kết hợp với cơ sở dữ liệu PostgreSQL để lưu trữ dữ liệu hoạt động.
- Phát triển cục bộ (Local Development): Đối với các nhà phát triển muốn can thiệp sâu vào mã nguồn của repo, họ cần tạo một file
.envtại thư mục gốc của repository để khai báo các biến môi trường tối thiểu cần thiết, sau đó truy cập giao diện phát triển tại địa chỉhttp://localhost:3000.
Framework nao được phát hành dưới giấy phép mã nguồn mở Apache 2.0 License, cho phép các cá nhân và doanh nghiệp tự do sử dụng, tùy biến và triển khai trong các dự án thương mại cũng như nội bộ.
Những điểm hạn chế và thông tin chưa được làm rõ trong tài liệu
Mặc dù tài liệu của repo getnao/nao cung cấp đầy đủ các bước cài đặt cơ bản và quy trình kiểm thử, vẫn còn một số khía cạnh kỹ thuật quan trọng chưa được làm rõ:
- Khả năng tương thích cơ sở dữ liệu: Ngoài cơ sở dữ liệu PostgreSQL được đề cập trong phần hướng dẫn triển khai trên Cloud Run, tài liệu hiện tại chưa liệt kê chi tiết danh sách các hệ quản trị cơ sở dữ liệu (DBMS) khác mà nao-core có thể hỗ trợ kết nối trực tiếp để thực hiện phân tích dữ liệu.
- Chi tiết cấu hình biến môi trường: Trong phần hướng dẫn chạy thử cục bộ (cổng 3000), tài liệu chỉ nhắc đến việc cần khai báo các biến môi trường tối thiểu cần thiết trong file
.envnhưng chưa liệt kê cụ thể tên và định dạng của các biến này (ví dụ như API Key của các mô hình ngôn ngữ lớn hoặc thông tin kết nối database). - Cơ chế xử lý của nao skills: Cách thức hoạt động chi tiết và việc tích hợp các “skills” này vào agent cụ thể để tối ưu hóa truy vấn vẫn cần phải tham khảo thêm tại trang tài liệu chính thức của dự án thay vì có sẵn thông tin tổng quan trong file README.
Nguồn tham khảo: Xem bài gốc
