用途:本技能处理 TriggerFlow 执行实例的运行时持久化,即保存、加载与恢复某个正在运行或已完成的执行。它不涉及流程定义的导出/导入,也不涉及 Mermaid。前置条件为 Agently >= 4.0.8.5。
主要能力:支持 execution.save() 与 execution.load();可保存到或加载自 dict、JSON 字符串、YAML 字符串、JSON 文件、YAML 文件;可恢复处于等待状态的执行;可恢复最终结果已就绪的执行;恢复后可使用 continue_with(...);可理解执行状态包含与不包含的内容;可在恢复后重新注入运行时资源。
核心模型:执行状态是单个执行实例的已保存运行时表面,包含执行状态、运行时数据、流程数据快照、待处理中断、最后信号、最终结果就绪状态与值、资源键名。它不携带可执行资源对象本身。标准恢复模式为:重建或复用正确的流程定义,创建新的执行,加载已保存的执行状态,重新注入所需运行时资源,然后继续或读取结果。
典型业务恢复顺序:恢复或重建正确的流程定义;在该定义上创建新执行;加载已保存的执行状态;重新注入运行时资源;若执行处于等待状态,检查中断并继续;若结果已就绪,直接读取结果。
选择规则:稍后恢复等待中的执行,先 execution.save() 再在新执行上 execution.load();恢复结果已就绪的已完成执行,execution.load() 后调用 get_result() / async_get_result();持久化为可传输产物,保存为 JSON 或 YAML 文件;从内存载荷恢复,从 dict 或 JSON/YAML 字符串加载;恢复后的执行需要仅运行时工具或服务,向 load(...) 传 runtime_resources=... 或在继续前重新注入;若需在持久化前决定状态或资源放置位置,使用 agently-triggerflow-state-and-resources;若需导出或导入定义本身,使用 agently-triggerflow-config。
限制与边界:执行状态针对单个运行中或已完成的执行,而非可复用流程定义;运行时资源仅以 resource_keys 表示,不序列化可调用对象或客户端;等待中断可恢复并继续,但仍需正确的执行定义与资源就位;流程配置与执行状态互补,不可互换。
参考文档:references/source-map.md、state-surfaces.md、save-load-roundtrip.md、waiting-and-resume.md、business-restore-recipes.md、runtime-resource-reinjection.md、troubleshooting.md。