平台治理、沙箱与全局配置

平台管理(/admin)将租户治理、合规准入、运行安全阀门与全局能力开关按四大分组收口。本文围绕真实后台界面说明核心配置项、生效边界与自动化接口要点。

1. 用户、组织与配额治理

平台管理「账号与组织」分组提供全站用户与组织目录:

2. 认证方式、注册控制与 SSO / OAuth

身份认证策略在部署环境变量(Docker Compose .env 或 Helm api.env)中配置,变更后滚动重启 API 生效:

3. 企业许可证(License)管理

进入「平台管理 › 设置 › 许可证」(/admin/license)可查看当前授权状态、功能开关与实时用量:

4. 请求限流(Rate Limits)

配额限制存量资源数,限流限制单位时间请求频率。进入「平台管理 › 设置 › 限流策略」(/admin/rate-limits):

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. 品牌定制、只读横幅与系统运行参数

下一步