aiagent/docs/飞书智能体配置手册.md

飞书智能体配置手册

天工智能体平台通过 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