展开本页目录
开始前准备什么
- Node.js 24 和 npm。
- 下载并解压本页的复现包。样例在本机运行。
- 准备样例
- 运行脚本
- 对照结果
- 核对自己的应用
下载脚本和完整输出
包含版本锁定文件、操作说明、运行脚本和原始输出。
操作步骤
- 解压样例,在解压目录执行 npm ci,再运行 node ag-ui.mjs。脚本在本机启动 SSE 服务并自动发送三组请求。
- 查看 approval.initial 和 approval.restored。两个客户端都发送 order-17,本机服务返回同一个 review-1,状态都是 pending。
- 查看 approval.otherThread。把 threadId 改成 order-18 后,样例返回 approval: null。若你的页面也丢卡片,先比对刷新前后的请求体,再检查后端是否返回 STATE_SNAPSHOT。
- 把快照恢复和审批提交放在两个处理流程里。恢复时只渲染已保存的状态,点击同意时才提交审批 ID。接入真实服务时,服务器仍需校验会话所有权。
关键代码
ag-ui.mjs
javascript
const restored = new HttpAgent({
url: base + '/approval',
threadId: 'order-17',
});
await restored.runAgent();
assert.equal(restored.state.approval.status, 'pending');实测结果
| 操作 | threadId | 客户端快照 |
|---|---|---|
| 首次打开 | order-17 | review-1 / pending |
| 重建客户端 | order-17 | review-1 / pending |
| 切换线程 | order-18 | null |
- 操作
- 首次打开
- threadId
- order-17
- 客户端快照
- review-1 / pending
- 操作
- 重建客户端
- threadId
- order-17
- 客户端快照
- review-1 / pending
- 操作
- 切换线程
- threadId
- order-18
- 客户端快照
- null
怎样确认已经完成
- 刷新前后的两次请求使用同一个已授权 threadId。
- 待审批 ID 和状态恢复后才渲染卡片。
- 读取快照的请求不执行审批。
常见问题
可以用这个示例直接提交 CopilotKit 审批吗?
示例用 AG-UI HttpAgent 和本机 SSE 验证状态恢复。实际批准接口由业务后端实现,可以沿用相同的会话 ID 和审批 ID 核对方法。
