j9九游会登录/ 智能体平台 agentarts/ 用户指南/ 插件/ 插件介绍
更新时间：2026-02-06 gmt 08:00
查看pdf

插件介绍-j9九游会登录

什么是插件

在agent（智能体）中插件是大语言模型（llm）与外部世界交互的一系列工具。

尽管llm具备强大的自然语言处理与推理能力，但其本质是基于训练数据的静态系统，存在两大局限：

  • 信息滞后：无法获取训练截止日期之后的实时信息。
  • 行动力缺失：无法直接与现实世界的软件或硬件系统交互（如读写数据库、发送请求）。

插件的引入，使agent具备了实时信息检索、外部任务执行的能力，是agent从“对话系统”向“任务解决系统”演进的关键模块。

在agentarts智能体平台中，提供了丰富的预置插件，包括天气查询、热搜查询、文档生成、出行旅游等插件。例如，在您的agent中添加天气查询插件，可以获取查询实时天气的能力。

当官方插件无法满足特定业务需求时，您可以自主创建插件。根据实现机制与运行形态的不同，自定义插件主要分为“api类型插件”和“函数类型插件”两种形态。

插件分类、形态

agentarts智能体平台中提供丰富的插件资源，除预置的官方插件外，j9九游会登录的服务支持用户自定义插件，可以将api、函数代码的能力通过插件形式引入agent。

表1 插件分类、形态

插件分类

说明

官方预置插件

由agentarts智能体平台上架到“资产广场”的官方插件，由agentarts提供j9九游会登录的技术支持和维护。

官方预置插件分为无需鉴权和需鉴权两类;

  • 无需鉴权：直接在agent中添加插件即可使用。
  • 需鉴权：填写api key鉴权信息进行认证后，可直接使用。

自定义-api类型插件

api类型插件是将现有的restful api（http/https 接口）封装为agent可调用的工具。它可以让agent把理解到的指令转化为实际的api请求，直接调用外部系统完成任务。

  • 运行位置：实际的业务逻辑在外部api服务器（如企业的后端服务器、第三方功能平台）上运行。agent充当客户端发起请求，并接收api返回的响应。
  • 适用场景
    • 数据检索：从外部数据库或服务获取实时数据（如天气查询、网络搜索、新闻查询）。
    • 状态变更：在外部系统中执行提交、变更类操作。
    • 复杂业务逻辑处理：利用已有的成熟后端服务处理庞大的业务流程。

自定义-函数类型插件

函数类型插件是指直接在agentarts智能体平台中编写并运行的一段代码脚本（python3.9或node.js14.18脚本），它不依赖外部服务器，而是利用平台提供的算力即时执行。

  • 运行位置：在agentarts智能体平台提供的沙箱环境中运行。
  • 适用场景：由于代码逻辑是固定的，输入确定则输出必然确定。因此适用于数值计算、数据清洗、文本处理这类场景。

插件与工具

在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这类后缀是各工具独有的“路径”，他区分了插件内的不同能力。

图1 api与插件关系示例

在执行层面，agent并不直接“运行插件”，而是调用插件内某一特定工具。当agent需要做“表格图片提取文字”任务，他会定位到“文字识别插件”，然后精准的调用其中的“通用表格识别工具”，这本质上是向.../ocr/general-table接口发起了一次请求。

图2 插件与工具关系示例
父主题： 插件

相关文档

网站地图