当下各类大模型智能体大多停留在独立聊天窗口的形态，只能作为外挂工具辅助用户操作成熟应用，无法深度融入业务系统内部。开发者想要打造能够深度操控页面、读写业务数据、自主完成完整业务流程的内置智能体，往往需要从零搭建智能运行时、数据存储、界面交互、跨智能体通信等全套底层能力，同时还要处理身份权限、任务调度、日志观测等配套模块，整体开发链路冗长，代码复用率极低。市面上通用SaaS产品仅提供固定AI能力，无法深度定制；纯底层智能体库缺少配套UI与业务存储能力；内部自研工具又需要长期维护大量底层基建，三类方案都难以平衡开发效率与自主可控需求。大量开发者仍困在“AI与业务系统割裂”的开发困境中，缺少一套标准化、可私有化部署、全链路打通的开发底座。

Agent-Native 跳出外挂式智能体的传统思路，提出应用原生智能体的全新开发范式，核心解决智能体与业务界面、业务数据深度割裂的行业痛点。该框架将前端界面、智能运行时、数据库状态、工具能力统一整合至同一套技术体系，同一套业务动作可同时支撑人工点击、智能体调用、外部API、MCP协议、A2A跨智能体通信与命令行调用，无需重复编写多端适配代码。框架自带完整可商用的SaaS应用模板，覆盖录屏、代码规划、内容创作、数据看板等高频场景，同时支持开发者自由接入任意SQL数据库、托管服务与大模型堆栈，代码完全由开发者持有，兼顾快速落地与高度自定义能力，大幅降低内置智能体应用的开发门槛。

简介

Agent-Native 由 BuilderIO 团队维护，项目托管地址为
https://github.com/builderio/agent-native，整体采用 MIT 协议开放使用，无商用限制。项目核心定位是构建运行在真实应用内部的稳健智能体的一体化开发框架，区别于仅提供对话能力的独立智能体工具，它完整提供可用于产品级智能应用的底层原语，包含共享动作定义、SQL持久化状态、统一身份校验、工具技能系统、定时任务、全链路观测以及配套交互界面，所有模块天然互通。开发者无需从零搭建智能运行环境，可自由搭配适配 Drizzle 的任意SQL数据库、兼容 Nitro 的托管服务商以及自有大模型代码，不存在厂商绑定问题，私有化部署与二次修改不受限制。

框架核心功能与差异化特色集中在多端统一动作、一体化智能运行时、后端无关三层架构三个核心模块。其一为统一动作机制，仅需定义一次业务逻辑，即可同时适配前端UI交互、智能体自主执行、HTTP接口、MCP模型上下文协议、A2A智能体互调、本地CLI六大调用入口，大幅减少重复开发工作量；其二是内置完整智能运行时，内置对话会话、工具调用、长期记忆、定时任务、观测日志、任务交接整套能力，开箱即用；其三是底层解耦设计，数据库与托管环境完全可替换，不强制锁定特定云服务商与存储方案。除此之外，框架支持人机协同实时编辑、智能体互相调用、应用自主迭代优化等进阶能力，界面与智能体共享同一数据库状态，两端操作实时同步更新。

该框架覆盖个人开发者、小型创业团队、企业研发部门三类核心使用群体，适配多类落地场景。研发场景可借助内置视觉规划与复盘技能，为各类代码助手增加可视化开发规划与PR变更复盘能力；生产力工具场景可基于官方完整模板快速搭建录屏、文稿编辑、幻灯片制作、数据统计看板等独立SaaS应用；企业业务系统场景可开发内置智能客服、流程自动化智能体，打通邮件、表单、日程等内部业务模块；通用工具拓展场景可作为底层底座，为现有VS Code、Cursor、Claude Code等开发工具拓展可视化智能协作能力。所有模板均为完整可直接克隆的成品应用，而非基础脚手架，下载后即可直接运行并按需修改全部源码。

使用

Agent-Native 基于 Node 生态构建，本地开发前需提前配置 nvm 管理 Node 版本，仓库内置 .nvmrc 文件统一版本规范，包管理工具默认使用 pnpm。整体使用流程分为项目初始化、项目本地启动、自定义业务动作、安装拓展技能、使用官方模板五步，每一步配套完整命令与代码示例。

第一步，本地创建全新项目，终端执行官方提供的创建命令，交互式选择项目启动模式。

执行命令后终端会弹出三种初始化选项，分别为完整模板套件、极简对话UI、无界面纯逻辑底层，也可通过参数跳过交互直接指定模式，示例如下。

第二步，进入项目目录安装依赖并启动本地开发服务，命令如下。

启动完成后本地端口会运行完整应用，包含配套管理界面与智能体对话窗口，可直接在浏览器访问调试全部功能。

第三步，自定义全局通用业务动作，动作代码存放于项目 packages 目录下，使用 zod 定义入参校验，run 函数编写业务逻辑，一套代码多端复用，示例代码如下。

该动作可在页面按钮点击、智能体指令、外部MCP客户端、跨智能体A2A调用、本地CLI中直接触发，无需额外编写适配代码。

第四步，为代码智能体安装可视化规划与复盘拓展技能，一条命令即可接入现有开发工具，支持 VS Code、Cursor、GitHub Copilot 等主流编码助手。

安装完成后智能体新增两个斜杠指令，/visual-plan 在编写代码前生成带线框图、文件实现地图的可评审方案，/visual-recap 在代码变更完成后生成可视化变更总结并提供分享链接，简化代码评审流程。

第五步，多模板组合部署，创建项目时可一次性选择邮件、日历、表单多个模板，框架自动完成统一身份鉴权、数据库共享，无需手动处理多应用数据互通问题。若需要打包部署至云端，可使用仓库内置 wrangler 系列配置文件，适配 Cloudflare 托管环境，修改对应 wrangler-xxx.toml 文件即可完成云端发布。

开发过程中可通过项目内 AGENTS.md、DEVELOPMENT.md 查阅完整开发规范，官方文档站点 agent-native.com 提供全量接口说明，遇到问题可加入项目 Discord 社区交流排查。Windows 桌面端基于 Tauri 构建，仓库已修复登录、权限适配相关问题，跨平台开发无需额外修改底层代码。

总结

Agent-Native 最大的价值在于重构智能体应用的开发逻辑，打破界面与智能体分离的传统开发模式，以统一动作、一体化智能运行时、后端无关架构三大核心能力简化内置智能体开发流程。框架自带覆盖办公、研发、数据统计的完整商用模板，支持快速搭建可交付的独立应用，同时提供轻量化技能拓展方案，无需重构项目即可为现有AI工具增加可视化协作能力。人机实时协同、A2A跨智能体调度、应用自主迭代等特性，解决传统智能体无法深度介入业务流程的短板，所有底层能力封装为标准化原语，避免开发者重复搭建存储、权限、观测等基础设施。

从长期应用价值来看，该框架为AI原生应用落地提供低成本、高自主可控的技术底座，个人开发者可快速打造差异化生产力工具，中小企业无需投入大量人力搭建智能体底层基建，企业可基于自有业务数据库搭建私有化内部智能流程系统。对比传统SaaS工具、纯底层智能体库、自研内部系统三类方案，它同时兼顾界面完整度、AI原生深度集成、自定义自由度与代码所有权四大优势，适配当下智能体从独立对话工具转向业务内置协作单元的行业发展趋势，能够有效降低各类行业AI应用的落地与迭代成本，具备广泛的商业化拓展潜力。