planning_interval 参数控制 Agent 在执行过程中周期性暂停行动、生成策略规划的频率。当设置为整数 N 时,Agent 会在第 1 步生成初始计划,之后每 N 个行动步骤再生成一次计划更新。
触发条件为:step_number == 1 或 (step_number - 1) % planning_interval == 0。
默认的规划策略采用结构化的"事实调查"(Facts Survey)方法,要求模型在生成计划前先完成三项分析:
这种方法论在 CodeAgent 和 ToolCallingAgent 中均适用,有助于减少多跳问题中的无效探索。
通过 step_callbacks 参数可以拦截规划过程。当回调函数检测到 PlanningStep 类型时,可实现人工审核工作流——在 Agent 继续执行前检查或修改其计划。这为需要人类监督的关键场景提供了干预点。