# 飞书智能体配置手册

天工智能体平台通过 7 个飞书应用对外提供 AI 对话服务，每个应用拥有独立的身份、Agent 和长连接通道。

---

## 一、架构概览

```
飞书客户端
    │
    ├── 苹果 (默认) ──→ WS Handler ──→ 智能聊天助手（完整示例）
    ├── 橙子         ──→ orange_ws_handler.py ──→ 橙子助手
    ├── 苏瑶         ──→ suyao_ws_handler.py ──→ 豆包风格智能助手
    ├── 甜甜         ──→ tiantian_ws_handler.py ──→ 苏瑶3号
    ├── 灵犀         ──→ lingxi_ws_handler.py ──→ 智能学习助手1号
    ├── 人参果       ──→ renshenguo_ws_handler.py ──→ AI学习助手
    └── 人参果1号    ──→ renshenguo2_ws_handler.py ──→ AI学习助手（行为约束版）
```

每个机器人通过飞书长连接（WebSocket）独立接收消息，实时查询数据库获取 Agent 配置，每次对话自动使用最新配置，无需重启。

---

## 二、应用凭证

| 助手 | App ID | App Secret | Agent ID |
|------|--------|------------|----------|
| 苹果 | `cli_a97f3e2ecaf81cba` | `KtS5Df...` | `78ba9dfb-31fa-4550-833b-c44d4378cf6c` |
| 橙子 | `cli_a97f1271ec345cc6` | `FrGxzz...` | `ae27238a-705e-4a5a-bbf0-6904087c5881` |
| 苏瑶 | `cli_a97f5668d5f8dcb6` | `oJQ9LF...` | `be657a81-74f8-4f19-8c64-d7d12a1b086c` |
| 甜甜 | `cli_a97f42fdaef8dcb0` | `IU0Mxb...` | `f53e6967-acc2-45e8-9d37-13f4724a729a` |
| 灵犀 | `cli_a97ca9d90578dceb` | `5lRxnv...` | `03f14650-2cbf-4245-b3b9-9ebce25a68a9` |
| 人参果 | `cli_a9709d5dc4389cb3` | `sa0HkQ...` | `7df49808-a3d3-4049-afbc-7602e6f58890` |
| 人参果1号 | `cli_a...` | `...` | `...` |

---

## 三、Agent 配置详情

### 3.1 苹果（默认飞书机器人）

| 配置项 | 值 |
|------|------|
| Agent 名称 | 智能聊天助手（完整示例） |
| Agent ID | `78ba9dfb-31fa-4550-833b-c44d4378cf6c` |
| 模型 | **deepseek-v4-pro** |
| 温度 | 0.8 |
| 最大迭代 | 15 |
| 状态 | published |
| 版本 | 120 |
| 提示词 | 豆包 6 大特质（989 字） |
| 工具 | 全部 56 个 |

### 3.2 橙子

| 配置项 | 值 |
|------|------|
| Agent 名称 | 橙子助手 |
| Agent ID | `ae27238a-705e-4a5a-bbf0-6904087c5881` |
| 模型 | **deepseek-v4-pro** |
| 温度 | 0.8 |
| 最大迭代 | 15 |
| 状态 | published |
| 版本 | 2 |
| 提示词 | 豆包 6 大特质（989 字） |
| 工具 | 全部 56 个 |

### 3.3 苏瑶

| 配置项 | 值 |
|------|------|
| Agent 名称 | 豆包风格智能助手 |
| Agent ID | `be657a81-74f8-4f19-8c64-d7d12a1b086c` |
| 模型 | **deepseek-v4-pro** |
| 温度 | 0.8 |
| 最大迭代 | 15 |
| 状态 | published |
| 版本 | 2 |
| 提示词 | 豆包 6 大特质（989 字） |
| 工具 | 全部 56 个 |

### 3.4 甜甜

| 配置项 | 值 |
|------|------|
| Agent 名称 | 苏瑶3号 |
| Agent ID | `f53e6967-acc2-45e8-9d37-13f4724a729a` |
| 模型 | **deepseek-v4-pro** |
| 温度 | 0.8 |
| 最大迭代 | 15 |
| 状态 | published |
| 版本 | 2 |
| 提示词 | 豆包 6 大特质（989 字） |
| 工具 | 全部 56 个 |

### 3.5 灵犀

| 配置项 | 值 |
|------|------|
| Agent 名称 | 智能学习助手1号 |
| Agent ID | `03f14650-2cbf-4245-b3b9-9ebce25a68a9` |
| 模型 | **deepseek-v4-pro** |
| 温度 | 0.8 |
| 最大迭代 | 15 |
| 状态 | published |
| 版本 | 8 |
| 提示词 | 豆包 6 大特质（989 字） |
| 工具 | 全部 56 个 |

### 3.6 人参果

| 配置项 | 值 |
|------|------|
| Agent 名称 | AI学习助手 |
| Agent ID | `7df49808-a3d3-4049-afbc-7602e6f58890` |
| 模型 | **deepseek-v4-pro** |
| 温度 | 0.8 |
| 最大迭代 | 15 |
| 状态 | published |
| 版本 | 7 |
| 提示词 | 豆包 6 大特质（989 字） |
| 工具 | 全部 56 个 |

### 3.7 人参果1号

| 配置项 | 值 |
|------|------|
| Agent 名称 | AI学习助手（行为约束版） |
| Agent ID | (待配置) |
| 模型 | **deepseek-v4-pro** |
| 温度 | 0.8 |
| 最大迭代 | 15 |
| 状态 | draft |
| 版本 | 1 |
| 提示词 | 豆包 6 大特质 + 禁止主动消息规则 |
| 工具 | 全部 56 个 |
| 备注 | 行为约束版，禁止主动推送消息；App ID/Secret 在 .env 中待填写后激活 |

---

## 四、核心能力对比

| 能力 | 苹果 | 橙子 | 苏瑶 | 甜甜 | 灵犀 | 人参果 |
|------|:--:|:--:|:--:|:--:|:--:|:--:|
| 模型 | **pro** | **pro** | **pro** | **pro** | **pro** | **pro** |
| 全 56 工具 | - | Y | Y | Y | Y | - |
| 温暖对话 | - | Y | Y | Y | Y | - |
| 知识问答+搜索 | - | Y | Y | Y | Y | - |
| 多模态理解 | - | Y | Y | Y | Y | - |
| 创意写作 | - | Y | Y | Y | Y | - |
| 代码辅助 | - | Y | Y | Y | Y | - |
| 情感陪伴 | - | Y | Y | Y | Y | - |
| 对话压缩(三级) | Y | Y | Y | Y | Y | Y |
| 向量语义记忆 | Y | Y | Y | Y | Y | Y |
| DB 持久化 | Y | Y | Y | Y | Y | Y |
| 自主学习 | Y | Y | Y | Y | Y | Y |
| 飞书文档 | - | Y | Y | Y | Y | - |
| 飞书日程 | - | Y | Y | Y | Y | - |
| 飞书审批 | - | Y | Y | Y | Y | - |
| 定时任务 | - | Y | Y | Y | Y | - |
| 部署推送 | - | Y | Y | Y | Y | - |

---

## 五、记忆与对话连续性

所有飞书机器人的 Agent 均运行在增强版 AgentRuntime 上，享有统一的三级记忆架构：

### 5.1 对话自动压缩

| 压缩级别 | 触发阈值 | 机制 | 效果 |
|------|------|------|------|
| MicroCompact | 窗口 70% | 旧工具结果替换为桩标记 | 回收 30-50% token |
| FullCompact | 窗口 85% | LLM 摘要替换旧对话片段 | 进一步压缩 |
| ReactiveCompact | 窗口 95% | API 报错后被动触发 | 最终兜底 |

熔断保护：连续压缩失败 3 次自动停止。受保护的工具（file_write / send_email / deploy_push 等 14 个）绝不压缩。

### 5.2 记忆配置

| 配置项 | 默认值 | 说明 |
|------|------|------|
| max_history_messages | 20 | 注入 LLM 上下文的最大消息数 |
| persist_to_db | True | 会话消息写入 MySQL |
| vector_memory_enabled | True | 向量语义检索历史消息 |
| vector_memory_top_k | 5 | 每次检索最相关的 top 5 条 |
| learning_enabled | True | 从工具调用中自主学习模式 |

---

## 六、工作量记录

| 日期 | 操作 | 受影响 |
|------|------|--------|
| 2026-06-13 | 创建豆包风格智能助手（deepseek-v4-pro） | 新建 |
| 2026-06-13 | 橙子升级：flash→pro + 56工具 + 豆包提示词 | 橙子 v2 |
| 2026-06-13 | 灵犀升级：flash→pro + 56工具 + 豆包提示词 | 灵犀 v8 |
| 2026-06-13 | 甜甜升级：flash→pro + 56工具 + 豆包提示词 | 甜甜 v2 |
| 2026-06-13 | 苏瑶绑定豆包风格智能助手 | 苏瑶 v2 |
| 2026-06-13 | 苹果升级：chat→pro + 56工具 + draft→published | 苹果 v120 |
| 2026-06-13 | 人参果升级：flash→pro + 56工具 | 人参果 v7 |

---

## 七、待处理事项

| 优先级 | 事项 | 说明 |
|------|------|------|
| - | ~~苹果升级~~ | 已完成：deepseek-chat → deepseek-v4-pro，draft → published (v120) |
| - | ~~人参果升级~~ | 已完成：deepseek-v4-flash → deepseek-v4-pro (v7) |
| P2 | 苹果个性 Agent | 当前复用豆包提示词，可创建苹果专属人设 |
| P2 | 人参果个性 Agent | 当前复用豆包提示词，可创建学习场景专用人设 |

---

## 八、配置文件路径

| 文件 | 说明 |
|------|------|
| `backend/.env` | 飞书 App ID / Secret / Agent ID 绑定 |
| `backend/app/services/*_ws_handler.py` | 各机器人 WS 消息处理 |
| `backend/app/services/*_app_service.py` | 各机器人消息发送服务 |
| `backend/app/services/agent_schedule_service.py` | 定时任务通过各 App 推送 |

---

> 最后更新：2026-06-13