3.4.2 团队插件
团队插件由团队自行接入和维护，让本团队的应用能调用外部系统：MCP 服务、OpenAPI 接口都能导入成插件，平台的动态插件模板也可以一键创建团队自有实例。凭证类参数支持 {变量} 占位符引用团队环境变量，敏感信息不写死在插件定义里。
入口在团队空间的「插件」菜单（需要团队管理员及以上角色）：
列表中「系统」列标记为「是」的行来自系统插件授权，团队无需也无法编辑它们；其余为团队自有插件。页面分「自定义插件」「动态插件」两个页签。
导入 MCP 插件
点击「导入 MCP」：
| 字段 | 说明 |
|---|---|
| 插件名称 | 供 AI 识别调用的标识，仅支持字母和下划线，导入后是工具名的前缀 |
| 插件标题 | 系统里的显示名，给人看的 |
| MCP 服务地址 | MCP 服务的 URL（Streamable HTTP） |
| 分类 / 描述 | 归类与用途说明，帮助模型和使用者理解插件 |
| 通讯方式 | 可选，服务的传输协议：自动检测 / 仅 Streamable HTTP / 仅 HTTP with SSE，拿不准就保持自动检测 |
| 添加 Header / Query | 自定义请求头与查询参数，值支持 {变量名} 引用团队环境变量 |
操作示范（接入一个需要鉴权的 MCP 服务）：
- 在团队「环境变量」页先建好变量（如
erp_token= 真实令牌）； - 点「导入 MCP」，插件名称填
erp，服务地址填 MCP 端点； - 点「添加 Header」，Key 填
Authorization，Value 填Bearer {erp_token}； - 确定导入，列表出现新插件；点行上的「查看函数」核对拉取到的工具清单；
- 上游服务更新了工具后，点「刷新函数」重新同步。
导入 OpenAPI 插件
点击「导入 OpenAPI」，把一份 OpenAPI 文档变成一组工具：
- OpenAPI 文件：支持 JSON / YAML 格式，文档里每个操作会成为一个函数；
- 服务器地址：接口的 BaseAddress，通常与文档中的 servers 一致；
- Header / Query：同样支持
{变量名}插值，适合放 API Key、租户 ID 等参数；保存后可在编辑弹窗中回显核对。
动态插件实例
「动态插件」页签展示平台模板创建的实例：系统授权的实例标记「系统」，团队自己创建的标记「团队自有」：
点「模板列表」查看平台提供的模板（如 Prometheus / Elasticsearch / ClickHouse 查询、搜索、OCR 等），「新建实例」选择模板、填实例 Key 与本团队的配置参数即可。适合团队想用平台已成熟能力、但需要自己的环境参数（自己的监控地址、自己的 Key）的场景。
插件在应用中使用
导入的插件不会自动生效，需要在应用里绑定：
- Agent 应用在工作台勾选插件，模型按用户意图自主调用工具；
- 流程应用在节点中选择插件工具，按编排确定性调用。
配置方法见 3.8 Agent 应用 与 3.9 流程应用。
案例：把内部 ERP 接进客服 Agent
客服团队要让 AI 能查订单，而 ERP 团队已经提供了 MCP 服务端点。三步接通：
- 放凭证：团队管理员在「环境变量」页添加
erp_token，值是 ERP 发的访问令牌； - 导插件：「导入 MCP」填 ERP 的服务地址，Header 加
Authorization: Bearer {erp_token}——插件定义里只有占位符，令牌本体存在环境变量里，改令牌时只改变量、不动插件； - 绑应用：在客服 Agent 的工作台勾选
erp插件。上线后用户问「订单 2001 到哪了」，模型自动调用 ERP 的查询工具并组织回答。
常见问题
导入后应用里看不到插件函数？
先点「查看函数」确认清单非空：MCP 服务地址不可达或鉴权失败会导致函数拉取为空，修正服务地址或 Header 后「刷新函数」。
{erp_token} 没有被替换、原样发出去了？
团队环境变量里没有同名变量，未匹配的占位符会原样保留；到「环境变量」页补建变量即可。
插件名称有什么限制？
仅字母和下划线，且不能与系统插件或其他已有插件重名——插件名会进入模型的工具命名空间，全局唯一。
删除插件会影响应用吗？
已绑定该插件的应用在调用时会失败。删除前建议先在应用侧解绑。