第 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 强制关掉;模型路由解析失败会直接报错,而不是猜一家供应商。