Agent-Native Mail

Agent-Native

Agent-Native 是一个开源 TypeScript 框架，用于构建将自主工作与专用 UI 相结合的 Agent。只需将每项能力定义为一个 操作：Agent 将其用作工具，而 UI 则通过代码调用它。

快速开始

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

请参阅入门指南，全面了解该框架。

为什么要构建带 UI 的 Agent？

编码 Agent 的工作环境不只是一个文本框。它们的环境还提供上下文、工具、文件、测试和预览，让其能力与结果清晰可见。

知识工作也需要同样的环境。UI 能展示 Agent 的能力，并为人们提供熟悉的方式来检查、编辑、批准和分享其工作。

Agent-Native 的工作原理

• 共享操作。 Agent 将每项能力作为工具调用，UI 则通过代码调用它。两种方式使用相同的验证、权限和实现。
• 共享数据。 Agent 完成的工作会显示在 UI 中，而在 UI 中完成的工作也可供 Agent 使用。
• 共享应用状态。 Agent 会接收相关的 UI 状态，例如当前页面、选中的记录或活动视图。

Agent 不会点击 UI，而是通过与 UI 相同的操作层来工作。

示例：共享操作

创建 actions/hello.ts：

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

// One action powers every app surface: UI, agent, HTTP, MCP, A2A, and CLI.
export default defineAction({
  description: "Return a friendly greeting.",
  schema: z.object({
    name: z.string().default("world").describe("Name to greet"),
  }),
  http: { method: "GET" },
  run: async ({ name }) => {
    return { message: `Hello, ${name}!` };
  },
});

Agent 会将 hello 作为工具接收。React 使用 useActionQuery("hello", { name: "Alex" }) 调用同一个函数。Agent-Native 还通过 HTTP、MCP、A2A 和 CLI 提供该操作。

包含的功能

• Agent 聊天： 让人们在同一个 UI 中委派工作、提出问题并查看结果。
• 身份验证和权限： 控制谁可以访问和更改共享工作。
• 技能和记忆： 为 Agent 提供可重复使用的专业知识和持久上下文。
• 自动化： 按计划或事件运行 Agent 工作。
• Agent 团队： 将工作委派给同一工作区或已连接 Agent 中的专职 Agent。
• PostgreSQL 后端： 在生产环境中使用 PostgreSQL，并在任何兼容 Nitro 的主机上使用 PGlite 进行本地开发。

示例：以可视化方式编辑正在运行的应用

在 Claude Code 中使用 /visual-edit，在画布上编辑正在运行的应用，而不是每次微调 UI 都发送提示词。并排比较实时页面，然后让 Claude 将选定的修改应用到源代码中。例如：

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

在桌面、平板和手机尺寸下，将引导页面与主页并排检查，直接调整按钮的颜色或间距，然后让 Claude 将待处理的修改应用到源代码中。完整操作流程和分享详情请参阅可视化编辑指南。

带上你的大模型、SQL 数据库、工具和基础设施。你构建的一切都归你所有。

看看 Agent-Native 的实际效果：

https://github.com/user-attachments/assets/ef51644b-6506-46d8-8083-0af7b7e5b65c

开源 Agent

从以下 Agent 中选择一个开始，或将其用作示例来构建自己的 Agent。

Clips 录制并理解会议、屏幕内容和语音备忘录。	Design 生成并完善交互式设计。	Slides 创建并编辑符合品牌形象的演示文稿。
Analytics 针对你的数据提问并构建仪表板。	Calendar 寻找空闲时间、安排活动并管理预订。	邮件 优先处理邮件、起草回复并跟进。
素材 创建和整理符合品牌风格的媒体素材。	内容 起草、整理并发布内容。	计划 通过图表、线框图和原型创建并评审可视化计划。

浏览完整应用图库，或从框架指南开始。

文档和社区

• 阅读文档。
• 加入 Discord 提问、分享你正在构建的内容并获取帮助。

贡献

想提交更改吗？请从 CONTRIBUTING.md 开始。DEVELOPMENT.md 介绍本地设置、工作区结构和检查脚本。

许可证

MIT