插件管理
一、功能说明
插件就像是给智能体"加装备"。它能让智能体拥有更多能力，比如看图识物、查地图、做搜索、生成文件或图表等。
智能体通过意图识别来决定什么时候调用插件。
举例：
你问"帮我看看这张图片"，系统就会触发图像识别插件。
你问"从北京到上海怎么走"，系统就会触发高德地图插件。
你问"帮我算下还有多少天过年"，系统会触发日期天数计算插件。
除了自动识别意图，也可以设置关键词触发，比如你设置"地图"这个词，带有"地图"的问题都会触发对应插件。
在插件中心
平台内置插件（开箱即用）
自定义插件（MCP插件、HTTP插件）
提示：如需扩展更多业务场景，可通过「自定义插件」对接自有系统或第三方服务。
二、内置插件
以下是平台内置的常用插件，开箱即用：
| 插件名称 | 作用说明 | 触发条件示例 |
|---|---|---|
| 图像识别 | 上传图片后，系统帮你识别图片里的内容，并回答相关问题。 | "这张图上是什么？"→自动触发 |
| 高德地图 | 提供位置、路线查询，支持规划出行路径。 | "从北京到上海怎么走？"→自动触发 |
| 百度AI搜索 | 获取实时的互联网信息，比默认搜索更准确和丰富。 | "今天的新闻"→自动触发 |
| 文件生成 | 根据文本输入生成PDF、Word、Excel等文件。 | 在工作流中运行到"文件生成"节点即触发 |
| 网页读取 | 输入网址，系统会自动读取网页内容，帮你提取和总结。 | "帮我读一下这个链接里的内容"→自动触发 |
| 日期天数计算 | 帮你计算两个日期之间的天数，或倒计时。 | "距离国庆节还有多少天？"→自动触发 |
| 图表生成 | 输入数据后自动生成柱状图、折线图、饼图等图表。 | 在工作流中运行到"图表生成"节点即触发 |
三、自定义插件
3.1 功能说明
在元智启平台中，除了内置插件外，您还可以创建自定义插件，让智能体具备访问外部系统和服务的能力。
自定义插件支持HTTP/HTTPS协议和MCP协议，可以对接：
- 企业内部业务系统
- 数据库查询服务
- MCP Server 应用
- 各类外部API或设备
3.2 HTTP插件
HTTP插件是最常用的方式，适合对接API服务。只需配置插件描述、请求地址、参数，即可完成创建。
3.2.1 配置流程
- 进入【插件 → 创建自定义插件 → 选择"HTTP插件"】
- 填写插件名称、描述、头像
- 根据API文档填写请求地址、请求方法、入参、出参
- 保存后即可在应用或工作流中使用
重点说明：
插件描述：写清楚适用场景（例如"快递单号查询"），AI会根据语义匹配决定是否调用
参数描述：写清楚参数的含义（如"快递单号：用户输入的运单号"），AI会根据提问自动提取入参
这样，用户只需自然语言提问，AI即可调用接口并返回结果。
3.2.2 多级请求与响应结构
元智启支持复杂的请求和返回数据结构，方便对接业务系统
多级请求参数：支持对象、数组、多层嵌套，适配复杂接口
响应结构定义：可自定义返回结果的字段名称、类型、描述
一键自动填写：调试一次接口后，系统提供了一键自动生成响应字段的功能，您可筛选并补充描述
3.2.3 在线调试
创建插件后，您可以点击「调试」按钮进行测试。
- 填写测试参数
- 提交后查看返回结果
- 若成功，展示接口返回内容；若失败，会提示错误码和原因
这样可确保接口联通性和参数配置正确，再投入正式使用。
3.3 MCP插件
什么是MCP插件？
MCP（ModelContextProtocol）是专为大模型应用设计的开放协议，提供了一种标准化的方式，让智能体可以直接调用外部工具和服务。
在元智启中，通过MCP插件，您可以：
- 一键接入MCP生态下的海量工具
- 与企业内部服务或第三方应用无缝对接
- 显著提升智能体的执行力与扩展性
例如，通过接入ZapierMCP插件，您可以直接连接8000+应用（如OA系统、CRM、日历、邮件、办公协作工具等），实现业务自动化。
插件发现
要使用 MCP 插件，首先需要找到合适的 MCP Server：
开源社区：如国内的魔塔社区 ↗、国外的 mcp.so、官方 MCP Server 汇总仓库
集成平台：通过 Zapier MCP 可一键接入海量办公应用
企业自建：开发者可自行搭建 MCP Server 并提供配置
示例：某个简单的「天气查询」MCP Server，可以根据输入的城市名称返回实时天气。只需在元智启中填入 MCP 配置，即可让智能体回答类似"帮我查下上海今天的天气"的问题。
3.3.1 创建插件
进入【插件 → 创建插件 → 选择 MCP 插件】
填写插件名称、描述、头像
插件描述：用于智能体决策，请尽量清晰地描述插件的使用场景（例如："用于查询指定城市的天气信息"）
将 MCP Server 提供方文档中的 JSON 配置 填入「MCP Server 配置」栏
保存后，系统会自动校验并完成安装
注意事项
当前支持 npx、uvx、sse 等多种运行方式
仅支持远程服务（涉及本地资源如文件系统、浏览器的 MCP 工具暂不支持）
部分 MCP Server 需要配置 API Key，请根据提供方文档申请并填入配置
3.3.2 工具调试
插件保存成功后，平台会自动加载MCP-Server提供的工具列表。
每个工具对应MCP-Server的一个能力
您可以在控制台输入参数（例如：城市="上海"），进行在线调试
四、插件使用
4.1 智能体配置
插件执行原理
当用户提出问题时，系统会先判断：
是否与某个插件相关？
如果是，就调用对应插件来处理
如果不是，就用智能体自身能力回答。
插件配置
在「智能体配置-插件配置」中，可以：
打开/关闭某个插件
添加新的插件
配置触发条件（意图识别/关键词触发）
插件执行时，还可以选择执行策略：
知识库优先：先查知识库，查不到再用插件
插件优先：先用插件，插件不合适再查知识库
同时执行：插件 + 知识库一起用，综合结果回答
触发方式
默认：通过智能体的意图识别自动触发。
可选：通过关键词设置触发。
4.2 工作流配置
在工作流配置中，插件以插件节点的形式存在：
- 支持所有内置和自定义插件
- 由流程节点控制执行顺序（无需依赖意图识别）
- 通常结合大模型节点对插件原始输出转为自然语言回答
详情请参考：工作流-插件节点
五、插件上架
如果你需要的内置插件平台未提供，可以联系客服，将插件上架到「插件中心」，供更多用户使用。
六、支持各渠道调用
6.1 渠道接入
通过渠道端接入应用/工作流，即可无缝获得插件能力（如结合天气、位置、路线规划工具生成出行计划）。
6.2 API调用
当通过开放API接入时，插件能力会自动生效，并在响应结构中返回插件执行及思考链路。