GitHub - BuilderIO/agent-native：一个用于构建 agent-native 应用程序的框架。· GitHub

秦睦迪

发布于 2026-07-08 20:38:23

Agent-Native

你所拥有的 Agent 应用的开源框架。

无需在丰富的用户界面与自主 Agent 之间二选一。每个 Agent-Native 应用两者兼备。

Agent 与 UI — 全面互联

Agent 与 UI 在同一系统中地位对等。每个操作都双向畅通——点击或对话，皆可触达。

全面同步 — Agent 与 UI 共享同一数据库和同一状态。任意一侧的变更都会即时反映在另一侧。
实时多人协作 — 人类与 Agent 可同时在同一文档中协作：支持 CRDT 合并、实时在场感知（光标、选区高亮、当前所在幻灯片），Agent 作为一等公民参与编辑。适用于任意 SQL 数据库和任意托管环境，包括 Serverless。
上下文感知 — Agent 知道你正在查看什么。选中文本，按下 Cmd+I，告诉它要做什么。
每用户独立工作区 — 技能、记忆、指令、子 Agent 和 MCP 服务器——以 SQL 为后端，可按用户定制。具备 Claude Code 级别的灵活性，同时保持 SaaS 级别的经济性。
Agent 调用 Agent — 从任意应用中 @ 另一个 Agent。它们通过 A2A 相互发现，并在你的整个技术栈中协同行动。
可复用集成 — 在 Dispatch 中一次性接入某个服务商，将密钥保存在 Vault 中，然后将共享账户元数据和凭证引用授权给 Brain、Analytics、Mail、Dispatch 等应用使用。
三种形态 — 将同一个 Agent 构建为无界面 API、丰富的对话体验，或 Agent 与 UI 保持同步的完整应用。
自我进化的应用 — 你的应用会自主变得更好。Agent 可以随时间推移添加功能、修复 Bug、优化 UI。
任意数据库，任意托管 — 支持 Drizzle 兼容的任意 SQL 数据库，支持 Nitro 兼容的任意部署目标。无供应商锁定。
按需选择 Agent 接入面 — 兼容 MCP 的宿主可调用你的应用，编程 Agent 可安装技能，原生对话界面可渲染可复用的应用输出，自带 Agent 运行时也可流式接入 Agent-Native 对话外壳。

面向 Agent 原生应用的框架

Agent-Native 是一个开源框架，用于构建能够在真实应用内部行动的健壮 Agent，而不仅仅是在旁边聊聊天。

它为产品级 Agent 软件提供了基础原语：共享 Actions、SQL 持久化状态、身份认证、工具、技能、任务、可观测性，以及协同工作的 UI 界面。

后端无关：自带数据库、托管服务商、模型栈和应用代码。

// One action powers UI, agent, HTTP, MCP, A2A, and CLI. export default defineAction ( { schema : z . object ( { emailId : z . string ( ) , body : z . string ( ) , } ) , run : async ( { emailId , body } ) => { await db . insert ( replies ) . values ( { emailId , body } ) ; } , } ) ;

Actions — 一次定义，到处使用。可从 UI、Agent、API、MCP、A2A 和 CLI 调用。
Agent 运行时 — 对话、工具、技能、记忆、任务、可观测性和任务移交，开箱即用。
后端无关 — 接入任意 Drizzle 支持的 SQL 数据库和 Nitro 兼容的托管环境。

同一个 Agent，三种产品形态

Agent-Native 原语让你可以自由决定在 Agent 外层包裹多少 UI，而无需重新构建 Agent 契约：

| 形态 | 你交付的内容 | 底层相同的原语 |

| 无界面（Headless） | 通过代码、CLI、HTTP、MCP 或 A2A 调用 Agent 和 Actions。 | defineAction、认证、技能、记忆、任务、可观测性 |

| 富对话界面 | 独立或嵌入式对话界面，原生支持表格、图表、审批、引导流程和工具结果。 | 共享对话运行时、自带运行时适配器、Action 声明式原生渲染器 |

| 完整应用 | 完整的 SaaS/产品 UI，对话可从中心位置启动，移至侧边栏，并与应用状态保持同步。 | SQL 状态、Actions、上下文感知、深度链接、实时同步 |

协议随框架一同提供，而非针对每个功能单独集成。目前支持 A2A、MCP、MCP Apps、标准远程 MCP OAuth、MCP 客户端、HTTP/CLI Action 调用、原生对话组件、AgentChatRuntime 适配器、标准 OpenAI、AG-UI、Claude Agent SDK、Vercel AI SDK 对话运行时连接器，以及深度链接，全部挂载在同一 Action 接入面上。ACP 最好理解为编程 Agent/编辑器互操作协议，而非通用的自带应用对话运行时。

完整的决策指南——无界面、内置 Agent 的富对话界面、自有 Agent 的富对话界面、嵌入式侧边栏，或完整应用——请参阅 Agent Surfaces。

如需将 Claude、ChatGPT、Codex、Cursor、OpenCode、GitHub Copilot / VS Code 或其他 MCP 宿主接入你的托管应用，请参阅外部 Agent 指南。

从一个技能开始体验

暂时不想搭建完整应用？只需一条命令，即可为 Claude Code、Codex、Cursor、Pi、OpenCode、GitHub Copilot / VS Code 等 Agent 添加可视化规划和 PR 摘要功能：

npx @agent-native/core@latest skills add visual-plan

你将获得两个斜杠命令，让你的 Agent 在规划和汇报工作时更上一层楼：

/visual-plan — 在 Agent 编写代码之前，它会生成一份结构化、可审阅的计划文档，而非大段文字：内联图表、UI 线框图与原型、逐文件实现映射，以及可评论和审批的注释。
/visual-recap — 变更落地后，它会将 PR 或 git diff 转化为高层次的可视化回顾：将 Schema、API 和文件变更渲染为有据可查的前后对比块，并附带可分享的审阅链接，告别滚动原始 diff 的痛苦。

更多技能和本地安装方式，请参阅 技能指南。

模板

从功能完整的模板出发。每个模板都是一个完整的、100% 免费开源的 SaaS 应用——可克隆，非脚手架——代码归你所有，一切皆可定制。

| CalendarAgent-Native Google Calendar、Calendly 管理日程、与 Google Calendar 同步，并通过 AI 调度共享公开预约页面。 | Content面向 MDX 的开源 Obsidian 编辑本地 Markdown/MDX 文件，生成丰富的交互式自定义块，并通过 Agent 起草、改写或发布内容。 | Plans面向编程 Agent 的可视化计划模式 安装 /visual-plan 和 /visual-recap，让你的编程 Agent 在构建前先规划、在变更落地后回顾——包含图表、线框图、注释和审阅链接的高层次代码审查。 |

| SlidesAgent-Native Google Slides、Pitch 通过提示词或点击操作生成并编辑基于 React 的演示文稿。 | AnalyticsAgent-Native Amplitude、Mixpanel 接入分析数据源，通过提示词生成真实图表，并构建可复用的仪表盘。共享工作区连接可提供服务商凭证，而 Analytics 仍自主管理指标、数据源选择和已保存的分析。 | ClipsAgent-Native Loom 录制屏幕，自动生成转录文本和可分享链接，Agent 可按需汇总、添加字幕和剪辑片段。 |

每个模板都是完整可克隆的 SaaS——Fork 它，用 Agent 定制它，拥有它。在接入自有数据源之前，可先用示例数据体验。

完整模板库请访问 agent-native.com/templates。

快速开始

一条命令，Fork 模板并在本地开始构建。

npx @agent-native/core@latest create my-platform cd my-platform pnpm install pnpm dev

CLI 会显示多选选择器，让你在一个工作区中按需包含多个模板。选择 Mail + Calendar + Forms，即可一次性获得三个完整应用，并共享同一套认证体系。也可前往 模板库 查看在线演示。

只想要单个应用，不需要 Monorepo？使用 --standalone：

npx @agent-native/core@latest create my-app --standalone --template mail

工作区（Monorepo）

工作区是 Agent-Native 项目的默认形态。每个应用都位于 apps/ 下，packages/shared/ 则用于存放那些真正需要应用于所有应用的少量代码、指令、技能或品牌资产。

my-platform/ ├── package.json # declares `agent-native.workspaceCore` ├── pnpm-workspace.yaml ├── .env # shared secrets: ANTHROPIC_API_KEY, BUILDER_PRIVATE_KEY, A2A_SECRET, ... ├── packages/ │ └── shared/ # optional shared custom code └── apps/ ├── mail/ ├── calendar/ └── forms/

后续添加新应用：

npx @agent-native/core@latest add-app notes --template content

将所有应用部署在同一域名下：

npx @agent-native/core@latest deploy # https://your-agents.com/mail/* → mail # https://your-agents.com/calendar/* → calendar # https://your-agents.com/forms/* → forms

同源部署意味着所有应用共享登录会话，以及零配置的跨应用 A2A——在日历 Agent 对话中 @ @mail，即刻生效（无需 JWT 签名，无需配置 CORS）。完整详情请参阅 agent-native.com/docs/multi-app-workspace。