菜单

插件是什么？工具是什么？

一、功能简介

插件模块用于为 AI 员工扩展外部能力。

默认情况下，AI 员工主要根据已配置的人设、知识库等内容进行回复，并执行已经启用的技能。添加插件和工具后，AI 员工还可以在合适的对话场景中调用外部系统能力，例如：

查询客户订单信息
查询商品、库存或价格
查询物流状态
调用您自己系统中的 API 获取业务数据

简单来说，插件和工具可以让 AI 员工从“只根据已有内容回答”，变成“可以在对话中按需调用外部能力”。

二、插件和工具的关系

插件是工具的集合，工具是 AI 员工可以调用的具体能力。

可以这样理解：

插件：用于管理一组相关能力，例如 Shopify 插件、WooCommerce 插件、自定义插件。
工具：插件里的具体能力，例如查询订单、搜索商品、查询物流。

一个插件可以包含一个或多个工具。AI 员工真正调用的是工具，插件负责把这些工具归类管理，并承载相关授权或配置。

当您把其中某个工具添加到 AI 员工后，AI 员工才有机会在对话中使用这个具体能力。

三、插件类型说明

1. 平台插件

平台插件是 HelpKnow 已经内置的插件，适合接入常见平台。

例如，平台插件可能包括 Shopify、BigCommerce、Shoppass、WooCommerce 等（具体支持的平台以插件页面展示为准）。

平台插件通常适合以下情况：

您使用的平台已经出现在插件列表中。
您希望快速让 AI 员工查询订单、商品、物流等平台数据。
您不想从 0 配置 API 请求、输入参数和输出参数。

平台插件一般需要先完成对应平台的授权配置，再把需要使用的工具添加到 AI 员工中。

2. 自定义插件

自定义插件适合接入您自己的系统或接口。

如果 HelpKnow 当前没有内置您需要的平台插件，或者您希望 AI 员工调用公司内部系统、CRM、ERP、工单系统等接口，可以使用自定义插件。

自定义插件通常需要配置：

插件名称和描述
授权方式
工具名称和描述
请求地址和请求方法
输入参数
输出参数
调试和保存

这部分配置相对偏技术，建议由了解接口信息的成员完成。

四、工具如何添加到 AI 员工

工具需要添加到具体 AI 员工后，才会影响该 AI 员工的回复能力。

操作入口为：

进入需要配置的 AI 员工。
打开 AI 员工配置页。
找到「工具」模块，点击「添加工具」。
选择需要添加的平台插件工具或自定义插件工具。
添加后点击「发布」，使工具配置正式生效。

添加工具后，建议在 AI 员工的人设中说明工具的使用条件。这样可以帮助 AI 员工判断什么时候应该调用工具。

例如：

当客户询问订单状态、物流进度或发货时间时，调用订单查询工具获取最新信息，再根据查询结果回复客户。

（具体写法可根据您的业务场景调整。）

注意事项

完成插件授权或配置后，还需要将具体工具添加到对应的 AI 员工。添加工具后，也不代表 AI 员工每次都会调用，是否调用还会受到用户问题、工具描述、人设说明和使用条件等因素影响。
平台插件通常需要先完成授权配置，否则工具可能无法正常获取平台数据。
自定义插件需要确保 API 地址、鉴权方式、输入参数和输出参数配置正确，否则工具调用可能失败。
建议一个工具只对应一个明确能力，例如查询订单、搜索商品、查询物流，避免一个工具承担过多任务。
插件页面中展示的平台、工具数量和授权要求可能会调整，请以实际页面展示为准。

常见问题

1. 插件和工具有什么区别？

插件是工具的集合，工具是 AI 员工可以调用的具体能力。

例如，Shopify 插件可以理解为一组 Shopify 相关能力的集合，其中可能包含订单查询工具、商品搜索工具等。

2. 只添加插件可以让 AI 员工调用能力吗？

通常需要把具体工具添加到 AI 员工后，AI 员工才可以使用该工具。

插件用于管理工具，AI 员工真正调用的是工具。

3. 平台插件和自定义插件应该怎么选？

如果 HelpKnow 已经提供了对应平台插件，建议优先使用平台插件。

如果您要接入自己的系统，或当前没有对应平台插件，可以使用自定义插件。

4. 为什么添加工具后 AI 员工没有调用？

可能原因包括：

用户问题没有触发工具的使用场景。
工具没有添加到当前 AI 员工。
工具名称或描述不够清晰。
AI 员工的人设中没有说明必要的使用条件。
插件授权、接口参数或输出参数配置不正确。

可以先确认工具是否已经添加到对应的 AI 员工，并检查插件授权和参数配置；如果工具仍未按预期调用，再补充工具描述或在人设中说明调用条件。