管理运维总览
适用角色:管理员(超级管理员/管理员)
前置条件:已用管理员账号登录,参见快速上手
本页是管理员的总入口。先读「一、开工顺序」确定从哪里下手,再按需进入对应篇目。
一、开工顺序
平台有明确的配置依赖链。顺序错了会导致下游功能不可用或用户看不到。
全新部署:按此顺序走一遍
| # | 步骤 | 篇目 | 为什么必须在这个位置 |
|---|---|---|---|
| 1 | 上传机构 Logo、填机构简称 | 机构设置 | 登录页品牌,纯外观,可最先也可最后 |
| 2 | 接入模型厂商并设默认模型 | 模型厂商接入 | ⚠️ 最关键。没有默认语言模型,所有用户都无法对话 |
| 3 | 调整智能体的提示词与工具权限 | 智能体设置 | 主智能体已内置,开箱可用;按需调整 |
| 4 | 配置动态场景 | 动态场景 | 依赖分组,需先建好分组(步骤 8) |
| 5 | 注册并启用插件 | 插件管理 | 可选 |
| 6 | 接入 MCP 服务 | MCP 配置 | 可选。已内置 Context7、WebSearch 两个 |
| 7 | 登记 Git 仓库并配置凭证 | 集成配置 | 团队协作场景必配 |
| 8 | 建分组、开用户、分配节点 | 用户与权限 | ⚠️ 用户没绑节点就完全用不了 |
| 9 | 授权技能与重要文档 | 资产 | 依赖仓库与分组,需在步骤 7、8 之后 |
| 10 | 注册扩展应用 | 扩展设置 | 可选,用于接入企业既有业务系统 |
已经跑起来的平台:日常巡检
| 频率 | 检查项 | 篇目 |
|---|---|---|
| 每天 | 使用情况概览、节点健康状态 | 运维与日志 · 节点与升级 |
| 每周 | 容器异常退出、新增用户是否已分配节点 | 用户智能体管理 |
| 每月 | 后端与镜像版本滞后情况 | 节点与升级 |
二、权限矩阵
按角色
| 功能 | 超级管理员 | 管理员 | 分组用户 |
|---|---|---|---|
| 工作台、对话、任务、工作空间文件 | ✅ | ✅ | ✅ |
| 账户设置、我的 MCP、我的场景 | ✅ | ✅ | ✅ |
| 扩展应用(使用) | ✅ | ✅ | 按启用状态 |
| 资产(技能、重要文档) | ✅ | ✅ | ❌ |
| 用户管理、分组管理 | ✅ | ✅ | ❌ |
| 用户智能体管理、节点管理 | ✅ | ✅ | ❌ |
| 模型厂商接入、系统配置、数据字典、机构设置 | ✅ | ✅ | ❌ |
| Git 仓库管理、Git 凭证 | ✅ | ✅ | ❌ |
| 插件、MCP、智能体、场景配置 | ✅ | ✅ | ❌ |
| 使用情况概览、系统日志、扩展设置 | ✅ | ✅ | ❌ |
注意 · 内置「超级管理员」与「管理员」两个分组的权限完全相同,均为全权限。差异体现在数据可见范围上:超级管理员归属分组不可修改,用于保留一个不可被误降权的最高权限入口。
分组驱动的资源可见性
系统内的资源授权全部以分组为单位。这是排障时最常踩的坑——「功能找不到」通常不是坏了,是没授权。
| 资源 | 授权方式 | 未授权时的表现 |
|---|---|---|
| Git 仓库 | 指定分组可见;不选任何分组 = 仅管理员可见 | 用户在工作空间看不到该仓库 |
| 技能目录 | 三态:显式授权分组/跟随仓库授权/公开 | 技能不出现在输入区的技能选择器里 |
| 重要文档 | 同上 | 导入时看不到该目录 |
| 动态场景 | 所属分组 | 场景不出现在场景选择器里 |
| 用户智能体等级 | 管理员直接设置 | — |
三、篇目地图
| 篇目 | 内容 | 图数 | 什么时候看 |
|---|---|---|---|
| 模型厂商接入 | 内置/自定义厂商、API 协议、默认模型、可选模型白名单、连接测试 | 9 | 接第一个模型时;换模型时 |
| 能力配置 | 智能体、动态场景、插件管理、MCP 配置 | 22 | 定义 AI 能做什么 |
| 集成配置 | Git 仓库管理、Git 凭证(SSH/HTTP) | 11 | 需要 AI 操作代码仓库时 |
| 基础配置 | 机构设置、系统配置、数据字典 | 12 | 换品牌;调系统参数;做多语言 |
| 用户与权限 | 用户管理、分组管理、节点分配、用户智能体等级、容器管理 | 18 | 开账号、管权限、调资源档位 |
| 节点与升级 | 节点列表、健康检查、镜像加载策略、升级后端与镜像 | 14 | 扩容;升级;排障 |
| 运维与日志 | 使用情况概览、系统日志、扩展设置 | 9 | 看用量、查操作记录、挂子应用 |
四、三条排障主线
出问题时,先判断属于哪一类,再进对应篇目。
| 症状类型 | 典型表现 | 先看 |
|---|---|---|
| 配置类 | 功能找不到、列表为空、下拉里没有 | 本页「权限矩阵」→ 检查分组授权 |
| 运行类 | AI 无响应、容器起不来、节点离线 | 节点与升级 |
| 操作类 | 谁在什么时候做了什么 | 系统日志 |
五、相关页面
| 页面 | 内容 |
|---|---|
| 产品使用说明总览 | 全体用户的入口与功能全景 |
| 安装 · 多节点部署 | 节点如何入网、共享数据库与密钥 |
| 安装 · 升级服务器部署 | 内网/离线环境下的版本分发 |