rungent v0.5.1
EN中文

用你已有的 API,做成 Agent 原生

七种 Agent 入口,一份目录,只用用户自己的权限。

在 OpenAPI 的操作上标注 x-rungent。rungent 就能提供页面旁的助手、MCP 服务、你的 CLI、skill.md、llms.txt、⌘K 搜索,以及引用你文档的回答。你的编码 Agent 一句话就能接入;你的用户的 Agent 也只需要一句话。

痛点#

一个产品想让 Agent 用起来,最后往往要把同一件事做七遍:

入口 谁在用 通常怎么做
产品内的 Agent 你的用户 一个聊天组件,自带一套工具清单
MCP 服务 Claude Code、Cursor、Codex 第二套工具清单,常常挂在服务账号上
CLI 开发者和他们的 Agent API 的第三份拷贝
Skill 编码 Agent 手写的说明文件,写完就开始过时
给 Agent 读的文档 任何 Agent llms.txt,如果有人记得维护
全局搜索 所有人 另建一套资源索引
基于文档的回答(RAG) 所有人 另一条管线,另配一个模型

每一份拷贝都会和 API 渐行渐远;每一份对权限都有自己的理解,往往比用户本人的权限还大。写操作绕过了页面上的表单,于是 Agent 问的字段和页面不一样;同一个请求,这次弹表单,下次变成一问一答。

rungent 是什么#

rungent 把一份目录(你的 OpenAPI,在允许 Agent 使用的操作上加 x-rungent)变成全部七种入口,并且每一种都以当前登录用户的身份运行。

每个入口都遵守三条规则:

  • 一份目录。 Agent、MCP 工具、CLI 命令、skill 和搜索都从你的操作生成,所以说法永远一致。
  • 一个身份。 rungent 用用户自己的凭据加一份签名断言调用你的 API。它没有自己的权限,你的权限说了算。
  • 一条变更路径。 想改点什么,就打开你页面自己的表单,再弹一张绑定了确切参数的确认卡,然后才调用。不会变成聊天式盘问。

rungent 是一个 npm 包 rungent,外加一个给非 JavaScript 技术栈用的服务镜像和一个 Python kit。它能跑在 Node、Bun、Deno 和 Cloudflare Workers 上。

一句话开始#

发给你的编码 Agent:

从 https://rungent.acahti.dev/skills/rungent/SKILL.md 安装 rungent skill,然后用它把这个产品接入 rungent。

这个 skill 教会 Agent 完整的接入:标注操作、加身份操作、校验 rungent 的断言、挂载 rungent 和面板、把文档加为知识、再测试一遍。你只需要审一个 PR。想自己动手的话,快速开始展示了它写了什么。

上线之后,你的产品会提供自己的 skill.md,你的用户把这句话发给他们的 Agent:

安装 https://console.example.com/skill.md 上的 skill,用它帮我管理服务器。

两侧,一份目录#

rungent 面向两类人,目录是他们相遇的地方。

构建侧:你和你的编码 Agentrungent skill一句话安装x-rungent 标注标在允许 Agent 使用的操作上身份 + 断言校验一个操作,一个中间件面板与页面表单一个 React 组件你的产品 + rungent一份目录OpenAPI + x-rungent一个身份只用用户自己的权限一条变更路径表单 → 确认 → 调用知识你的文档,带引用使用侧:你的用户和他们的 Agent助手在你的页面旁⌘K 搜索 + 回答资源与文档MCP · CLIClaude Code、Cursor、脚本skill.md · llms.txt给他们的 Agent 一句话写提供两侧看到的是同一套操作,每个用户只看到自己有权做的。构建侧:你和你的编码 Agentrungent skill一句话安装x-rungent 标注标在允许 Agent 使用的操作上身份 + 断言校验一个操作,一个中间件面板与页面表单一个 React 组件写你的产品 + rungent一份目录OpenAPI + x-rungent一个身份只用用户自己的权限一条变更路径表单 → 确认 → 调用知识你的文档,带引用提供使用侧:你的用户和他们的 Agent助手在你的页面旁⌘K 搜索 + 回答资源与文档MCP · CLIClaude Code、Cursor、脚本skill.md · llms.txt给他们的 Agent 一句话

两侧看到的是同一套操作,每个用户只看到自己有权做的。

  • 构建侧是你和你的编码 Agent。你们读 rungent skill 和这些文档,写的只有:标注、一个身份操作、一个中间件、一个 React 组件。
  • 使用侧是你的用户和他们的 Agent。他们不读这些文档,他们看到的是你的产品:页面旁的助手、⌘K,以及产品提供的 skill.md、/mcp 和 CLI。他们能做的一切都在你的目录里,并且只限于他们有权做的。

架构#

人和 Agent 在这里工作产品内助手页面旁的助手面板⌘K 搜索资源与文档MCP 客户端Claude Code、Cursor 等CLI你的品牌命令skill.md · llms.txt给任何 Agentrungent一份目录你的 OpenAPI,按用户可见路由 → 表单 → 确认每次变更同一条路径Agent 循环模型链、重试、上限会话与流式AG-UI 事件,可续传搜索与知识联邦检索,带引用你的产品HTTP APIOpenAPI 3.1 + x-rungent身份当前登录的是谁权限由你的规则决定页面表单与业务页面同一张表单文档回答引用它们用户自己的会话用户凭据+ 签名断言结果,你的报错每次调用都以当前登录用户的身份执行,rungent 没有自己的权限。人和 Agent 在这里工作产品内助手页面旁的助手面板⌘K 搜索资源与文档MCP 客户端Claude Code、Cursor 等CLI你的品牌命令skill.md · llms.txt给任何 Agent用户自己的会话rungent一份目录你的 OpenAPI,按用户可见路由 → 表单 → 确认每次变更同一条路径Agent 循环模型链、重试、上限会话与流式AG-UI 事件,可续传搜索与知识联邦检索,带引用用户凭据+ 签名断言你的产品HTTP APIOpenAPI 3.1 + x-rungent身份当前登录的是谁权限由你的规则决定页面表单与业务页面同一张表单文档回答引用它们

每次调用都以当前登录用户的身份执行,rungent 没有自己的权限。

rungent 位于各个入口和你的 API 之间。它用每个用户的凭据读取目录,运行 Agent 循环,让每次变更都走表单和确认,以 AG-UI 事件流式传输对话,并对你的资源和文档做联邦搜索。决定权留在你的产品里:身份、权限、表单和产品事实。详见工作原理。

概念#

词 含义 页面
目录 标了 x-rungent 的 OpenAPI 操作,按某个用户可见的范围 目录
身份 这是谁的请求;每次调用都以这个用户的身份进行 以用户身份调用
变更路径 路由 → 你的表单 → 确认 → 调用 表单与确认
知识 你的文档和资源,可搜索、可引用 搜索与知识
入口 面板、⌘K、MCP、CLI、skill.md、llms.txt 入口

接下来#

版本 0。 协议是 rungent/0,HTTP API 在 /rungent/v0 下;小版本仍可能有破坏性变更,更新日志列出了每一处。

供 Agent 读取: overview.md编辑此页