概述


一、完整流程图

用户发送消息
    ↓
1. Channel 接收(飞书/钉钉/网页)
    ↓
2. Gateway 路由(判断发给哪个 Agent)
    ↓
3. Agent 理解(AI 理解意图)
    ↓
4. Skill 匹配(找对应的 Skill)
    ↓
5. 工具执行(调用 API/读写文件等)
    ↓
6. 结果处理(解析返回)
    ↓
7. 回复生成(组织回复内容)
    ↓
8. Channel 发送(回复给用户)

二、每一步详解

步骤 1:Channel 接收

消息从各个渠道进入:

飞书消息 ──→ 飞书 Channel
钉钉消息 ──→ 钉钉 Channel
网页消息 ──→ Web Channel

转换: 把各渠道的格式统一成内部格式


步骤 2:Gateway 路由

Gateway 判断消息应该发给哪个 Agent:

消息分析:
  • 发送者是谁?
  • 发送自哪个渠道?
  • 消息内容是什么?
↓ 路由决策 → Agent A / Agent B / main

步骤 3:Agent 理解

AI 大脑理解消息意图:

原始消息:请帮我分析本月销售数据

AI 理解:

  • 用户想分析数据
  • 关键词:"分析"、"销售数据"
  • 需要调用数据分析能力

步骤 4:Skill 匹配

AI 在 Skills 中搜索匹配项:

Skills 列表:
  • weather → 不匹配
  • calculator → 不匹配
  • sales-analysis → ✅ 匹配!

步骤 5:工具执行

按照 Skill 说明执行操作:

1. 调用销售数据 API
2. 获取本月数据
3. 调用 DeepSeek 分析
4. 生成分析结果

步骤 6:结果处理

解析工具返回的结果:

API 返回:
{"status": "success", "data": [...]}

Skill 说明:

  • 检查 status
  • 提取 data
  • 格式化输出

步骤 7:回复生成

AI 组织回复内容:

原始数据 → 分析结果 → 组织语言 → 自然回复

步骤 8:Channel 发送

通过对应渠道发送回复:

Agent 回复 → Gateway → 飞书 Channel → 用户

三、关键配置文件

{
  "channels": { },     // 渠道配置
  "agents": { },      // Agent 配置
  "routing": { },     // 路由规则
  "skills": { }       // Skill 配置
}

四、响应时间分析

步骤耗时说明
Channel 接收<100ms网络传输
Gateway 路由<50ms内存操作
AI 理解1-3s模型推理
Skill 匹配<100ms文本匹配
工具执行1-10s取决于 API
回复生成1-3s模型推理
总计3-20s

五、异常处理

异常情况处理方式
Channel 接收失败重试 3 次,仍失败返回错误
Agent 处理超时10 秒超时,返回超时提示
Skill 未匹配使用默认回复
工具执行失败返回错误信息,提示用户重试
网络超时重试或降级处理

六、下一步学什么

  • 6.6 安全设置 → 防止 AI 被滥用
  • 6.7 日志与诊断 → 出问题时如何排查

理解流程才能更好地配置和使用 AI!

常见问题

Q: 消息处理流程能自定义吗?
A: 可以通过 Plugin 扩展处理逻辑。