第2章 Agent边界问题分类总览：语义边界、权限边界、数据边界、责任边界

2.1 问题现象：边界模糊引发的“四类迷雾”

在真实生产环境中，Agent因缺乏明确的系统边界划分，引发的行为异常通常可归纳为四大类。团队常将不同性质的故障混为一谈，导致排查方向偏离。识别问题的首要动作是判断“这属于哪一类边界问题”。

识别阶段的核心判断规则：先区分“听不懂/理解错”（语义）、“不能做/不该做”（权限）、“改不对/写串了”（数据）、“没人做/做两次”（责任）。

2.2 数据采集：故障树的四根“证据链”

锁定边界类型后，需要依据对应的证据链进行数据采集。下面是一棵用于定位边界的通用采样故障树。

判断规则：数据采集完成后，使用“边界类型诊断公式”定位根因。

• 语义边界公式： 如果 Prompt日志中意图解析结果 与 用户原Query 出现 3个以上字段偏差，则判定为语义边界问题。
• 权限边界公式： 如果 API访问日志 返回状态码 403 | 401 且 当前Agent角色 不包含目标资源 scope，则判定为权限边界问题。
• 数据边界公式： 如果 数据库审计日志 显示 update/delete 操作 跨越了定义的“数据分区键”，且无授权记录，则判定为数据边界问题。
• 责任边界公式： 如果 任务队列日志 中同一任务ID被 连续两次以上 分配给不同Agent，或超时后无Agent认领，则判定为责任边界问题。

2.3 原因定位：四个边界的根本起因

基于上述采集项，深入剖析每个边界的典型根因。

2.4 修复动作：类型专项修复方案

针对每一种边界问题，推荐的修复动作清单如下：

• 语义边界修复：
  • 步骤 A：在Prompt中显式注入 业务术语对照表，并用 System Message 固定术语含义。
  • 步骤 B：设置语义消歧护栏，当意图置信度低于 0.75 时，触发人工确认流程。
  • 步骤 C：对长上下文场景实施分块召回+摘要注入，避免上下文截断。
• 权限边界修复：
  • 步骤 A：重构权限模型，为每个Agent创建最小作用域令牌。
  • 步骤 B：在API网关层添加动态权限校验中间件，拦截越权调用。
  • 步骤 C：实施短时令牌+定期换肤策略，减少静态凭证泄露风险。
• 数据边界修复：
  • 步骤 A：为所有Agent操作的数据表增加数据域标识（如 agent_id 字段）。
  • 步骤 B：建立读写分离架构，每个Agent只允许写入自己的数据分区。
  • 步骤 C：启用乐观锁或悲观锁机制，确保写操作原子性。
• 责任边界修复：
  • 步骤 A：采用工作流状态机的“谁创建、谁负责”模式，避免重复认领。
  • 步骤 B：为定时任务/重试队列添加幂等性ID，确保任务只被执行一次。
  • 步骤 C：设置超时转移策略，超时后自动转入死信队列或指定负责人。

-- 为 orders 表增加 agent_owner 分区键
ALTER TABLE orders ADD COLUMN agent_owner VARCHAR(64);
CREATE INDEX idx_orders_agent_owner ON orders(agent_owner);

-- 修改业务Agent的写入语句，强制绑定agent_owner
UPDATE orders SET status = 'shipped' WHERE id = 101 AND agent_owner = 'order-agent-v3';

-- 增加触发验证，禁止跨Agent更新
CREATE OR REPLACE FUNCTION check_agent_owner()
RETURNS TRIGGER AS $$
BEGIN
  IF NEW.agent_owner != current_setting('app.current_agent_id') THEN
    RAISE EXCEPTION '数据边界违反: agent_owner 不匹配';
  END IF;
  RETURN NEW;
END;
$$ LANGUAGE plpgsql;

2.5 复测：边界问题修复验证矩阵

修复后，使用下面的标准化矩阵验证边界是否真正收敛。

2.6 预防：边界四象限防御体系

为防止边界问题在开发迭代中反复出现，建议将以下防御规则纳入Agent应用的CI/CD流水线。

• 预防语义边界漂移：
  • 在模型Fine-tuning阶段，加入负样本数据集（包含常见歧义Query）。
  • 每次上线前执行Prompt语义正交性测试，确保新模板不与其他Agent的意图空间重叠。
• 预防权限边界泄露：
  • 使用IaC（基础设施即代码）管理RBAC策略，确保最小权限策略可通过Git回滚。
  • 在预发布环境做渗透测试扫描，检测未授权访问路径。
• 预防数据边界污染：
  • 建立数据血缘追踪，记录每个数据变更的“Owner Agent”。
  • 在ORM层实现多租户拦截器，自动追加当前Agent的身份过滤条件。
• 预防责任边界真空：
  • 实施任务契约测试，确保每个Agent都定义了“管辖任务集合”，并校验无交集。
  • 在架构评审中增加责任边界检查项，使用“责任矩阵图”确保每个系统功能有且只有一个主责Agent。