OpenMAIC 新手教程

第 6 章:Agent 工作台

v1.0.0 的 Pro 模式:用对话规划、生成、改整门课。默认关闭。

1什么时候才需要

经典一键生成够用就别开。工作台适合:要改很多页、要从材料精修、要中途转向、要可恢复的长会话。

从首页 Pro 入口进入。左侧是可收起的文件夹 / 会话栏,中间聊天,右侧课堂页签。回经典模式的按钮也在工作区里。

2怎么打开

必须和「服务端持久化」用同一套 PostgreSQL。构建期开关 + 运行时数据库,缺一不可:

NEXT_PUBLIC_PRO_WORKBENCH_ENABLED=true
OPENMAIC_AGENT_RUNTIME_ENABLED=true
DATABASE_URL=postgres://openmaic:openmaic-dev@postgres:5432/openmaic
MODEL_ROUTES='{"maic-agent-driver":{"model":"openai:gpt-5.5","api":"openai-completions"}}'
MODEL_ROUTES 必须显式指定 maic-agent-driver 的模型,且 api 只能是 openai-completions 或 openai-responses。没有默认回退。没配 DATABASE_URL 时 runner 不会启动。

开关关闭时,/api/agent/sessions* 直接 404。还要浏览器也走服务端文档库的话,再按 README 打开 NEXT_PUBLIC_PERSISTENCE=1。

3代理实际会调哪些工具

类别能力
规划多课课纲、建课、文件夹、重命名移动
编写读/搜 DSL、补丁改一页、增删改排序、改旁白
材料上传、抽取文档音视频、搜摘录、拉可信 URL
媒体按已配置的服务端提供商生成图、视频、旁白
导入保留版式导入 .pptx,预览场景
课堂配置音色列表、代理阵容、可插拔的声音克隆

20 个内置技能覆盖备课、深研、交互、讲座、工作坊、职业课、幻灯工艺、PPT 导入和风格复用。用户技能按所有者存放。

4权限直觉

stage ID 足以读一门未删除的课;改课仍只限所有者。凭证留在服务端,不会发到浏览器。任一能力可用 *_ENABLED=false 强制关掉;模型路由解析失败会直接报错,而不是猜一家供应商。

OpenMAIC 新手教程 · 清华大学 MAIC 团队开源的多代理交互课堂
GitHub 仓库 · 在线体验 · MIT 开源