Agent-Native：Agent 应用开发框架

项目简介

Agent-Native 是一个开源的 TypeScript 框架，用来构建「智能体 + 专用界面」的应用：agent 负责自主执行任务，UI 让人查看、编辑、审批和分享它的工作。agent 与界面共用同一套能力定义，不会在界面上模拟点击。

README 指出：编码类 agent 的能力来自它所处的环境（上下文、工具、文件、测试、预览）；知识工作同样需要这样的环境，而界面正是提供这种环境的方式。

主要功能

• 共享 action：每个能力只定义一次，agent 把它当工具调用，UI 在代码里调用同一个函数，两条路径共用同一套校验、权限与实现。
• 共享数据：agent 的产出会出现在 UI 中，UI 里的操作也能被 agent 使用。
• 共享应用状态：agent 会收到相关的 UI 状态，例如当前页面、选中的记录或当前视图。
• 内置能力：agent 聊天、认证与权限、Skills 与记忆、Automations（按计划或事件运行）、Agent teams（把任务分派给专家 agent）、PostgreSQL 后端（生产用 PostgreSQL，本地用 PGlite，可部署到任何 Nitro 兼容的 host）。
• 多端暴露：同一个 action 同时可通过 HTTP、MCP、A2A 和 CLI 使用。
• 视觉编辑：在 Claude Code 中使用 /visual-edit，在画布上编辑正在运行的应用，对比不同页面与断点后再让 Claude 把改动写回源码。
• 开源 agent 模板：Clips（记录并理解会议、屏幕与语音笔记）、Design、Slides、Analytics、Calendar、Mail、Assets、Content、Plans，可作为自己项目的起点。

安装与使用

用脚手架创建项目：

npx --yes @agent-native/core@latest create my-agent --standalone --template chat

完整入门可参考官方指南：https://agent-native.com/docs/getting-started

定义一个 action，例如 actions/hello.ts：

import { defineAction } from "@agent-native/core/action";

export default defineAction({
  description: "Return a friendly greeting.",
  http: { method: "GET" },
  run: async ({ name }) => {
    return { message: `Hello, ${name}!` };
  },
});

定义之后，agent 会得到名为 hello 的工具，React 侧可以用 useActionQuery("hello", { name: "Alex" }) 调用同一个函数。

视觉编辑示例：

/visual-edit the onboarding flow, plus home at every breakpoint

注意事项

• 需要自备 LLM、SQL 数据库、工具和基础设施，框架本身不提供模型。
• 本地开发默认使用 PGlite，生产环境使用 PostgreSQL。
• 文档见 https://agent-native.com/docs ，社区交流可加入 Discord。
• 许可证为 MIT。

本作品整理自 GitHub 开源项目 BuilderIO/agent-native，原作者 @BuilderIO，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。