插件介绍
什么是插件
在Agent（智能体）中插件是大语言模型（LLM）与外部世界交互的一系列工具。
尽管LLM具备强大的自然语言处理与推理能力，但其本质是基于训练数据的静态系统，存在两大局限：
- 信息滞后：无法获取训练截止日期之后的实时信息。
- 行动力缺失：无法直接与现实世界的软件或硬件系统交互（如读写数据库、发送请求）。
插件的引入，使Agent具备了实时信息检索、外部任务执行的能力，是Agent从“对话系统”向“任务解决系统”演进的关键模块。
在AgentArts智能体平台中，提供了丰富的预置插件，包括天气查询、热搜查询、文档生成、出行旅游等插件。例如，在您的Agent中添加天气查询插件，可以获取查询实时天气的能力。
当官方插件无法满足特定业务需求时，您可以自主创建插件。根据实现机制与运行形态的不同，自定义插件主要分为“API类型插件”和“函数类型插件”两种形态。
插件分类、形态
AgentArts智能体平台中提供丰富的插件资源，除预置的官方插件外，服务支持用户自定义插件，可以将API、函数代码的能力通过插件形式引入Agent。
|
插件分类 |
说明 |
|---|---|
|
官方预置插件 |
由AgentArts智能体平台上架到“资产广场”的官方插件，由AgentArts提供技术支持和维护。 官方预置插件分为无需鉴权和需鉴权两类;
|
|
自定义-API类型插件 |
API类型插件是将现有的RESTful API（HTTP/HTTPS 接口）封装为Agent可调用的工具。它可以让Agent把理解到的指令转化为实际的API请求，直接调用外部系统完成任务。
|
|
自定义-函数类型插件 |
函数类型插件是指直接在AgentArts智能体平台中编写并运行的一段代码脚本（Python3.9或Node.js14.18脚本），它不依赖外部服务器，而是利用平台提供的算力即时执行。
|
插件与工具
在AgentArts智能体平台中，理解插件与工具的从属关系是成功创建插件的前提，可以通过以下“文字识别”插件协助进行直观的理解。
|
插件名称 |
工具名称 |
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这类后缀是各工具独有的“路径”，他区分了插件内的不同能力。
在执行层面，Agent并不直接“运行插件”，而是调用插件内某一特定工具。当Agent需要做“表格图片提取文字”任务，他会定位到“文字识别插件”，然后精准的调用其中的“通用表格识别工具”，这本质上是向.../ocr/general-table接口发起了一次请求。
