智能体流式恢复核验工作流

智能体流式恢复核验工作流

3个实用技能 · 3步完成 · 每一步都能单独使用

把智能体流式运行在 guardrail 阻断、人工审批和恢复时的事件配对变成可核验材料：先整理流式事件和工具调用配对，再识别孤立调用、未配对输出和 stream/non-stream 路径差异，最后生成等待负责人确认的恢复包。套餐不连接模型、Agent Session 或消息系统，不自动恢复、不删除历史、不重放工具。

3个可下载技能 · 每个技能可单独运行

3步自动化工作流

🔵 1 智能体流式事件归一

技能文件：agent-stream-event-normalizer

解决什么： 流式事件、function_call、function_call_output 和 guardrail 状态可能分别记录，恢复前难以确认顺序、call_id 和持久化状态。

What you get: READY/REVIEW、排序事件、call_pairs、孤立调用列表和 stream_history_snapshot_hash。

↓ 本步结果自动进入下一步

🟢 2 智能体流式孤立调用审计

技能文件：agent-stream-orphan-auditor

解决什么： guardrail 触发或恢复分叉可能留下没有输出的 function_call、无对应调用的输出，或让流式与非流式路径保存不同历史。

What you get: PASS/REVIEW/BLOCKED、孤立调用、未配对输出、路径差异、stream_resume_safe_claim 和 stream_resume_audit_hash。

↓ 本步结果自动进入下一步

🟠 3 智能体流式恢复门禁

技能文件：agent-stream-resume-gate

解决什么： 离线审计不应直接恢复运行、删除孤立调用或改写 Session；负责人还需要看到恢复目标和回滚引用。

What you get: READY_FOR_HUMAN_STREAM_RESUME/HOLD_FOR_HUMAN_STREAM_RESUME、human_decision=PENDING、resume_execute=false、session_write=false、replay_execute=false 和 stream_resume_review_packet_hash；这是最终交付。

实际示例

脱敏样例包含一条用户事件、一个已完成 function_call 及其对应 output，且所有事件来自 stream 路径。第一步固定顺序、call_id、配对和消费状态；第二步按 orphan、未配对输出和路径差异检查；第三步要求负责人、恢复目标和回滚引用齐全后生成等待人工确认的复核包。删掉 function_call_output、改变 call_id、混入非 stream 路径或把 stream_consumed 改为 false，会产生 BLOCKED/REVIEW。样例只验证离线字段和分支，不代表真实 Session 已一致或工具结果已执行。

适合谁

• 使用流式 Agent、工具调用和输出 guardrail 的工程师

• 需要处理审批暂停、stream_events 和 RunState 恢复的开发团队

• 需要比对流式与非流式历史一致性的质量人员

• 需要在续跑前保留负责人、回滚和人工复核证据的治理人员

买家只需提供

• 已授权且脱敏的 run_ref、流式事件和消费状态

• item_id、kind、sequence、call_id、status、persisted 和路径摘要

• guardrail、恢复目标、负责人引用和回滚引用

使用方式

1. 使用 Python 3.10 或更高版本，将流式事件摘要写成 UTF-8 JSON；不要放入原始参数、凭据或业务数据。

2. 依次运行流式事件归一、孤立调用审计和人工恢复门禁，也可以单独运行任一步。

3. 由有权限的负责人在自己的 Agent Session 和运行时中完成恢复、历史修正和工具重试；本套餐只提供离线核验材料。

交付与验收

• 三个独立技能目录，每个包含元数据、技能说明、执行器、文档和脱敏样例。

• 三步可重复运行：事件归一、孤立调用审计、人工流式恢复门禁；每个技能也能单独使用。

• 缺 run_ref、call_id、配对输出、消费状态，或检测到孤立调用、路径差异和未配对输出时，均产生明确 REVIEW/BLOCKED 分支。

• 通过样例输出 READY_FOR_HUMAN_STREAM_RESUME，并保留 PENDING、resume_execute=false、session_write=false 和 replay_execute=false；错误样例不会修改线上 Session。

服务说明

脚本只处理买家有权使用且已经脱敏的本地 JSON，不连接模型、Agent、Session、数据库或消息队列，不读取 token、不执行恢复、不删除历史、不重放工具、不写入会话。离线检查不能证明真实运行时遵守 stream/non-stream 一致性、工具调用配对或回滚结果，也不能替代端到端测试、SDK 升级和人工审批。套餐不承诺流式稳定性、零孤立调用、合规结论或业务结果。