插件资源

插件把外部服务、平台托管代码、MCP Server 或端侧函数封装成标准工具，供低代码智能体、工作流和应用复用。一个插件可以包含多个工具；模型实际选择和调用的是插件中的具体工具。

先分清：当前有四种插件形态

当前“新建插件”界面先显示三个运行类型：云侧插件、端插件、MCP 插件。其中云侧插件还必须选择“基于已有服务创建”或“在 Cloud IDE 中创建”，因此按创建、维护和运行方式应拆成四种插件形态：

四种插件形态	页面选择	工具在哪里执行	工具如何产生	详细说明
云侧 API 插件	云侧插件 > 基于已有服务创建	已有 HTTP/HTTPS 服务	手工创建、导入接口定义或代码注册	云侧 API 插件
Cloud IDE 插件	云侧插件 > 在 Cloud IDE 中创建	AIOS 托管运行环境	在 IDE 中编写代码和工具元数据	Cloud IDE 插件
MCP 插件	MCP 插件	MCP Server	从 MCP Server 同步工具清单	MCP 插件
端插件	端插件	用户设备、本地软件或专用终端	平台声明函数契约，端侧实现执行逻辑	端插件

图 1：当前新建插件界面。类型区域显示三个运行类型；选择“云侧插件”后，再从两种工具创建方式中选择一种，最终形成四种插件形态。

不要把其他分类当成插件类型

• 手工创建、导入 OpenAPI/Swagger/Postman、使用代码注册是云侧 API 插件的不同录入方式，不是三种新插件。
• 官方插件、企业插件、工作空间自建插件描述来源和分发范围，不改变工具的运行方式。
• 图像、音视频、办公、搜索等描述能力领域，不改变插件类型。
• Service Token、OAuth、OIDC描述鉴权方式，也不是插件类型。

历史文档如何映射到当前结构

历史文档按功能不断追加页面，内容完整但分类轴较多。当前栏目保留其中仍适用的核心规则，并按四种插件形态重新归档：

历史文档内容	当前归属	处理方式
基于 API 创建、JSON/YAML 导入、代码注册、私网或流式服务	云侧 API 插件	创建入口统一归入云侧 API；仅说明当前界面已经开放的配置
使用 IDE 创建插件	Cloud IDE 插件	保留运行时、工具、依赖、代码、元数据、测试和发布流程
基于 MCP 服务创建插件	MCP 插件	保留服务连接、鉴权、工具同步、试运行和发布流程
端插件概述、创建端插件、通过 API 使用端插件	端插件	保留端侧执行边界和函数契约；历史接口地址不直接沿用
图像、音视频、工具类官方插件	插件市场或具体插件说明	不作为资源库插件类型目录

本栏目导航

四种插件

• 四种插件与创建方式总览
• 云侧 API 插件
  • 导入接口定义或使用代码注册
• Cloud IDE 插件
• MCP 插件
• 端插件

开发、使用与治理

• 配置服务鉴权与用户授权
• 配置工具并完成试运行
• 在智能体和工作流中使用插件
• 发布、版本与插件治理
• 插件常见问题

入口与资源边界

• 页面入口：资源 > 低代码，在低代码资源库中切换到“插件”。
• 页面地址：/workbench/resource-library?type=plugin。
• 资源归属：插件属于当前工作空间；切换空间后，可查看和引用的插件会发生变化。
• 发现与安装：插件市场用于发现能力；低代码资源库用于维护当前工作空间已经创建、导入或安装的插件实例。
• 企业分发：企业插件位于开放生态入口，不等同于当前工作空间内的插件实例。

资源库列表支持搜索、创建者和状态筛选，并提供创建、导入、查看详情及资源操作。进入插件详情后，再维护用户授权、工具、调试状态、发布版本和历史记录。

插件、工具与调用方

一个插件可以包含多个共享运行位置和鉴权策略的工具。例如，“创建任务”“查询任务”“取消任务”可以属于同一个插件。工具名称、说明、输入输出参数决定模型能否正确选择并调用它。

对象	负责内容	典型维护入口
插件	名称、说明、类型、服务连接、服务鉴权、用户授权和版本	插件详情、编辑配置、用户授权、发布与历史
工具	请求或函数契约、参数、响应、试运行、卡片绑定和启用状态	工具列表、工具详情、试运行
调用方	选择插件工具、映射变量、处理结果与异常	智能体编排、工作流插件节点

图 2：插件详情和工具列表。不同插件形态共用基本信息、发布和历史能力，但工具的创建、编辑和试运行方式不同。

四种插件的维护差异

维护动作	云侧 API	Cloud IDE	MCP	端插件
连接配置	URL、Header、服务鉴权	运行时和依赖	MCP 地址、Header、服务鉴权	客户端、设备和权限
工具定义	在平台创建或导入	在 IDE 维护代码与元数据	从 MCP Server 同步	平台函数契约与端侧实现共同维护
真实试运行	平台请求 HTTP 服务	托管运行时执行代码	平台调用 MCP 工具	端侧真实执行后在平台确认结果
主要风险	接口与 Schema 漂移	代码、依赖和运行时异常	服务连接和同步差异	客户端版本、设备离线和权限拒绝

当前“私网连接”下拉框只提供“不使用私网连接”。历史文档中的私网专线、固定 IP 等内容不作为本版本已开放能力；以后页面出现可选连接后再补充对应流程。

推荐生命周期

1. 确定插件形态：判断能力运行在已有服务、Cloud IDE、MCP Server 还是用户设备。
2. 创建插件：填写名称、一句话介绍、描述和头像，并选择对应类型与创建方式。
3. 配置运行条件：维护 URL、运行时、MCP 连接或端侧客户端条件。
4. 创建或同步工具：为工具维护清晰、稳定的输入输出契约。
5. 完成真实试运行：覆盖成功、非法输入、鉴权失败、空结果和上游异常。
6. 在真实调用方验证：从智能体或工作流选择已发布工具，检查选工具、传参和结果消费。
7. 发布稳定版本：填写版本说明，确认工具启用状态和引用影响。
8. 持续治理：查看历史、轮换凭据，并按兼容策略升级工具契约。

使用前检查

• 插件和计划使用的工具都已发布且启用。
• 服务鉴权与用户授权没有混用，凭据未出现在描述、示例或日志中。
• 工具的输入输出契约与真实执行结果一致，关键工具已经完成真实试运行。
• 智能体和工作流使用的是当前发布版本，变量映射没有引用已删除字段。
• 写入、删除、付款、发送消息等高风险工具在调用层具备确认、权限或审批机制。