2.8 系统管理
平台运行级别的"系统设置":监控指标、AI 长期记忆运维、品牌定制。
进入路径:左侧主导航 → 管理后台 → 系统管理。 路径:/admin/system权限:仅 super_admin
2.8.1 页面 Tab 结构
整页 Tab 切换(共 4 个):
| Tab | 图标 | 用途 |
|---|---|---|
| 监控中心 | BarChart3 | 实时性能指标、健康状态、组件依赖 |
| AI 记忆 | Brain | 管理 AI 的长期记忆库、索引重建 |
| 品牌与登录 | Palette | Logo / 平台名 / 主题色 / 登录页 自定义 |
| AI 助手 | Sparkles | 配置各编辑器「AI 优化 / 生成」的共享驱动模型 |
⚠️ 各 Tab 内容由独立组件渲染(
MonitoringPanel/MemoryManagementPanel/BrandingPanel/AiAssistPanel),具体功能可能随版本变化。本章描述的是常见能力。
2.8.2 监控中心 Tab
典型展示内容:
系统健康指示
| 组件 | 检查项 |
|---|---|
| PostgreSQL | 连接 + 查询延迟 + 连接池占用 |
| Redis | 连接 + 内存占用 + 命中率 |
| LightRAG | 索引服务可达性 |
| MCP 服务 | 已注册的 MCP server 健康汇总 |
| 外部 LLM | 各模型最近一次成功调用时间 |
| Sandrpod | 在线沙箱数 + 心跳异常数 |
每个组件显示:🟢 / 🟡 / 🔴 + 详情。
性能图表
可能展示:
- 实时请求 QPS
- 平均响应时间(P50 / P95 / P99)
- 错误率
- 流式连接数
- 队列长度(Celery / 后台任务)
系统信息
| 字段 | 说明 |
|---|---|
| 后端版本 | git commit hash |
| 前端版本 | build hash |
| Python / Node 版本 | |
| 部署模式 | dev / production / saas |
| 启动时间 | 上次重启时间 |
💡 这里看到的是前端可见的简化指标。深度监控建议接入 Grafana / SigNoz(运维侧)。
2.8.3 AI 记忆 Tab
管理 AI 的长期记忆层(LangGraph MemorySaver、知识库索引、嵌入向量)。
典型功能
短期记忆(LangGraph Checkpoints)
- 当前活跃 thread 数
- 平均 thread 体积
- TTL 配置:默认 7 天
- 「清理过期」按钮
长期记忆(用户偏好 / 跨会话上下文)
- 记忆条目数(按用户 / 按 Agent)
- 「按用户搜索」可查/删某用户的所有记忆
- 「按 Agent 搜索」同上
向量索引
- 各知识库的向量数量
- 索引大小(GB)
- 「重建索引」按钮(批量,长任务)
危险操作
🚫 清理与重建都是不可恢复操作。重建过程中相关知识库不可用。
- 清理过期 checkpoints:相对安全,只删超过 TTL 的
- 清理某用户记忆:不可恢复
- 重建知识库索引:不丢数据但耗时
2.8.4 品牌与登录 Tab
定制平台对最终用户的视觉呈现。仅 ENTERPRISE 版授权可用(普通版按钮为禁用 + 升级提示)。
字段
| 字段 | 类型 | 说明 |
|---|---|---|
| 平台 Logo | 文件上传 | PNG/SVG,推荐 256×256,自动适配深浅模式 |
| 产品中文名 | text | 默认「Foresee Sira AI」 |
| 产品英文名 | text | 默认「Foresee Sira AI」 |
| 主题主色 | color picker | 默认 Sira 蓝(#xxx) |
| 登录页背景图 | 文件上传 | 全屏背景,推荐 1920×1080 |
| 邮件签名 | rich text | 系统邮件落款 |
| 联系信息 | textarea | 显示在登录页底部 |
| 自定义 favicon | 文件上传 | 浏览器 Tab 图标 |
应用范围
- 影响所有最终用户可见页面:登录、首页、应用对话页
- 不影响管理后台(始终保留 Sira 原标识,确保多租户运维不混淆)
- 影响发出去的系统邮件(欢迎邮件、密码重置邮件等)
预览
调整后右侧实时预览(登录卡片样式)。
保存生效
| 范围 | 生效时机 |
|---|---|
| Logo / 文字 / 颜色 | 立即,刷新所有页面生效 |
| 自定义 favicon | 浏览器缓存可能延迟,需 Ctrl+F5 |
| 邮件签名 | 下次发邮件生效 |
重置
「重置为默认品牌」按钮 — 恢复 Foresee Sira 原标识。需二次确认。
🔒 License 校验:每次保存品牌设置时,后端校验 ENTERPRISE 授权是否有效。授权过期后,品牌自动回退到默认。
2.8.5 AI 助手 Tab
配置平台自有 AI(编辑辅助)的共享驱动模型 — 即各编辑器(智能体 / 编排器 / 技能包等)里「AI 优化 / 生成」按钮背后调用的模型。用于把大白话转成规范提示词、生成标准 Skill 等。
组件:AiAssistPanel。配置落到 organizations.settings.ai_assist(per-org 隔离),读写 /api/ai-assist/config。
字段
| 字段 | 说明 |
|---|---|
| 启用 AI 助手 | 开关。关闭后各编辑器的 AI 优化 / 生成按钮不可用 |
| 驱动模型 | 下拉选一个已启用的 LLM 模型;留空(「使用组织默认模型」)时由后端兜底到组织默认模型 |
| 测试 | 用当前配置跑一次示例优化,验证所选模型是否可用并预览输出 |
💡 模型下拉为空时提示先去「AI 模型」页面添加并启用一个模型。
effective_model_id反映实际生效模型 — 未显式选模型且未设组织默认模型时,需手动选一个具体模型。
2.8.6 常见问题
Q1:监控中心数据多久刷新一次?
默认每 30 秒自动刷新。也可点右上角「刷新」按钮立刻拉取。
Q2:某个组件显示 🔴 红色,但平台业务正常?
可能性:
- 健康检查接口本身有 bug(看后端日志)
- 网络抖动导致心跳超时,实际服务正常
- 检查阈值过严(如 Redis 命中率 95% 也算健康)
确认后请联系运维调阈值,而不是无视红灯。
Q3:重建索引会持续多久?
按知识库大小:
- 100MB 内:几分钟
- 1GB:30 分钟到 1 小时
- 10GB+:数小时
期间该知识库的检索会失败 — 建议在低峰期操作,或先暂停依赖该知识库的应用。
Q4:品牌设置后某些页面没换 Logo?
可能性:
- 浏览器缓存了旧 Logo → Ctrl+F5 强制刷新
- CDN 缓存(如部署用了 CDN)→ 联系运维清理 CDN 缓存
- 该页面在前端 hardcode 了 Sira Logo(罕见 bug,提报修复)
Q5:我没有 ENTERPRISE 版,品牌设置完全不可用?
可以查看 Tab,但所有字段 disabled,顶部显示授权升级提示。如果你需要试用,联系销售申请短期 ENTERPRISE 试用授权(申请流程见 许可证管理)。
Q6:有没有 Webhook / SMS / 钉钉 告警可以配置?
UI 不支持。需要走运维侧:
- backend hook 机制
- 接 Prometheus + AlertManager
- 接 Grafana 告警
详见运维文档(由部署方提供)。
Q7:监控中心能看到具体某个智能体 / 应用的指标吗?
不能。这里是平台级指标。要看具体应用 / 模型 / 用户指标,去 用量统计。
Q8:长期记忆能跨用户共享吗?
默认按 (user_id, agent_id) 隔离,不共享。如果业务需要"组织级共享记忆",需要在 Agent 设计时使用 Collaboration / Supervisor 编排器并开启 shared_memory,具体见 编排器配置。