# 插件介绍
#### 什么是插件
在Agent（智能体）中，**插件**是大语言模型（LLM）与外部世界交互的一系列工具。
尽管LLM具备强大的自然语言处理与推理能力，但其本质是基于训练数据的静态系统，存在两大局限：
- **信息滞后：**无法获取训练截止日期之后的实时信息。
- **行动力缺失：**无法直接与现实世界的软件或硬件系统交互（如读写数据库、发送请求）。
插件的引入，使Agent具备了实时信息检索、外部任务执行的能力，是Agent从"对话系统"向"任务解决系统"演进的关键模块。
AgentArts智能体平台提供了丰富的预置插件，包括天气查询、热搜查询、文档生成、出行旅游等。例如，在您的Agent中添加天气查询插件，即可获取实时天气信息。
当官方插件无法满足特定业务需求时，您可以自主创建插件。
#### 插件分类、形态
AgentArts智能体平台提供丰富的插件资源，除预置的官方插件外，还支持用户自定义插件，可将API能力通过插件形式引入Agent。
表1插件分类、形态 
| 插件分类        | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|
| 官方预置插件      | 由AgentArts智能体平台预置到"资产广场"的官方插件，由AgentArts平台提供技术支持和维护，平台负责托管这些插件的后端逻辑并为您处理鉴权。您只需关注如何调用能力，无需关心底层实现。 官方预置插件分为无需鉴权和需鉴权两类： - 无需鉴权：在Agent中添加插件即可使用。  - 需鉴权：填写API Key鉴权信息完成认证后即可使用。   **选型建议** ：如果您需要的是**通用能力** （如天气查询、搜索等），且希望**零代码、快速接入**，请优先选择官方预置插件。                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 自定义-API类型插件 | API类型插件是将现有的RESTful API（HTTP/HTTPS接口）封装为Agent可调用的工具。它可以让Agent把理解到的指令转化为实际的API请求，直接调用外部系统完成任务。 - 运行位置：实际的业务逻辑在外部API服务器（如企业的后端服务器、第三方功能平台）上运行。Agent充当客户端发起请求，并接收API返回的响应。  - 适用场景： - 数据检索：从外部数据库或服务获取实时数据（如天气查询、网络搜索、新闻查询）。例如，在"出行助手"智能体中，通过天气查询插件获取目的地实时天气，为用户提供穿衣建议。  - 状态变更：在外部系统中执行提交、变更类操作。例如，在"运维助手"智能体中，通过自定义API插件对接内部工单系统，根据用户描述自动创建维修工单。  - 复杂业务逻辑处理：利用已有的成熟后端服务处理复杂的业务流程。     **选型建议** ：如果您需要对接**企业内部系统** （如ERP、CRM），或者需要实现**特殊的业务逻辑**，官方插件无法满足需求时，请使用自定义API插件。此方式需要您自行开发并维护后端API服务。 |
   
#### 插件与工具
在AgentArts智能体平台中，理解插件与工具的从属关系是成功创建插件的前提，可通过以下"文字识别"插件示例直观理解。
 表2文字识别插件示例 
| 插件名称   | 工具名称   | API接口地址                                                  |
|:---|:---|:---|
| 文字识别插件 | 通用文字识别 | https://{endpoint}/v2/{project_id}/ocr/**general-text**  |
| 文字识别插件 | 通用表格识别 | https://{endpoint}/v2/{project_id}/ocr/**general-table** |
| 文字识别插件 | 手写文字识别 | https://{endpoint}/v2/{project_id}/ocr/**handwriting**   |
   
**插件**：是集成了一个或者多个工具的功能集合，它定义了这些工具共用的基础属性（如服务域名、鉴权方式）。
**工具**：是插件内具体的执行单元，每个工具对应一个独立的功能，负责完成一项具体的单一任务。
AgentArts智能体平台支持自定义插件的开发与创建。在配置规则中，要求同一插件下的工具需要具备同类功能。
以[表2]为例，https://{endpoint}/v2/{project_id}/ocr是所有接口的公共基础路径，它定义了插件的连接目标（由服务域名+基准URL构成）；/**general-text**这类后缀是各工具独有的"路径"，它区分了插件内的不同能力。
图1API与插件关系示例   
![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389993.png "点击放大")
在执行层面，Agent并不直接"运行插件"，而是调用插件内某一特定工具。当Agent需要执行"表格图片提取文字"任务时，它会定位到"文字识别插件"，然后精准地调用其中的"通用表格识别工具"，这本质上是向.../ocr/general-table接口发起了一次请求。
图2插件与工具关系示例   
![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549869.png "点击放大")