3.4.1 系统插件
插件是模型调用外部系统的手:查工单、发消息、搜网页、查监控,都靠插件提供工具。系统插件指平台级注册的插件——由管理员统一接入和维护,插件名全局保留,再按「公开 / 授权」两种方式提供给各团队使用。团队自己导入的插件见 3.4.2 团队插件。
配置入口在管理员侧边栏「插件」菜单,页面分三个页签,对应插件的三种形态。
插件的三种形态
| 形态 | 来源 | 典型用途 |
|---|---|---|
| 静态插件 | 平台原生内置,随版本发布 | 通用原子能力:获取当前时间 / 当前用户、文件转 Markdown、JavaScript 执行器、网页内容抓取等 |
| 动态插件 | 从内置模板一键创建实例 | 需要配置参数的成熟能力:Prometheus / Elasticsearch / ClickHouse 等观测查询、搜索、OCR 等 |
| 自定义插件 | 管理员导入 MCP 服务或 OpenAPI 文档 | 接入任意业务系统 |
静态插件
静态插件是编译在平台里的原生能力,开箱即用,只能查看与编辑、不能删除:

静态插件默认全部「公开」,所有团队的应用都可以直接绑定使用。
动态插件
动态插件基于模板创建:模板定义了插件的参数结构(如 Prometheus 的地址与鉴权),管理员创建实例时填入实际参数,一个模板可以创建多个面向不同环境的实例:

点击「模板列表」可查看平台内置的全部模板;「新建实例」选择模板、填写实例 Key 与配置参数即可。实例创建后同样通过公开或授权提供给团队。
自定义插件
管理员在平台级导入 MCP 服务与 OpenAPI 文档,操作方式与团队侧一致(见 3.4.2 团队插件的导入说明),只是登记在平台层级:

公开与授权团队
系统插件有两种提供给团队的方式:
- 公开:所有团队可用,无需授权(列表「公开」列的标签一眼可辨);
- 私有:默认没有任何团队可用,通过行操作「授权团队」指定可见团队,随时可移除授权。
推荐策略:静态、向量检索类基础能力保持公开;对接了真实业务系统、含凭证配置的插件保持私有并按团队授权,缩小暴露面。
案例:把高德地图做成全平台可用的地图插件
以环境中的实际例子说明「导入 → 授权 → 团队使用」的完整链路:
- 管理员导入:在「插件 → 自定义插件」导入 MCP,服务地址填
https://mcp.amap.com/...,插件名gmap、标题「高德地图」,密钥用{key}形式引用团队变量占位; - 保持私有并授权:gmap 设为私有,点「授权团队」勾选需要的团队;
- 团队侧可见:被授权团队在团队空间的「插件」页看到该插件,「系统」列标记为「是」,团队成员把它绑定到出行类 Agent 上即可查询地图信息;
- 统一维护:高德侧密钥轮换时,管理员改一处插件配置(或各团队的环境变量),所有团队的应用同步生效——这就是系统插件相对各团队重复导入的核心价值。
常见问题
系统插件和团队插件重名了怎么办?
系统插件名全局保留,团队侧导入同名插件会被拒绝;反之团队已占用的名字,管理员导入系统插件时同样冲突,先改名再导入。
移除团队授权会影响什么?
该团队立即无法使用此插件,已绑定它的应用在调用时会失败;授权随时可以重新添加,团队侧配置不受影响。
动态插件实例的配置填错了,团队会感知吗?
会。实例配置在运行时生效,填错会导致调用失败;创建或编辑后建议先用应用对话实测一次工具调用。