#AI 搭建快速开始

AI 搭建是 NocoBase 提供的 AI 辅助搭建能力——你用自然语言描述业务需求，AI Agent 帮你把系统搭起来。从数据建模、界面搭建、工作流编排、权限配置等，到最终发布上线，覆盖整条链路。

具体到「如何搭建界面」，有两种方式：

• AI + 无代码 Portal 搭建 — AI 基于 NocoBase 的无代码配置界面的能力，帮你搭建系统界面，产物是保存在数据库里的配置。适合标准的增删改查和内部管理后台，业务人员后续也能自己在界面上接着改
• AI Portal 搭建 — NocoBase 提供基座能力（数据、认证、权限等），AI Agent 直接在本地写代码（产物可以直接提交到 Git），构建部署后可以直接通过 AI Portal 访问。适合定制交互、复杂业务系统和有特殊视觉要求的场景

不管选哪种方式，数据表、权限、工作流这些都会用同一套 Skill —— AI Agent 写页面的同时，也能顺手帮你把数据表建好、把权限配上，通过对话逐步搭建好一个完整的业务系统。

#两种搭建方式怎么选

上面那两种方式，各自对应一种访问入口。一个 NocoBase 应用可以有多个入口，共用同一套数据，看访问路径就能认出来是哪一种：

/v/<name>    无代码 Portal
/x/<name>    AI Portal

具体差别：

下面这几种情况用无代码 Portal 就够了：

• 页面结构非常标准，就是常规的表格加表单，配置一下比写代码更快
• 需要让不写代码的业务人员自己调整页面
• 只想用 NocoBase 内置的区块能力，比如数据看板、日历视图、看板视图等
• 独立搭建，或者不需要多人协作搭建

其他场景我们更推荐用 AI Portal 来搭建。无代码 Portal 搭建，AI 需要学习的上下文太多——区块类型、配置结构、联动规则等，对于需要复杂搭建的业务系统而言，搭建效率、可维护性和多人协作都不够理想。

于是我们换了个思路：写前端代码是 AI 最擅长的事情，可以让它做最擅长的事。NocoBase 作为系统内核的基座，前端交给 AI 自由发挥。同样的需求，速度更快，效果也更好。AI 自由发挥，由 NocoBase 负责可靠性。

两种模式也可以混用：内部管理后台用无代码 Portal 快速配好，对外的客户门户用 AI Portal 精细定制——它们在同一个应用里，共用一套数据和用户体系。

#快速开始

如果你已经安装过 NocoBase CLI，可以跳过这一步。

#一键 AI 安装

将下方提示词复制给你的 AI 助手（Claude Code、Codex、Cursor、Trae 等），即可自动完成安装和配置：

帮我安装 NocoBase CLI 并完成初始化：https://docs.nocobase.com/cn/ai/ai-quick-start.md （请直接访问链接内容）

#手动安装

npm install -g @nocobase/cli@alpha
nb init --ui

浏览器会自动打开可视化配置页面，引导你安装 NocoBase Skills、配置数据库并启动应用。详细步骤请参阅快速开始。

#用对话代替手动配置

NocoBase CLI 安装完成后，你可以直接在 AI 助手里用自然语言操作 NocoBase。下面是几个真实场景，从建一张表到搭一整套系统，感受一下 AI 搭建的能力。

#描述业务需求，AI 帮你设计表和关联关系

告诉 AI 你想做什么系统，它会自动帮你设计数据表、字段类型和关联关系——不需要自己画 ER 图。

我正在搭建一个 CRM，请帮我设计并搭建数据模型

AI 自动生成了客户、联系人、商机、订单等数据表，以及它们之间的关联关系：

想了解更多数据建模的用法，请参阅 数据建模。

#搭好一个节点，AI 帮你存一个可回退的版本

完成一个页面、一组数据表或一条工作流后，让 AI 把当前状态保存为版本——配置改坏了随时能回退到上一个清晰的节点。

保存当前搭建成果为版本：完成客户管理页面、筛选区和编辑表单配置

AI 不会每改一个字段就存一次，只在完成并验证一个清晰节点后保存，这样版本列表更容易读，恢复时也更容易判断该回到哪里。

想了解更多版本控制的用法，请参阅 版本控制。

#一句话编排自动化工作流

描述业务流程的触发条件和处理逻辑，AI 会自动创建触发器和节点链。

帮我编排一个订单创建之后自动扣减商品库存的工作流

想了解更多工作流的用法，请参阅 工作流管理。

#用业务语言描述页面，AI 帮你搭好

NocoBase 默认提供了一个 AI Portal 和一个 无代码 Portal，不用学配置规则，直接说你想要什么样的页面——搜索框、表格、筛选条件，说出来就有了。

如果是通过无代码 Portal 搭建（默认 Portal 名字是 admin），参考如下：

帮我在 admin 里创建一个客户管理页面，包含姓名搜索框和客户表格，表格显示名称、电话、邮箱、创建时间

如果是通过 AI Portal 模式搭建（默认 Portal 名字是 main），参考如下：

帮我在 main portal 里创建一个客户管理页面，包含搜索框和客户表格，表格显示名称、电话、行业

想了解更多界面配置的用法，请参阅 界面配置 或 AI Portal 搭建。

#安全与审计

在让 AI Agent 操作 NocoBase 之前，建议先了解鉴权方式、权限控制和操作审计——确保 AI 只做该做的事，每一步都有记录。请参阅 安全与审计。

#NocoBase Skills

NocoBase Skills 是可安装到 AI Agent 中的领域知识包，让 AI 理解 NocoBase 的配置体系。NocoBase 提供了多个 Skills，覆盖搭建全流程：

• 环境管理 — 环境检查、安装部署、升级和故障诊断
• 数据建模 — 创建和管理数据表、字段、关联关系
• 界面配置 — 创建和编辑页面、区块、弹窗、交互联动
• 工作流管理 — 创建、编辑、启用和诊断工作流
• 权限配置 — 管理角色、权限策略、用户绑定和风险评估
• 解决方案 — 从 YAML 批量搭建整套业务系统
• 插件管理 — 查看、启用和停用插件
• 发布管理 — 跨环境发布、备份恢复和迁移
• 版本控制 — 在阶段性成果完成后保存可恢复版本
• AI Portal 搭建 - 让 AI Agent 在 AI Portal 里写代码搭建系统界面

#相关链接

• AI Portal — 让 AI Agent 直接写前端代码的另一种搭建方式
• NocoBase CLI — 安装和管理 NocoBase 的命令行工具
• NocoBase CLI 参考 — 所有命令的完整参数说明
• AI 开发插件 — 用 AI 辅助开发 NocoBase 插件
• 安全与审计 — 鉴权方式、权限控制和操作审计
• AI 员工 — NocoBase 的智能体能力，支持在业务界面中协作和执行操作