第1章 边界问题定义与复盘目标

1.1 现象识别 – 什么是 Agent 边界问题

在真实项目运行中，Agent 边界问题通常表现为以下现象：

• 任务未完成：Agent 执行中途无响应或返回空结果，不满足用户意图。
• 异常响应：输出格式错误、调用参数越界、语义重复或逻辑矛盾。
• 资源泄漏：会话上下文爆满、工具调用链未正确关闭，导致服务降级。
• 安全逃逸：Agent 突破系统设定的权限边界，访问未授权的数据或功能。

以下是一段典型边界问题日志摘录：

2025-03-21 14:32:17 ERROR agent_context_manager - Context window overflow: 
  current_tokens=16385, max_tokens=16384, action='drop_oldest'
2025-03-21 14:32:17 WARN tool_executor - Tool 'search_files' called with 
  path='/../../etc/passwd' blocked by path_sanitizer

1.2 数据采集 – 复盘范围

本章复盘覆盖以下数据源和项目范围：

复盘项目涵盖：对话机器人、代码生成助手、数据分析 Agent 及多步任务编排服务。

1.3 原因定位 – 边界问题故障树

边界问题的根因可归纳为五大类别，故障树如下：

• ① 上下文边界：Token 超限、窗口滑动策略不当、长记忆丢失。
• ② 工具调用边界：参数格式不匹配、返回结果解析失败、工具链深度限制。
• ③ 权限与安全边界：路径遍历、命令注入、角色切换跨度过大。
• ④ 并发与状态边界：竞争条件、死锁、会话状态不一致。
• ⑤ 模型能力边界：指令遵循降级、逻辑虚构、知识截止日期。

判断规则：

1. 若日志出现 context_window_overflow 或 max_tokens 警告 → 优先归入边界①。
2. 若工具返回 PARSE_ERROR 或 INVALID_ARGUMENT → 检查边界②。
3. 若安全日志触发 PATH_TRAVERSAL 或 UNAUTHORIZED_ACCESS → 定位为边界③。
4. 若同时出现多个 Agent 实例的 STALE_STATE → 排查边界④。
5. 若输出逻辑明显违反常识且无上下文报错 → 疑似边界⑤。

1.4 修复动作 – 边界修复模式

针对不同边界类型的修复动作示例：

• 上下文边界：采用分级摘要 + 滑动窗口；设置硬性 token 预留阈值。
• 工具调用边界：强化参数校验、增加重试与降级策略。
• 权限边界：实施最小权限原则、路径白名单、沙箱执行。
• 并发边界：引入分布式锁、会话版本号、乐观重试。
• 模型边界：添加前置指令约束、后处理逻辑纠偏。

1.5 复测 – 验证标准

修复后需通过以下复测用例才算通过：

1.6 预防 – 边界防护体系建设

从以下四个维度建立持续预防机制：

• 监控预警：对 token 消耗、工具调用耗时、安全事件设置告警阈值。
• 自动化测试：将边界案例加入回归测试集，每次部署前执行。
• 设计规范：所有 Agent 必须显式声明边界条件（如最大上下文、支持的工具参数 schema）。
• 定期复盘：每月召开边界问题复盘会，更新故障树与判断规则。