用途:本技能聚焦 Agently TriggerFlow 的运行时状态放置与仅运行时依赖设计,帮助判断状态应放在哪里、资源应如何注入,以及状态和资源如何跨子流程边界传递。不涉及普通分支结构、模型请求、中断独立话题、流程配置导出导入或执行恢复机制。前置条件:Agently >= 4.0.8.5。
主要能力:区分 runtime_data / data.state 与 flow_data / data.flow_state;判断依赖应作为流程级还是执行级运行时资源;使用 data.set_resource(...) 做执行作用域资源注入;理解执行 save/load 捕获与不捕获的内容;理解流程配置导出导入保留与不保留的内容;设计重启安全的状态与资源;决定状态和资源如何跨子流程边界。
使用方式:先读 references/state-placement.md 选择 runtime_data 与 flow_data;资源注入、覆盖或 data.set_resource(...) 读 references/resources-and-overrides.md;重启安全、保存/加载边界读 references/persistence-boundaries.md;嵌套父子状态或资源交接读 references/subflow-boundaries.md;实际 save/load 与恢复机制转 agently-triggerflow-execution-state;行为异常时用 references/troubleshooting.md。
核心模型:TriggerFlow 有三个运行时面——runtime_data 仅限单次执行;flow_data 为流程级共享状态;运行时资源用于不可序列化依赖。选择规则:请求局部上下文、单次运行中间值用 runtime_data;同一流程后续执行应看到的共享标志或值用 flow_data;logger、client、服务对象、渲染器或辅助可调用对象用运行时资源;单次执行覆盖流程默认资源用执行级 runtime_resources=...;处理器为当前运行创建临时资源用 data.set_resource(...);保存的执行需重启后恢复则结合 agently-triggerflow-execution-state;状态或资源需跨父子流程边界则结合 agently-triggerflow-subflows;TriggerFlow 运行时之外的长生命周期记忆应使用外部持久化或 agently-session-memo,而非 flow_data。
限制:runtime_data 为执行作用域,不应用于跨执行共享;flow_data 在单个流程对象上共享,可能对同一流程后续执行可见;运行时资源不会被序列化进执行状态或流程配置,只有资源键的期望会保留;流程配置导出导入保留的是对资源的需求而非资源对象本身;子流程只接收被显式捕获进去的状态或资源。