Files
bot042/tests/test_builtin.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

268 lines
9.0 KiB
Python

"""内置任务 AgentReply 测试:会话分区、落库、RPC 回复与失败提示。"""
from __future__ import annotations
import asyncio
from datetime import datetime
from pathlib import Path
from typing import Any
import pytest
from bot042.agent.middlewares.budget import StepBudgetExceeded
from bot042.channels.base import BaseChannel
from bot042.channels.manager import ChannelManager
from bot042.channels.models import (
ChannelMessage,
ChannelSubject,
InboundMessage,
TextContent,
)
from bot042.config import Settings
from bot042.db import repo
from bot042.flows import builtin
from bot042.flows.builtin import (
BUDGET_REPLY,
ERROR_REPLY,
RPC_SEND,
AgentReply,
ChannelServices,
)
from bot042.flows.bus import EventBus
from bot042.flows.rpc import RpcHub
from bot042.flows.scheduler import CN_TZ
from bot042.flows.tasks import EventTrigger, RunStatus, TaskContext, TaskRunner
class EchoChannel(BaseChannel):
"""测试渠道:任何 subject 都视为已登记,发送记录在内存。"""
channel_type = "echo"
def __init__(self) -> None:
super().__init__(channel_id="c1")
self.sent: list[str] = []
async def start(self) -> None:
pass
async def stop(self) -> None:
pass
def parse_inbound(self, raw_payload: Any) -> InboundMessage:
assert isinstance(raw_payload, InboundMessage)
return raw_payload
def get_subject(self, subject_id: str) -> ChannelSubject | None:
return ChannelSubject(subject_id=subject_id)
async def _send_text(self, subject: ChannelSubject, text: str) -> None:
self.sent.append(text)
async def _send_content(self, subject: ChannelSubject, parts: list) -> None:
pass
async def _send_media(self, subject: ChannelSubject, media: Any) -> None:
pass
def _envelope(
text: str, *, session: str | None = "s1", subject: str = "u1"
) -> ChannelMessage:
message = InboundMessage(
channel_id="c1",
channel_type="echo",
channel_session_id=session,
channel_subject=ChannelSubject(subject_id=subject),
content=[TextContent(text=text)],
)
return ChannelMessage.of(message, session_key=session or "")
def test_partition_key_matches_db_session_id() -> None:
"""分区键必须与会话历史使用的 session_id 一致。"""
ctx = TaskContext(
run_id="r1",
task=AgentReply.name,
event="channel.inbound",
fired_at=datetime.now(CN_TZ),
payload=_envelope("hi"),
)
assert AgentReply.partition_key(ctx) == "s1"
# 群聊:渠道锁键是发送者(user-a),历史会话键是群(chat-9),分区跟历史走
group = _envelope("hi", session="chat-9").model_copy(
update={"session_key": "user-a", "subject_id": "user-a"}
)
ctx2 = ctx.model_copy(update={"payload": group})
assert AgentReply.partition_key(ctx2) == "chat-9"
# 没有平台会话 ID 时回退「渠道:主体」,与 run() 的落库表达式一致
ctx3 = ctx.model_copy(update={"payload": _envelope("hi", session=None)})
assert AgentReply.partition_key(ctx3) == "c1:u1"
def test_db_session_id_property() -> None:
"""db_session_id 是落库与分区共用的唯一来源(消息本体与总线载荷一致)。"""
group = _envelope("hi", session="chat-9")
assert group.db_session_id == "chat-9"
assert group.message.db_session_id == "chat-9"
direct = _envelope("hi", session=None)
assert direct.db_session_id == "c1:u1"
assert direct.message.db_session_id == "c1:u1"
def test_agent_reply_persists_and_replies_via_rpc(
monkeypatch: pytest.MonkeyPatch, tmp_path: Path
) -> None:
calls: list[tuple[str, list]] = []
async def fake_run_task(
task, settings=None, history=None, *, cache=None, steering=None
):
calls.append((task, list(history or [])))
return {"messages": [{"role": "assistant", "content": "答:" + task}]}
monkeypatch.setattr(builtin, "run_task", fake_run_task)
async def _run() -> tuple[list[str], list[str], list[str]]:
bus = EventBus()
bus.bind_loop()
hub = RpcHub(bus)
manager = ChannelManager()
channel = EchoChannel()
await manager.add_channel(channel)
await manager.start()
_ = hub.serve(RPC_SEND, manager.rpc_send)
services = ChannelServices(
channels=manager,
settings=Settings(),
db=tmp_path / "bot.db",
hub=hub,
)
runner = TaskRunner(bus, deps=services)
runner.register(AgentReply)
_ = runner.add_task(AgentReply.name, EventTrigger(event="channel.inbound"))
await runner.start()
bus.emit("channel.inbound", _envelope("第一句"))
bus.emit("channel.inbound", _envelope("第二句"))
await runner.wait_idle(timeout=2)
await bus.wait_for_complete()
runs = runner.runs(AgentReply.name)
keys = [run.key for run in runs]
statuses = [run.status.value for run in runs]
await runner.stop()
hub.close()
await manager.stop()
return channel.sent, keys, statuses
sent, keys, statuses = asyncio.run(_run())
assert sent == ["答:第一句", "答:第二句"]
assert keys == ["s1", "s1"]
assert statuses == ["succeeded", "succeeded"]
# 第二轮上下文里有第一轮问答
assert calls[1][1] == [
{"role": "user", "content": "第一句"},
{"role": "assistant", "content": "答:第一句"},
]
rows = asyncio.run(repo.list_messages(tmp_path / "bot.db", session_id="s1"))
assert [(r["role"], r["content"]) for r in rows] == [
("user", "第一句"),
("assistant", "答:第一句"),
("user", "第二句"),
("assistant", "答:第二句"),
]
def test_agent_reply_sends_error_hint_on_failure(
monkeypatch: pytest.MonkeyPatch, tmp_path: Path
) -> None:
async def boom(task, settings=None, history=None, *, cache=None):
raise RuntimeError("agent down")
monkeypatch.setattr(builtin, "run_task", boom)
async def _run() -> tuple[list[str], list[RunStatus]]:
bus = EventBus()
bus.bind_loop()
hub = RpcHub(bus)
manager = ChannelManager()
channel = EchoChannel()
await manager.add_channel(channel)
await manager.start()
_ = hub.serve(RPC_SEND, manager.rpc_send)
services = ChannelServices(
channels=manager, settings=Settings(), db=tmp_path / "bot.db", hub=hub
)
runner = TaskRunner(bus, deps=services)
runner.register(AgentReply)
_ = runner.add_task(AgentReply.name, EventTrigger(event="channel.inbound"))
await runner.start()
bus.emit("channel.inbound", _envelope("会失败"))
await runner.wait_idle(timeout=2)
await bus.wait_for_complete()
statuses = [run.status for run in runner.runs(AgentReply.name)]
await runner.stop()
hub.close()
await manager.stop()
return channel.sent, statuses
sent, statuses = asyncio.run(_run())
assert sent == [ERROR_REPLY]
assert statuses == [RunStatus.FAILED]
def test_agent_reply_explains_step_budget_without_generic_error(
monkeypatch: pytest.MonkeyPatch, tmp_path: Path
) -> None:
"""步数用尽:给出可操作说明并落库,且不再补发通用错误文案。"""
async def exhausted(task, settings=None, history=None, *, cache=None, steering=None):
raise StepBudgetExceeded(200)
monkeypatch.setattr(builtin, "run_task", exhausted)
async def _run() -> tuple[list[str], list[RunStatus]]:
bus = EventBus()
bus.bind_loop()
hub = RpcHub(bus)
manager = ChannelManager()
channel = EchoChannel()
await manager.add_channel(channel)
await manager.start()
_ = hub.serve(RPC_SEND, manager.rpc_send)
services = ChannelServices(
channels=manager, settings=Settings(), db=tmp_path / "bot.db", hub=hub
)
runner = TaskRunner(bus, deps=services)
runner.register(AgentReply)
_ = runner.add_task(AgentReply.name, EventTrigger(event="channel.inbound"))
await runner.start()
bus.emit("channel.inbound", _envelope("把整站重构一遍"))
await runner.wait_idle(timeout=2)
await bus.wait_for_complete()
statuses = [run.status for run in runner.runs(AgentReply.name)]
await runner.stop()
hub.close()
await manager.stop()
return channel.sent, statuses
sent, statuses = asyncio.run(_run())
notice = BUDGET_REPLY.format(steps=200)
assert sent == [notice] # 只有说明,没有多余的「处理消息时出错」
assert statuses == [RunStatus.FAILED]
# 失败轮也要落库:用户已经看到这段内容,历史缺了它会前后不接
rows = asyncio.run(repo.list_messages(tmp_path / "bot.db", session_id="s1"))
assert [(r["role"], r["content"]) for r in rows] == [
("user", "把整站重构一遍"),
("assistant", notice),
]