Files
bot042/src/bot042/agent/base.py
T
openbot 5da55f8d17 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。
2026-11-09 21:32:29 +08:00

104 lines
4.3 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""基于 deepagents 组装自主行动智能体。"""
from __future__ import annotations
from collections.abc import Sequence
from pathlib import Path
from typing import Any
from deepagents import create_deep_agent
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
from bot042.config import Settings
EXECUTE_TIMEOUT = 120
"""单条 shell 命令的默认超时秒数(可由模型在单次调用里放宽)。"""
def _build_backend(settings: Settings) -> LocalShellBackend:
"""本地执行后端:真实磁盘 + 宿主机 shell,没有沙箱隔离。
- ``root_dir`` 取 home 目录:文件工具的虚拟路径(如 ``/plan.md``)落在
``~/.bot042`` 内,不把宿主目录搅乱;
- shell 不受 ``root_dir`` 限制,``execute`` 能跑任意命令、直接调用 Python;
- ``inherit_env=True`` 让 PATH 等变量可见(否则连解释器都找不到),
代价是模型也能读到进程环境里的密钥——本地单机原型接受这个取舍。
"""
root = Path(settings.home)
root.mkdir(parents=True, exist_ok=True)
return LocalShellBackend(
root_dir=root,
virtual_mode=True,
timeout=EXECUTE_TIMEOUT,
inherit_env=True,
)
def _build_model(settings: Settings) -> Any:
"""按配置构建模型;没有显式凭据时回退到 ``"provider:model"`` 字符串。
- 无 ``api_key`` 且无 ``base_url``:返回字符串,由 langchain 从环境变量取凭据
(行为与改造前一致);
- 有凭据:直接构造 ``ChatOpenAI``,支持数据库里配置的 OpenAI 兼容网关;
- 非 ``openai`` 前缀(如 ``anthropic:``)暂不支持显式凭据,同样回退字符串。
"""
if not settings.api_key and not settings.base_url:
return settings.model
provider, sep, name = settings.model.partition(":")
if sep and provider != "openai":
return settings.model
from langchain_openai import ChatOpenAI
# 本地网关可能不校验密钥,但 AsyncOpenAI 不接受空值,用占位串兜底
kwargs: dict[str, Any] = {
"model": name if sep else settings.model,
"api_key": settings.api_key or "EMPTY",
}
if settings.base_url:
kwargs["base_url"] = settings.base_url
return ChatOpenAI(**kwargs)
def create_agent(
settings: Settings | None = None,
*,
interrupt_on: dict[str, Any] | None = None,
middleware: Sequence[AgentMiddleware[Any, Any, Any]] = (),
) -> CompiledStateGraph[Any, Any, Any, Any]:
"""构建 deepagents 智能体(返回图支持 `ainvoke` 异步调用)。
- FilesystemMiddleware:ls/read_file/write_file/edit_file/delete/glob/grep,
后端支持执行时额外挂载 ``execute``(shell 命令)
- SubAgentMiddleware:task(子智能体派发)
- SummarizationMiddleware:compact_conversation(上下文压缩)
``backend`` 显式固定为 :class:`LocalShellBackend`:文件真实落盘、命令直接
在宿主机执行(无沙箱)。这一条是有意为之——原型需要读写真实文件、跑
bash 与 Python;不要依赖 deepagents 的默认后端,默认值变化会让能力悄悄漂移。
人工确认(HumanInTheLoopMiddleware)通过 interrupt_on 启用,例如
{"move": True, "execute": True} 表示调用前中断、等待人工确认。
model 支持 langchain 的 "provider:model" 标识,如
"openai:gpt-4o-mini"、"openai:deepseek-chat"(配合 OPENAI_BASE_URL)等。
"""
settings = settings or Settings.from_env()
# SteeringMiddleware 放最前:每轮模型调用前都先消化插话;
# StepBudgetMiddleware 紧随其后:预算将尽时注入收尾提示,避免撞硬上限
return create_deep_agent(
model=_build_model(settings),
tools=get_tools(),
system_prompt=SYSTEM_PROMPT,
backend=_build_backend(settings),
middleware=[SteeringMiddleware(), StepBudgetMiddleware(), *middleware],
interrupt_on=interrupt_on,
)