Tài liệu NocoBase 3 tiếng Việt, do OXMODE biên dịch

3Tài liệu NocoBase 3

NocoBase 3Bắt đầu nhanh

Khởi động ứng dụng của bạn bằng một cuộc hội thoại.

Cài Skill, rồi để coding agent tạo, cấu hình và khởi động một ứng dụng NocoBase 3 cục bộ. Sau đó tiếp tục xây tính năng trong cùng cuộc hội thoại.

So sánh NocoBase 2 và 3 Hướng dẫn tạo ứng dụng

  • Môi trường cục bộNode.js 24+ · pnpm 11
  • Coding agentCó hỗ trợ Skill, chẳng hạn Claude Code hoặc Codex
  • WindowsDùng WSL

01Cài Skill

Chạy trong terminal cục bộ để Agent của bạn biết cách tạo ứng dụng NocoBase 3.

Terminal cục bộ
npx skills@latest add nocobase/skills-v3 --skill nocobase-create-app -g

Chọn Agent của bạn khi được hỏi, rồi mở một phiên mới để nó nạp Skill.

Những gì được cài đặt? Cập nhật thế nào?

nocobase/skills-v3 cung cấp các Skill cho NocoBase 3. Lệnh trên cài Skill toàn cục nocobase-create-app, dùng để tạo ứng dụng.

Ứng dụng được tạo mang theo AGENTS.md và .agents/skills/ khớp với phiên bản đã cài. Nếu thiếu Skill trong ứng dụng, chạy pnpm nocobase skills sync trong thư mục ứng dụng rồi mở phiên Agent mới.

02Tạo và khởi động ứng dụng

Mở Agent trong một thư mục trống, ví dụ mkdir my-app && cd my-app, rồi gửi:

Gửi cho Agent của bạn
Hãy tạo một ứng dụng NocoBase 3 để phát triển cục bộ trong thư mục trống này.
Dùng template mặc định và SQLite, theo hướng dẫn tạo ứng dụng.
Hoàn tất cài đặt và kiểm tra, khởi động ứng dụng, rồi cho tôi biết cần mở URL nào và đăng nhập lần đầu thế nào.

Agent gọi công cụ tạo ứng dụng, cài dependency, khởi tạo cấu hình và khởi động ứng dụng, rồi đưa bạn URL và thông tin đăng nhập. Mặc định cục bộ là nocobase / admin123; hãy đổi mật khẩu sau lần đăng nhập đầu.

Không dùng Agent?

Từ thư mục cha nơi bạn để các dự án, chạy lệnh sau, rồi làm tiếp theo Tạo ứng dụng › Không dùng Agent:

Terminal cục bộ
PNPM_CONFIG_MINIMUM_RELEASE_AGE=0 pnpm create @nocobase/app@beta my-app --template-tag=beta

Phát triển cùng Agent

Từ yêu cầu đầu tiên đến tính năng nghiệp vụ chạy được

Mở Agent trong thư mục ứng dụng và giải thích người dùng cần làm được gì, các ràng buộc nghiệp vụ và cách bạn đánh giá là đã xong. Agent làm theo AGENTS.md và các Skill của dự án để xây schema, API, trang, phân quyền và các kiểm tra.

  1. Mô tả bằng ngôn ngữ nghiệp vụBạn không cần biết API nội bộ nào trước khi mô tả yêu cầu.
  2. Dùng thử và tinh chỉnhTạo một bản ghi, thay đổi nó, tải lại trang, rồi mô tả các tinh chỉnh một cách tự nhiên.
  3. Chia nhỏ và kiểm chứngChia yêu cầu lớn thành các thay đổi kiểm chứng được, review phần hiện thực và kiểm chứng kết quả thực tế.

Xây ứng dụng đầu tiên Phát triển cùng Agent

Một cuộc hội thoại liên tục với AgentỨng dụng công việc nhóm trong tutorial
  1. 01
    Mô tả nghiệp vụ

    Hãy xây cho tôi một ứng dụng quản lý công việc nhóm, nơi chúng tôi có thể giao việc cho người, đặt hạn hoàn thành và theo dõi tiến độ. Chạy nó lên để tôi dùng thử.

  2. 02
    Dùng thử và tinh chỉnh

    Khi tôi bấm vào tiêu đề thì mở chi tiết công việc, rồi cho tôi chọn có sửa hay không.

  3. 03
    Thêm tính năng

    Hãy thêm người được giao vào ứng dụng công việc hiện có. Hiển thị người được giao trong danh sách công việc, hoặc “Chưa giao” khi không có ai.

  4. 04
    Kiểm chứng phân quyền

    Thành viên chỉ đọc phải không tạo được công việc qua cả trang lẫn API. Hãy kiểm tra phân quyền phía server, sửa lỗi, và kiểm chứng bằng chính tài khoản thông thường đó.

Cùng một yêu cầu có thể cho ra layout và mã khác nhau; chi tiết hiện thực không cần trở thành một prompt dài.

Khi ứng dụng đã được xây và qua test, hãy triển khai cho nhóm của bạn bằng Docker, app-installer hoặc NocoBase Studio.Xem hướng dẫn triển khai

Năng lực ứng dụngDùng khi cần

Nền tảng đã sẵn sàng. Hãy tập trung vào nghiệp vụ của bạn.

Dữ liệu, phân quyền, workflow và phê duyệt, tệp, thông báo, tích hợp AI và nhiều thứ khác đã sẵn sàng, nên Agent chỉ cần xây phần logic nghiệp vụ. Danh sách đầy đủ ở Tổng quan plugin.

Dữ liệu và cơ sở dữ liệu

Collection, field, quan hệ và migration; tám dialect gồm SQLite, PostgreSQL, MySQL, SQL Server, Oracle; xem kết nối và field trong một trình duyệt.

database-explorer

Người dùng

API và trang quản trị người dùng cho ứng dụng.

users

Tệp

Kho tệp, API tải lên và nội dung, cùng các component tệp thuộc ứng dụng.

file

Email

Gửi thư, đồng bộ hộp thư có thể tiếp tục và mở rộng nhà cung cấp.

mail

Tác vụ định kỳ

Khai báo lịch chạy trong mã, kèm bản ghi thực thi và API bật/tắt.

scheduler

Đa ngôn ngữ và theme

Tích hợp đa ngôn ngữ, chuyển ngôn ngữ ứng dụng và tùy chỉnh giao diện bằng theme token.

i18n

Agent trong ứng dụng

Quản lý Agent, dịch vụ model, lượt chạy, hội thoại và runner; kết nối coding agent cục bộ và hội thoại trên trình duyệt.

agentsagent-sessions

Cơ sở tri thức

Quản lý không gian Markdown, phiên bản, tìm kiếm, đề xuất và duyệt.

knowledge

Phê duyệt

Gắn các tác vụ phê duyệt của con người với vòng đời bản ghi, kèm chính sách và kết quả.

approval

Trung tâm công việc

Lập chỉ mục tác vụ cá nhân từ nhiều nguồn nghiệp vụ, kèm API truy vấn và giao diện tái sử dụng được.

task-center

UI component và trang

Trang, route, điều hướng và các component sẵn có để xây giao diện nghiệp vụ cùng Agent.

Tài liệu NocoBase 3Bản tiếng Việt

Tìm đúng phần tài liệu

NocoBase là nền tảng mã nguồn mở để xây dựng, vận hành và phát triển hệ thống nghiệp vụ cùng AI. Agent viết mã nghiệp vụ, NocoBase cung cấp nền tảng và cơ chế quản trị, còn con người đặt mục tiêu và đưa ra quyết định.

Bắt đầu từ đây

Bạn muốn Bắt đầu từ
Tìm hiểu về NocoBase 3 NocoBase 3 là gì
Tự xây ứng dụng trên Core với Agent của mình Core là gì → Tạo ứng dụng
Dẫn dắt một đội Agent và đẩy nhiều dự án cùng lúc Studio là gì
Triển khai và vận hành ứng dụng Triển khai
Chuyển từ NocoBase 2 Chuyển từ NocoBase 2 · Quản lý plugin

Kiến trúc

NocoBase StudioNền tảng quản trị để con người và Agent cùng xây dựng phần mềm
Con người quyết định. Agent viết mã và làm việcClaude Code, Codex và OpenCode hợp thành một đội Agent tự đẩy các yêu cầu tiến lên. Tiến độ rõ ràng chỉ trong một cái nhìn, còn con người đưa ra các quyết định quan trọng.
Xây dựng · Bàn giao · Quản trị · Phát triển
Ứng dụng nghiệp vụCác hệ thống nghiệp vụ của tổ chức bạn
Agent xây ứng dụng. Bạn sở hữu chúng, và chúng tự chạy sau khi đưa vào sử dụngBạn cũng có thể bắt đầu từ một ứng dụng Solution có sẵn, chẳng hạn NocoCRM mã nguồn mở, rồi dùng nguyên trạng hoặc tiếp tục tùy biến.
Khối dựng · Chuẩn mực
NocoBase CoreNền tảng ứng dụng mã nguồn mở
Hơn 20 khối dựng, một cấu trúc dự án và bộ chuẩn phát triển thống nhấtDữ liệu, phân quyền, workflow và phê duyệt, tệp, thông báo, tích hợp AI và nhiều thứ khác đã sẵn sàng, nên Agent chỉ cần xây phần logic nghiệp vụ.
  • Core là nền tảng mã nguồn mở để xây dựng và vận hành hệ thống nghiệp vụ. Chỉ với Core, bạn đã có thể để Agent của mình trực tiếp xây ứng dụng.
  • Studio là không gian làm việc nơi con người dẫn dắt một đội Agent xây ứng dụng, có trong các phiên bản thương mại. Những ứng dụng nó xây cũng được dựng trên Core.

Về bộ tài liệu này

  • Tài liệu gồm ba phần, chuyển qua lại ở thanh trên cùng: Bắt đầu (giới thiệu và thuật ngữ dùng chung cho cả trang), Core và Studio.
  • Core dùng một ứng dụng quản lý công việc của nhóm để giải thích phát triển, kiểm thử và triển khai. Studio dùng kịch bản một nhóm mua hàng để giải thích cách con người dẫn dắt đội Agent.
  • Tài liệu được viết theo giao diện tiếng Anh. Tên giao diện có sẵn trong sản phẩm được in đậm và đường dẫn được viết dạng A › B, ví dụ System settings › User management.
  • Mọi gói NocoBase 3 hiện đều ở giai đoạn beta, nên API và giao diện vẫn có thể thay đổi. Sản phẩm là nguồn chính xác nhất.
  • Các trang hiển thị màu nhạt ở menu bên trái là trang chưa được viết.
  • Bản tiếng Việt do OXMODE biên dịch từ tài liệu chính thức. Toàn bộ các trang của NocoBase 3 đã được dịch sang tiếng Việt; tên giao diện trong sản phẩm vẫn giữ tiếng Anh như bản gốc.
NocoBase 3 · Tài liệu tiếng Việt, do OXMODE biên dịchMã nguồn mở · Tự host · Tự chọn model và Agent

Gõ từ khóa, ví dụ: triển khai, phân quyền, Agent.