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。
104 lines
4.3 KiB
Python
104 lines
4.3 KiB
Python
"""基于 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,
|
||
)
|