智能体实例状态重置核验工作流

智能体实例状态重置核验工作流

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

面向会复用 executor 或 Agent 实例的长流程：先整理实例范围和 reset hook，再检查可变状态是否跨运行污染，最后在人工确认前阻止残留状态继续服务；只读脱敏 JSON，不调用运行时 reset、不修改会话、不执行外部动作。

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

3步自动化工作流

🔵 1 智能体实例状态合同整理

技能文件：agent-executor-state-contract-normalizer

解决什么： 运行实例的作用域、会话和可变状态不透明时，无法判断是否需要清空旧状态。

你会得到： agent-executor-state-contract.json、规范化实例字段、发现项和 contract_hash。

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

🟢 2 智能体跨运行污染核验

技能文件：agent-cross-run-state-contamination-auditor

解决什么： 共享实例可能把旧 run 的状态键、会话或未清空内容带入新 run。

你会得到： agent-cross-run-state-contamination.json、跨 run 状态键、session 重用和 reset 发现。

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

🔴 3 智能体实例重置就绪闸门

技能文件：agent-executor-reset-readiness-gate

解决什么： 在状态合同或污染审计未通过时，避免实例未经人工确认继续处理新请求。

你会得到： agent-executor-reset-readiness.json、阻断原因、reset_ready 和 gate_hash；最终不会执行 reset。

实际示例

脱敏样例让同一个 planner 共享实例分别服务 run-1 和 run-2，两次运行复用 session-1 与 plan.status，第二次未观察到 reset。运行后会输出 cross_run_mutable_state:plan.status、session_id_reused_for_state:plan.status、reset_not_observed:planner 和 READY_FOR_HUMAN_REVIEW。这是测试样例，不代表真实客户结果。

适合谁

使用 Microsoft Agent Framework、LangGraph、OpenAI Agents SDK 或自研编排器的研发团队；复用 executor、会话或工作流对象的长流程 Agent；需要做版本发布和状态隔离验收的平台团队。

买家只需提供

• 脱敏 executor、run、session 和可变状态字段

• 实例作用域、reset hook 和 reset 观察证据

• 人工放行条件与验收要求

使用方式

1. 使用 Python 3.10 或更高版本，无第三方依赖，分别运行各技能脚本。

2. 把实例合同输出传入污染审计，再把两份结果与人工决定传入闸门。

3. 在测试环境验收后，再由负责人决定是否调用真实运行时的 reset 或重建实例。

交付与验收

• 3 个技能目录，含 _meta.json、SKILL.md、agents/openai.yaml、README、docs、examples 和可执行 Python 脚本。

• 可重复运行脱敏样例；应识别跨 run 状态键、session 重用和未观察到 reset，并输出 READY_FOR_HUMAN_REVIEW、reset_ready=false、external_action_executed=false。

• 字段缺失、共享实例无 reset hook 或污染发现会保留原因，不把 REVIEW 改成 PASS。

• 不包含 Agent 运行时、数据库、队列、账号、密钥、人工复核、reset 调用或持续运维服务。

服务说明

这是离线前置核验工具，不连接 Microsoft Agent Framework、LangGraph、OpenAI Agents SDK 或任何运行时，也不会清空内存、重置 executor、终止任务或写回会话。买家需自行映射框架字段并确认实例生命周期；结果不是完整隔离、灾备、合规或业务连续性保证，不承诺零错误、固定节省或收入结果。