# 插件

来源快照：`result_data_new_260518.json`

- 来源 ID：`1175088612703813714`
- 模块：AI连接器
- 目录：AI连接器后台配置介绍
- space ID：`1171014986362470480`
- 原文链接：未提供
- 产品基线：未提供

## 正文

# 一、功能背景及价值用途

当前，大语言模型（LLM）在处理实际业务场景时，受限于静态知识和缺乏外部执行能力，难以独立完成如实时数据查询、文件处理、系统集成等任务。为弥补这一短板，主流大模型已广泛支持 Function Calling 能力，使其能够在推理过程中主动请求调用外部工具。然而，Function Calling 仅定义了模型与外部能力之间的交互协议，其真正落地依赖于可被调度和执行的具体功能模块。为此，系统需引入插件机制，将各类可扩展的业务能力以标准化方式注册、管理和调用。通过构建统一的插件体系，系统能够动态对接大模型的 Function Calling 请求，实现从“意图识别”到“动作执行”的闭环，从而显著提升 AI 应用的实用性、灵活性与自动化水平。该能力是支撑智能体（Agent）在企业复杂环境中可靠运行的基础组件。

# 二、功能概述

插件主要包含插件类型、新建插件、高级搜索、插件数据列表、插件菜单权限控制等相关功能。

# 三、功能详细说明

## 1、功能入口

AI连接器-插件，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954313818832896&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 2、插件类型

### 2.1插件类型分类

插件类型分类：系统内置、默认分类、自定义新建类型

### 2.2新建插件类型

点击“+”添加插件类型，类型弹窗字段包含：类型名称、显示顺序，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954330822541323&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

1) 自定义新建的类型无数据时可编辑、删除：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954322358435861&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

2）

自定义新建的类型有数据时只能编辑，不能删除

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954309467267075&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

3）默认分类和系统内置类型不可编辑与删除

## 3、插件列表数据

### 3.1插件设置列表

插件设置列表相关功能包含：高级搜索、列表数据、列表操作

1）

高级搜索：搜索条件包含插件名称、插件分类、插件类型

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954313680306179&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

2）

列表数据主要展示：插件名称、插件描述、插件分类、插件类型、智能体引用数、创建人、更新时间

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954330891771916&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

3）

列表行操作

非系统内置类型插件，选中行可进行编辑、上传到云商店、删除操作

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954305270841351&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

4）

智能体引用数

弹窗列表展示引用该插件的智能体

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954326766534656&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 3.2新建插件

点击【新建】或【从云商店导入】，创建插件

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954309467267079&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954326731022340&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

#### 3.2.1基础信息

1）

插件名称：插件的名称

2）

英文名：用于大模型识别和调用

3）

描述：描述插件的应用场景，大模型根据描述识别并调用插件

4）

插件类型：可新建或选择已有的插件类型，不可选择系统内置类型

5）

插件分类：动作流、前端函数、RPC接口、子智能体

①

动作流：可新建或选择已有的自定义触发类型动作流，选择后参数自动带入。

②

前端函数：前端对话组件触发，需要监听对话组件函数事件，需要手动输入参数。

③

RPC接口：AI连接器调用模块自行实现的函数接口，选择RPC接口后需同时设置【后端接口函数实现类路径】与【RPC接口group】，需要手动输入参数。

④

子智能体：可新建或选择已有的智能体/智能应用，需要手动输入参数

 在实际对话中，大模型会根据输入的内容判断是否需要用到此插件，如若需要使用，会根据插件的输入参数进行字段赋值，然后将所有的输入参数给到“动作流”、“前端函数”、“RPC接口”或“子智能体”，执行其内部逻辑。以RPC接口为例：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954330822541333&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954326731022338&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

6）

输入参数

①

输入参数：需要设置参数名称、描述、参数类型、是否必填、是否数组，可批量添加。

②

插件执行前确认：启用后执行插件前会在会话窗口返回二次确认，用户点击确认后才会执行此插件。如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954322358435841&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

③

执行结果给到大模型再生成结果：将插件执行的结果给到智能体大模型再返回结果信息给用户。例如插件分类选择动作流，动作流执行人员查询，启用【执行结果给到大模型再生成结果】后，大模型就会将动作流找到的人员结果返回给用户，关闭则不返回。

④

消息中显示函数调用记录：启用后在回复的内容中展示函数调用记录，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954313628016645&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

⑤  消息中显示函数返回消息：启用后对话消息中显示函数返回消息，关闭则不显示，关闭后的效果如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954309502779397&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

#### 3.2.3插件执行后动作设置

1）开启：启用后联动展示动作类型、自定义组件设置、高级设置

2）动作类型：自定义组件、回复卡片、打开页面

①  自定义组件：选择自定义组件，下方联动显示自定义组件设置，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954322358435846&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

设置组件打开方式、组件前端模块、组件名称、组件参数。【组件打开方式】可选择弹窗、嵌入消息体，“弹窗”打开方式需要弹窗组件，设置“嵌入消息体”打开方式，对话窗口返回结果如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954322320572426&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

   ②  回复卡片：选择回复卡片，下方联动显示回复卡片设置。如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954309502779393&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

回复卡片相关功能请参考下方【更多参考资料】

   ③  打开页面：选择打开页面，下方联动显示打开页面设置。如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954326766534662&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

设置链接地址、参数配置、打开方式、传参方式。

举例设置和效果如下：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954305270841350&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954330891771905&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

3）高级设置：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954309467267080&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

通过配置前端代码，在对话调用插件后执行前端操作。

### 3.3插件数据来源

① 新建插件数据

② 智能体内新建的插件数据（个人插件不保存在此处）

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954326766534658&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 4、权限控制

【插件】菜单受功能权限-插件菜单控制，勾选后AI连接器模块显示该菜单，不勾选则AI连接器模块不显示该菜单，系统管理员默认勾选。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1222954322320572424&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

# 四、使用注意点

无

# 五、更多参考资料

1、插件的单页地址：

/sp/ai/main/setting/functionConfig
