AI Agent Architecture（AI 智能体架构）

知识库位置：FDE Knowledge Base/04 Architecture/Patterns/02-AI-Agent-Architecture.md v0.1 基础版（Phase 1 #10）于 v0.2 升级为参考架构模式。

Architecture Metadata（架构元数据）

Architecture ID: ARCH-002

Category（类别）:
Action（行动执行）

Primary Business Problem（主要业务问题）:
Dynamic Task Execution（动态任务执行）

Complexity（复杂度）:
High（高）

AI Dependency（AI 依赖度）:
High（高）

Data Dependency（数据依赖度）:
Medium（中）

Integration Complexity（集成复杂度）:
High（高）

Human Review（人工复核）:
Required for write actions（写操作必须人工确认）

Status: Core
Version: v0.2

Business Problem（业务问题）

用户不仅希望 AI 回答问题，还希望它能够：

• 查询系统
• 调用工具
• 执行业务动作
• 根据结果继续判断下一步

---

When to Use（适用场景）

适合：

• 多工具任务
• 动态执行路径
• 信息收集与行动结合
• 非完全固定的业务流程
• Research / Investigation（调研 / 排查）
• Operations Assistant（运营助理）

---

When NOT to Use（不适用场景）

不适合：

• A → B → C 完全固定流程
• 高风险、强确定性操作
• 简单 API Wrapper（接口封装）
• 传统 Workflow（工作流）就能稳定解决的场景

---

Core Principle（核心原则）

Deterministic where possible（能确定则确定）
Agentic where necessary（必要时才智能体化）

---

High-Level Architecture（总体架构）

                 User（用户）
                  │
                  ↓
              Application（应用）
                  │
                  ↓
             Agent Runtime（智能体运行时）
          ┌───────┼────────┐
          │       │        │
          ↓       ↓        ↓
       Context  Planner  Memory
      （上下文）（规划器）（记忆）
                  │
                  ↓
            Tool Selection（工具选择）
                  │
                  ↓
              Policy Layer（策略层）
                  │
                  ↓
         Parameter Validation（参数校验）
                  │
          ┌───────┴────────┐
          ↓                ↓
      Read Tools        Write Tools
     （只读工具）       （写入工具）
          │                │
          └───────┬────────┘
                  ↓
           Tool Execution（工具执行）
                  ↓
              Observation（观测结果）
                  ↓
                Agent（智能体决策）
                  ↓
              Response（响应）

---

Components（组件）

Agent Runtime（智能体运行时）

负责：

• State（状态）
• Loop（循环）
• Step Control（步数控制）
• Termination（终止条件）

Planner（规划器）

决定：

下一步应该做什么？

Tool Registry（工具注册表）

定义：

• Tool（工具）
• Description（描述）
• Parameters（参数）
• Permissions（权限）

Policy Layer（策略层）

决定：

• 是否允许调用
• 是否需要审批
• 是否越权

Memory（记忆）

根据需求可以包括：

• Conversation Memory（会话记忆）
• Task State（任务状态）
• User Preferences（用户偏好）
• Short-term Working State（短期工作状态）

---

Security（安全）

Agent（智能体）最大风险是：

模型拥有了行动能力。

因此必须控制：

User Permission（用户权限）
≥
Agent Effective Permission（智能体实际权限）

推荐：

Agent（智能体）
↓
Policy Check（策略检查）
↓
User-scoped Permission（用户级权限）
↓
Execution（执行）

高风险动作：

Delete（删除）
Transfer（转账）
Refund（退款）
Approve（审批）
Send External Message（发送外部消息）

应加入 Human Confirmation（人工确认）或独立审批流程。

---

Reliability（可靠性）

需要：

• Max Steps（最大步数限制）
• Duplicate Action Detection（重复动作检测）
• Timeout（超时）
• Tool Error Classification（工具错误分类）
• Retry Limit（重试上限）
• Human Escalation（转人工升级）

---

Failure Modes（失败模式）

• Wrong Tool（选错工具）
• Wrong Parameters（参数错误）
• Loop（循环）
• Hallucinated Tool（幻觉工具：调用了不存在的工具）
• Over-permission（越权）
• Missing Termination（缺少终止条件）
• Invalid State（状态无效）
• Dependency Failure（依赖故障）

---

Scaling（扩展）

Agent 规模扩大后，不要直接做：

One Agent（单一智能体）
+
100 Tools（100 个工具）

更合理：

Domain Router（领域路由器）
├─ Finance Agent / Tools（财务智能体 / 工具）
├─ Support Agent / Tools（客服智能体 / 工具）
└─ Sales Agent / Tools（销售智能体 / 工具）

或保持单 Agent，但按 Context（上下文）限制可见工具。

---

Implementation Path（实施路径）

Stage 1
Single Agent + 2-3 Read-only Tools
（单智能体 + 2-3 个只读工具）

Stage 2
Structured Tool Calls
（结构化工具调用）

Stage 3
Policy Layer
（策略层）

Stage 4
Write Tools + Human Approval
（写入工具 + 人工审批）

Stage 5
Observability + Evaluation
（可观测性 + 评估）

Stage 6
Multi-domain Routing
（多领域路由）

---

Related Knowledge（关联知识）

• Tool Calling（工具调用）
• Agent Fundamentals（智能体基础）
• Agent Tool Design Checklist（智能体工具设计检查清单）
• Agent Chooses the Wrong Tool（Agent 选错工具）
• Agent Loops Repeatedly（Agent 反复循环）
• CS-002 AI Customer Support Agent（AI 客服智能体）