agent-native

用 React 写智能体应用，少拼装多交付

开源 unknown 开发框架

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 7130

维护状态活跃

是否开源是

定价模式 unknown

项目预览

项目数据

分类开发框架

开发团队BuilderIO

所属国家

官网地址https://www.agent-native.com

GitHubhttps://github.com/BuilderIO/agent-native

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议

主要语言TypeScript

技术栈/模型agent-native,agents,ai,react,typescript

GitHub 星标★ 7130

30天Star增速

HF 下载量

上线时间2026-03-12 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-13

浏览次数0

项目介绍

agent-native 是一个用 TypeScript 编写的开发框架，专注于帮助开发者构建以 AI 智能体（agent）为核心的应用程序。它解决的核心问题是：传统前端或全栈框架没有为「智能体驱动」的交互模式提供原生支持，开发者往往需要自己拼装状态管理、工具调用、流式响应和多轮对话逻辑。agent-native 把这些能力抽象成框架级原语，让 agent 的思考、行动和 UI 更新能自然协同。它基于 React 生态，提供声明式的组件与 hooks，方便把智能体接入界面、处理工具调用结果、维护会话状态，并支持流式输出。核心能力包括：智能体生命周期管理、工具/函数调用编排、与 React 组件的双向绑定、以及可扩展的 TypeScript 类型系统。适合想快速搭建 AI 助手、自动化工作流或对话式产品的团队，降低从零搭建 agent 架构的成本。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：命令行工具 5 步

环境要求

可运行 npx 的 Node.js 环境（README 未指明具体版本）
能访问 npm 公共仓库的网络环境
可选：如需可视化编辑，需要 Claude Code

安装与启动步骤

1准备运行环境

脚手架通过 npx 执行，因此本机需先有可用的 Node.js/npm 环境。README 未给出 Node 版本要求，建议使用 LTS 版本。
2创建项目

用官方脚手架创建名为 my-agent 的项目，--standalone 为独立模式，--template chat 使用 chat 模板。
```
npx --yes @agent-native/core@latest create my-agent --standalone --template chat
```
3进入项目目录

创建完成后进入上一步生成的项目目录，后续操作都在该目录内进行。
```
cd my-agent
```
4查看入门指南

README 建议按官网 getting started 指南继续完成框架的完整入门配置，README 本身未给出启动命令。
5可选：可视化编辑

使用 Claude Code 的 /visual-edit 技能，在画布上直接调整运行中的应用界面，再让 Claude 把改动写回源码。
```
/visual-edit the onboarding flow, plus home at every breakpoint
```

如何确认成功

以脚手架命令的终端输出为准：创建成功会生成 my-agent 目录，进入目录后可看到项目文件；README 未提供启动命令与端口。

常见问题

Q：需要提前安装什么？

A：脚手架用 npx 运行，只需本机有 Node.js/npm 环境即可，README 未指定版本号。

Q：只能创建 chat 模板吗？

A：README 只演示了 --template chat 这一种模板，其他模板与参数请查阅官网入门指南。

Q：怎么直接改正在运行的界面？

A：在 Claude Code 中使用 /visual-edit，描述要调整的页面与断点，确认后再让 Claude 应用改动到源码。

Q：项目名称可以改吗？

A：可以，把命令中的 my-agent 换成你想要的项目名即可，进目录时同步改名。

注意事项

README 未给出 Node 版本、端口号、启动命令，请以官网 getting started 指南为准。
创建命令中的包名与参数必须保持原文，不要改写为其他包。
/visual-edit 是 Claude Code 内的斜杠命令，不是终端命令。
项目代码与数据完全归开发者所有，可自行接入 LLM、数据库与工具。

核心亮点

TypeScript 原生，类型安全贯穿智能体与 UI 层
基于 React，前端团队学习成本低，可直接复用组件生态
把工具调用、流式响应、会话状态等 agent 常见逻辑抽象成框架原语，减少重复造轮子

不足之处

项目较新，API 可能随版本快速变化，生产稳定性待验证
文档和社区案例相对有限，复杂场景需要读源码

适用场景

快速搭建带工具调用的 AI 对话助手前端
构建多步骤自动化工作流并实时展示执行状态
为现有 React 应用嵌入智能体交互能力

替代项目

LangChain.js、Vercel AI SDK

上一篇：superpowers

下一篇：openai-agents-js