fix(flows): 步数预算与图硬上限分离,预算耗尽时优雅收尾

max_steps 以前同时充当软预算和 recursion_limit,于是预算耗尽的那一刻
必然触发 GraphRecursionError:模型连一句收尾都来不及说,用户只收到
「处理消息时出错,请稍后再试」,已产出的内容也不会落库。

- 新增 StepBudgetMiddleware:按模型调用轮数计账(agent_rounds =
  max_steps // 2),剩余 <=4 轮时注入一次「立刻停止调用工具、给出结论」
  的收尾提示,只提醒一次
- 新增 STEP_GRACE(20),recursion_limit = max_steps + STEP_GRACE,把余量
  留给收尾动作
- GraphRecursionError 统一转成 StepBudgetExceeded,ainvoke 与流式两条
  路径都覆盖
- AgentReply 把「步数用尽」渲染成可操作说明,接在已产出内容之后一并
  下发并落库;用 _reported 标记让 on_error 不再补发通用错误文案,任务
  状态仍如实记 failed
- 同步 README / docs/architecture.md / db/schema.py 中 max_steps 的语义

测试:新增 tests/test_budget.py(7 个用例),全量 241 passed。
This commit is contained in:
openbot committed 2026-11-09 21:32:29 +08:00
1 parent fbb01c4c83
commit 5da55f8d17
12 files changed
+531 -40

No files matched your search

+4 -2
View File
@@ -11,6 +11,7 @@ from deepagents.backends import LocalShellBackend
from langchain.agents.middleware.types import AgentMiddleware
from langgraph.graph.state import CompiledStateGraph
from bot042.agent.middlewares.budget import StepBudgetMiddleware
from bot042.agent.middlewares.steering import SteeringMiddleware
from bot042.agent.prompts import SYSTEM_PROMPT
from bot042.agent.tools import get_tools
@@ -90,12 +91,13 @@ def create_agent(
"openai:gpt-4o-mini"、"openai:deepseek-chat"(配合 OPENAI_BASE_URL)等。
"""
settings = settings or Settings.from_env()
# SteeringMiddleware 放最前:每轮模型调用前都先消化插话
# SteeringMiddleware 放最前:每轮模型调用前都先消化插话;
# StepBudgetMiddleware 紧随其后:预算将尽时注入收尾提示,避免撞硬上限
return create_deep_agent(
model=_build_model(settings),
tools=get_tools(),
system_prompt=SYSTEM_PROMPT,
backend=_build_backend(settings),
middleware=[SteeringMiddleware(), *middleware],
middleware=[SteeringMiddleware(), StepBudgetMiddleware(), *middleware],
interrupt_on=interrupt_on,
)