最佳实践 · 发布

AI Agent 文档发布最佳实践

Agent 输出只有在读者能认出作品、核对证据、理解状态并打开正确链接时,才算完成发布。会话里的“已经生成”离交付还差几步。

更新于 2026 年 8 月 3 日实践指南

先写读者契约

  1. 读者与任务是谁。
  2. 事实、建议和未知如何区分。
  3. 证据截止时间与维护人。
  4. 只读、反馈还是阻塞决定。

构建并校验 typed artifact

通过支持的 draft 操作写结构、事实、呈现绑定、媒体和链接,让错误在上传前就可定位。

ow a2ui draft check ./artifact
ow a2ui draft build ./artifact
ow a2ui digest ./artifact/document.mdw

用最小权限发布

  1. 普通读者只发 view。
  2. feedback / review 只交给需要的人。
  3. 只有明确意图才设为 Public。
  4. 只有持续维护的 Public 内容才开启索引。

验收交付,不只看命令

真实浏览器里检查桌面、手机、链接、图片和访问状态;涉及批准或审计时,保存不可变版本。

常见问题

常见问题

文档旁边也该附完整 Agent 对话吗?

只有协作者需要调试过程时才附;多数读者只需要复核后的成果。

publish 成功就算完成吗?

不算。它只证明送达,还要做内容、权限和浏览器验收。

使用真实工作流

把 Agent 创作的作品发表出来。

让每份报告、文档或计划拥有面向读者的页面;批注、评审决定和正式版本都从这里回到 Agent。