AGenUI Studio

English · 文档 · 更新日志

AGenUI Studio 是一个可自托管的 AGenUI 智能界面工作台：在后台配置模型、知识、接口、算子和规则， 生成并实时预览卡片，再通过多轮对话持续修改。

一条真实生成主链：契约优先、规则驱动设计、数据与算子绑定、受保护多轮编辑，最终交付 可移植 Runtime Package；中间画面来自绑定仓库内置 demo.offers 数据源的公开安全运行。

真实生成示例

图片、优惠、价格与主操作	票务标签、原价与重复列表	酒店结果与可执行数据绑定
图片、分隔线、状态与优惠券动作	路线、天气、预警与动态状态	无设备外壳的卡片细节预览

前四张来自 Studio 使用已配置模型、规则与 Workspace 工具完成的真实运行，并由 Renderer 实际渲染。为便于 查看版式细节，最后一张采用无设备外壳的展示方式。示例覆盖图片、重复列表、价格、标签、动作和数据绑定； 线上原始素材、业务数据及内部规则不随本仓库分发。

从一句话到可执行界面

模型负责理解语义和设计；带版本的 Workspace 工具约束 DSL 的创建、绑定和修改方式；最终生成 已经展开的 Runtime Package，无需重新连接 Studio 即可执行。

新项目如何复刻一张卡

上面的示例并不依赖隐藏模板或业务代码。启动本地项目后，可直接复制生成提示词、编辑提示词和 小型 Markdown 规则示例：第一个提示词会在尚未接入数据源时生成完整预览， Binder 再报告可下载卡包仍需完成的字段映射；编辑提示词只修改声明的视觉目标集合，保留已有数据和 动作。

允许使用合规参考图作为视觉输入，但不要把产品素材、业务术语或私有规则提交到开源仓库。当视觉 系统需要稳定约束时，上传一份小而通用的 Markdown 规则 revision 即可。

能力

• 在页面中配置自己的 OpenAI-compatible 或 Anthropic Messages API 模型地址、 模型名和 API Key。
• 生成卡片、实时预览，并在同一会话中多轮编辑。
• 将成功卡片下载为自包含 Runtime Package；数据源、绑定、动作和算子不再依赖 Studio ID。
• 注册投递目标后可在工作台直接发布该运行包；内置 Callback，MQ Adapter 共用同一发布端口。
• 用本地 SQLite 知识库直接跑起来；知识、接口、算子和规则都能在后台维护。
• 多轮编辑时冻结目标集合、改动集合和保护集合，避免未指定区域被误改。
• 嵌入独立的卡片 Runtime，无需连接 Studio 即可执行已打包的 数据源、绑定和 TypeScript 算子。
• Markdown 规则解析成功后以不可变 revision 发布，并原子切换活动指针。

模型兼容性

AGenUI Studio 可通过 OpenAI-compatible Chat Completions 或 Anthropic Messages API 连接用户自行提供的模型。项目贡献者已测试以下模型：

模型	协议	状态
千问（qwen3.8-max）	OpenAI-compatible	已验证
Claude Opus 4.7	Anthropic Messages API	已验证
GLM-5.2	OpenAI-compatible	已验证（仅文本）
Kimi K3	OpenAI-compatible	已验证
GPT-5.6 Sol / Terra	OpenAI-compatible	已验证

实际效果可能随模型版本和服务提供方变化。测试使用的 GLM-5.2 配置不支持多模态输入， 具体模型 ID 以服务提供方为准。

架构

Harness 负责可持久化运行；AGenUI Agent 通过有界工具使用规则、Catalog、知识、接口和已发布 算子；Workspace 原子提交不可变产物，供实时渲染、下载或通过 Callback/MQ Adapter 投递。 蓝色虚线框表示可替换端口，不是固定供应商或强制实现。

本地开箱即用，线上按边界替换

SQLite、BM25、Markdown 规则、Web Renderer 和内置 Runtime 让本地首次运行不依赖外部服务。 线上可以在保持合同不变的前提下，将持久化存储替换为 MySQL，将热状态替换为 Redis，将知识或 数据替换为 MCP 服务，将算子替换为远程运行平台，并通过自建 Callback 服务或 MQ Consumer 接收卡包。Runtime Package 是可移植交付物；内置 Runtime 只是核心参考实现，不限制部署方的 编排、托管和在线执行方式。

本地启动

环境要求：Go 1.26.2+、Node.js 20+。

cd web
npm install
cd ..
make dev

打开 http://127.0.0.1:3100/admin/home，在“设置”中录入模型地址、模型名和 API Key。 本地数据保存在 agenui-agent/var/，不会被 Git 跟踪。make dev 会幂等初始化内置的 知识、接口和算子示例，并一起启动本地数据服务、Agent 与管理后台。

生成成功后，可在会话页点击“下载 Runtime Package”，并独立验证：

go run ./runtime/cmd/agenui-runtime /path/to/agenui-session.json

本地服务和 Agent 必须共用 var/agenui/studio.db。这样在后台保存并发布的 TypeScript 算子， 才能立即被 Operator Detail API 和运行时 Adapter 读取。

对接应用

后台使用 AGenUI 管理接口；业务应用可以订阅原生运行事件：

GET /api/v1/sessions/{session_id}/runs/{run_id}/events
Accept: text/event-stream
X-AGenUI-Tenant-ID: <tenant>
X-AGenUI-User-ID: <user>

以上身份 Header 仅用于本地/测试 profile；生产部署必须接入经过认证的 PrincipalResolver。

更多内容见快速开始、卡片复刻、配置、 架构、规则文档、能力与验收、API 参考和 Knowledge MCP。

社区与联系

• GitHub Issues：问题反馈与功能建议
• 邮箱：[email protected]
• 钉钉群：技术交流群
• 微信群：技术交流群

---

许可证

Apache License 2.0，见 LICENSE。 第三方版权说明见 THIRD_PARTY_NOTICES.md。

安全问题报告与贡献流程见 SECURITY.md 和 CONTRIBUTING.md。