1. 用户、组织与配额治理
平台管理「账号与组织」分组提供全站用户与组织目录:
- 用户管理(
/admin/users):查看账号状态、全局角色(admin/rw/ro)与所属组织,按用户 ID 定位账号以排查限流或审计记录。 - 组织管理与配额(
/admin/organizations):ApeMind 的资源配额严格按组织维度核算(不按单用户核算)。站点管理员可为单个组织设置以下上限(留空表示不限制):配额键 限制范围 调整说明 max_collection_count组织知识库总数 通过 /admin/organizations/{org_id}或PUT /api/v2/admin/organizations/{org_id}/quotas/{key}调整;调低至当前用量以下不会删除已有资源,但会阻止新建。若计数出现偏差,可执行重新核算(POST .../recalculate)。max_document_count组织全部知识库的文档总数 max_document_count_per_collection单个知识库的文档数上限 max_bot_count组织 Agent 数量上限 - 自助建组织策略(
/admin/configuration):可控制普通登录用户是否允许自助创建组织,并设定每人可创建的组织上限(范围1–20)。企业内网环境建议关闭自助创建,由站点管理员统一审批建组。
2. 认证方式、注册控制与 SSO / OAuth
身份认证策略在部署环境变量(Docker Compose .env 或 Helm api.env)中配置,变更后滚动重启 API 生效:
- 认证提供方(
AUTH_TYPE):默认cookie(内置邮箱/用户名与密码会话);企业接入统一身份认证时可切换为auth0、authing或logto(配置LOGTO_DOMAIN、LOGTO_APP_ID等对应凭据)。 - 第三方 OAuth 登录:配置
GOOGLE_OAUTH_CLIENT_ID/SECRET、GITHUB_OAUTH_CLIENT_ID/SECRET及OAUTH_REDIRECT_URL即可在登录页启用一键登录。 - 注册准入(
REGISTER_MODE):默认unlimited开放注册;私有化或内网环境建议设为邀请制或关闭自助注册,配合 SSO 自动落户。
3. 企业许可证(License)管理
进入「平台管理 › 设置 › 许可证」(/admin/license)可查看当前授权状态、功能开关与实时用量:
- 授权功能与限额:许可证控制企业级模块开关(如知识图谱
feature.graph_index、知识市场feature.marketplace、Agent 编排feature.agent_authoring等)与平台级上限(用户数limit.users、组织数limit.organizations、知识库数limit.knowledge_bases、每日提问次数limit.questions_per_day等)。 - 申请与导入:在页面导出当前部署的环境绑定文件(Environment Binding JSON)发给商务/支持团队签发正式 License,随后上传或粘贴 License 令牌即可热更新,无需重启服务。
- 到期与异常保护:当许可证状态进入
expired、missing、invalid、clock_tampered或binding_mismatch时,平台自动进入受限只读保护,阻止新建与写入操作(但管理员仍可进入/admin/license导入新证解除锁定)。
4. 请求限流(Rate Limits)
配额限制存量资源数,限流限制单位时间请求频率。进入「平台管理 › 设置 › 限流策略」(/admin/rate-limits):
- 系统默认与单用户覆盖:可按限流槽位(如
api.chat_turn、文档上传、检索等)统一调整全局默认速率,也可针对特定集成账号或高并发测试用户单独放宽或收紧。 - 并发版本保护:通过接口批量更新(
PUT /api/v2/rate-limits/defaults或/users/{user_id})时采用乐观锁版本校验;若其他管理员同时修改过策略会返回409 REVISION_CONFLICT,需重新读取最新策略再提交,切勿盲目覆盖。 - 匿名公开访问限流:公开链接与网站嵌入按客户端 IP 独立限流(默认每分钟 60 次),反向代理场景务必正确配置
FORWARDED_ALLOW_IPS。
5. 智能体代码沙箱与运行阀门
当组织开启 Agent「代码模式」后,Agent 可在受控沙箱内执行 Python/Shell 脚本、读写临时工作区与按策略访问外部网络。进入「平台管理 › 能力 › 智能体工作区」(/admin/agent-workspace)统一查看节点健康状态(页面每 15 秒自动刷新,切后台暂停轮询)并调节 6 项核心安全阀门:
| 阀门键 | 单位 | 治理作用 |
|---|---|---|
command_memory_mib |
MiB | 单条沙箱命令的最高内存上限,防止大表格或死循环撑爆宿主机内存 |
command_timeout_seconds |
秒 | 单条命令硬超时,超时自动终止进程并释放工作槽位 |
node_concurrency |
并发数 | 单个运行节点同时执行的沙箱命令上限,用于保护宿主机 CPU 与 I/O |
org_concurrency |
并发数 | 单个组织同时执行的沙箱命令上限,防止单一租户打满全站算力 |
egress_max_connections_per_command |
连接数 | 单条命令允许建立的最大出网连接数,防止恶意扫描或连接洪泛 |
egress_max_mib_per_command |
MiB | 单条命令累计出网/下载流量上限,避免大文件拉取耗尽带宽与磁盘 |
6. 平台能力、解析/检索与 IM 全局开关
平台管理「能力」分组中的全局策略对所有组织生效,组织管理员可在平台允许的边界内再做收紧:
| 后台路径 | 管理内容 | 关键注意事项 |
|---|---|---|
/admin/im-channels |
IM 渠道(飞书、钉钉、企微、Slack、Telegram)平台总开关 | 平台总开关开启后,各组织仍可自行关闭本组织的 IM 接入;平台关闭则全局生效。 |
/admin/parser-config |
文档解析集成(如 MinerU、DocRay、MarkItDown)与按格式路由 | 修改凭据后必须先点「验证」再切换路由,并用一份测试文档走完上传与索引确认。密钥保存后不回显明文。 |
/admin/web-search-config |
联网搜索与网页读取供应商(Tavily、Brave、Jina 等)及路由 | 验证连通性后才会被开启了联网能力的 Agent 或 MCP 工具调用;默认关闭。 |
/admin/prompts |
系统默认提示词(图谱抽取、知识库摘要、平台内核等) | 保存前先执行模板语法校验。对话提示词仅影响后续新 Turn;图谱/摘要提示词仅影响新触发的索引任务,存量文档需重建对应索引生效。 |
/admin/agent-templates |
平台内置 Agent 模板 | 发布后供各组织在新建 Agent 或声明式配置(metadata.created_from.template)中复用。 |
7. 品牌定制、只读横幅与系统运行参数
- 品牌定制(
/admin/branding):自定义站点标题、副标题、登录页标题与简介、页脚版权文案、支持链接(support_url)以及自定义 Logo/图标,满足私有化白标交付需求。 - 只读横幅(
/admin/configuration):可一键开启全站只读提示横幅并自定义公告文案,在升级维护窗口、权限受限或面向只读角色(ro)用户时清晰提示当前状态。 - 系统运行参数(
/admin/configuration):集中管理文档解析并发、分块默认尺寸(chunk_size/chunk_overlap_size)、图谱抽取窗口与容错比例、向量批处理并发、检索阈值、长对话缓存与历史轮次保留等运行时参数。变更时建议只修改确认过的字段并记录变更前原值,便于出现波动时快速回退。