229 lines
7.5 KiB
Markdown
229 lines
7.5 KiB
Markdown
# 飞书智能体配置手册
|
||
|
||
天工智能体平台通过 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
|