多智能体协作先把控制边界写清

在构建 AI Agent 架构与多 Agent 协作系统的过程中，许多团队容易照搬网络上炫酷但缺乏工程落地的“反模式做法”：例如让 Agent 自主无限期递归创建子 Agent、将整个系统日志全量丢入 Prompt 让 LLM 寻找 Bug，或者试图让多 Agent 之间完全基于自然语言自由协商而放弃有限状态机（FSM）控制。

这些看似聪明的做法在实际生产环境中极其危险。工程落地必须遵循确定性控制优先的准则，避开无边界递归与盲目信任 LLM 协商的陷阱。

1. 看似聪明但危险的三大反模式与原理推导

在 Multi-Agent 架构演进推导中，三大经典反模式如下：

第一反模式：自主无限递归创建子 Agent（Unbounded Self-Spawning Agents）。宣称“Agent 会根据问题自动拆分并生成 100 个子 Agent 来并行解决”。在生产环境中，一旦 LLM 发生幻觉，子 Agent 将呈指数爆炸式创建，几分钟内消耗数百万 Token，直接打爆 API 账单。

第二反模式：放弃有限状态机（FSM），盲目采用自由 P2P 协商。认为“给 Agent 自由度更高，效果越好”。缺少程序代码级别的状态转移控制，导致 Agent A 与 Agent B 在遇到异常时互相推诿，陷入无限多轮的废话循环。

第三反模式：将未经清理的全量日志直接塞入 Context（Raw Log Dumping）。将几万行的原始崩溃堆栈直接拼接到 Prompt 中，导致大模型注意力分配严重漂移，产生严重的幻觉调用。

2. 生产级 Python 多 Agent 反模式防护门禁实现

以下展示基于 Python 实现的 Agent 架构反模式静态防护门禁：

import logging
from typing import Dict, Any, List

logging.basicConfig(level=logging.INFO, format="%(asctime)s [%(levelname)s] %(message)s")

class AgentAntiPatternDetector:
    def __init__(self, max_allowed_agent_depth: int = 3):
        self.max_allowed_agent_depth = max_allowed_agent_depth

    def inspect_architecture_config(self, config: Dict[str, Any]) -> bool:
        logging.info("开启多 Agent 架构反模式静态审计...")
        
        is_safe = True
        
        # 1. 检测是否允许动态递归创建 Agent
        if config.get("allow_dynamic_child_spawning", False):
            logging.error("[反模式拦截] 开启了动态创建子 Agent 功能！这极易引发 Token 算力失控！")
            is_safe = False

        # 2. 检测 Agent 嵌套深度
        depth = config.get("agent_hierarchy_depth", 1)
        if depth > self.max_allowed_agent_depth:
            logging.error(f"[反模式拦截] Agent 嵌套层级 ({depth}) 超过安全上限 ({self.max_allowed_agent_depth})！")
            is_safe = False

        # 3. 检测是否缺乏 FSM 状态机接管
        if not config.get("use_fsm_control", True):
            logging.error("[反模式拦截] 放弃了有限状态机 FSM 控制！Agent 间自由协商易引发死锁！")
            is_safe = False

        if is_safe:
            logging.info("多 Agent 架构通过反模式审计，具备生产落地可行性！")
        return is_safe

if __name__ == "__main__":
    detector = AgentAntiPatternDetector()
    unsafe_config = {
        "allow_dynamic_child_spawning": False,
        "agent_hierarchy_depth": 2,
        "use_fsm_control": True
    }
    
    detector.inspect_architecture_config(unsafe_config)

3. 架构防护的度量指标

• agent_antipattern_blocked_total: 拦截的反模式架构配置数。
• agent_hierarchy_max_depth: 当前系统的 Agent 最大嵌套深度。

4. 架构设计的黄金法则

第一，坚持确定性大于灵活度（Determinism Over Flexibility）。用有限状态机代码控制跳转。

第二，限制 Agent 拓扑深度（Bound Agent Depth）。嵌套层级强制 <= 3。

拓扑图中还应明确每个节点的输入、输出和超时归属。一个节点无法确认下一步时，应返回给编排器做决定，而不是自行再派发新 Agent。这样可以避免循环协作和上下文无限膨胀，也让审计记录保留在统一入口。

节点数量增加前，先确认现有职责确实无法承载。