🤖 Agent 与密钥管理(管理员)
🎯 本页是管理员看的:飞书 / 企微 webhook、机器人密钥台账、AI 服务商 key。
⚠️ 侧边栏结构(2026-08-15 起)
原来侧边栏有「Agent 管理」分组,现已取消:
- 🪝 Webhook 管理 → 挂在「系统管理」分组下
- 🔑 Agent 密钥管理 → 挂在「系统管理」分组下
- 同组的还有:角色管理 / 公告管理 / 模块健康
一、🪝 Webhook 管理 /settings
侧边栏位置:「系统管理」分组
飞书 / 企微群机器人 webhook 配置:出图结果、需求进度卡片等推送的目标群。
二、🔑 Agent 密钥管理 /robot-keys
侧边栏位置:「系统管理」分组
采集机器人密钥台账(一个机器人 = 一个项目):
| 字段 | 是什么 |
|---|---|
| 📛 名称 | 机器人 / 项目名 |
| 👤 负责人 | 找得到的人 |
| 🟢 状态 | 启用 / 停用 |
| 📂 Git 地址 | 代码仓库 |
| 🧪 连通性测试 | 一键 ping |
💡 需求池「所属应用」从哪来
从机器人列表派生。要新加一个机器人项目,先在这页登记,再去需求池提需求。
三、🔐 API Key 管理 /api-keys
各 AI 服务商 key 统一管理:
字段
- 🏷️ 服务商:DeepSeek / Token4AI / OpenAI / 需求审核中转 / 其他
- 📛 名称
- 🔐 key
- 👤 负责人
- 🤖 可用模型
- 💰 成本分类
- 💵 余额查询地址
- 🔗 充值链接
余额监控
- 📊 手动「刷新余额」或后台每小时自动巡检
- ⚠️ 低于阈值发飞书告警(24h 去重,不会被刷屏)
异常处理
| 现象 | 显示 |
|---|---|
| key 失效(被吊销 / 重置) | 余额统一显示 CNY: 0.00(key 失效) |
| 「需求审核中转」显示 | 「中转(不限额)」 |
需求质检的 key 取用顺序
text
需求审核中转(yuki-relay) ← 优先
↓ 不行
DeepSeek 官方 ← 兜底
↓ 不行
失效 / 欠费自动换下一把🔐 安全边界
- 密钥字段不可经通用接口修改(防篡改)
- 列表视图屏蔽 key 明文
