菜单

为什么 AI 员工没有按预期调用工具？

当用户询问订单、商品、库存或物流等信息时，AI 员工可以调用已经添加的工具查询相关数据。

如果出现 AI 员工没有调用工具、调用了错误的工具，或者没有正确使用工具返回的数据，建议先使用「排查小助手」分析具体回答，了解可能的问题原因和优化建议，再根据排查结果检查对应的工具配置和人设规则。具体使用方法可参考：《AI 员工回答不符合预期时如何排查？》。

本文将介绍工具调用异常的常见原因，以及需要重点检查的相关配置。

本文链接：《为什么 AI 员工没有按预期调用工具？》

一、确认工具已正确配置

首先检查工具本身是否已经正确配置：

  1. 工具是否已经添加到当前 AI 员工。
  2. 插件是否已经完成鉴权。
  3. 自定义工具能否调试成功并返回预期数据。
  4. 修改 AI 员工配置后，是否已经点击「发布」。

工具调试成功只能说明接口和参数可以正常运行。AI 员工是否会在对话中调用该工具，还与添加的工具是否符合当前使用场景、工具自身的名称和描述，以及人设中的调用规则有关。

二、检查工具配置和适用范围

不同类型的工具，可调整的配置不同：

  • 平台提供的插件：工具名称、描述和参数已经预先配置，无需自行修改。
  • 自定义插件和工具：可以自行设置工具名称、描述、输入参数和输出参数。

1. 平台提供的插件

对于 Shopify、WooCommerce 等平台提供的插件，请确认：

  1. 插件已经完成授权。
  2. 需要使用的工具已经添加到当前 AI 员工。
  3. 添加的工具与用户咨询的问题相符。

例如，Shopify 插件中可能包含商品查询和订单查询等不同工具。用户咨询商品时，需要添加商品查询工具；用户咨询订单状态时，需要添加订单查询工具。

2. 自定义插件和工具

对于自行创建的工具，应确保工具名称和描述能够清楚说明其用途。

工具名称应体现具体的查询对象和能力，避免使用“查询信息”“获取数据”等过于宽泛的名称。

例如：

  • 不推荐：查询订单
  • 推荐：根据订单号查询订单状态

工具描述还应说明工具的使用场景、需要提供的信息和适用范围。

例如：

当用户询问订单状态、付款状态或发货进度时，使用该工具。调用前需要获得用户的订单号。

输入参数和输出参数也应使用清楚的名称和描述，并只保留完成查询和回答所需的字段。

自定义工具的具体配置方法，请参考：《自定义插件和工具》。

三、在人设中补充调用规则

除了工具自身的描述，还可以在人设中说明工具的调用流程。

例如：

当用户要求查询订单时，首先获取用户的邮箱、手机号、订单号调用Retrieve Customer Orders帮用户查询订单。判断用户意图为搜索商品，以及需要商品推荐时，提取用户问题的关键词后调用Search Shopify Products工具获取相关商品并推荐给用户

调用规则建议写清楚：

  • 什么情况下调用工具
  • 缺少参数时如何询问用户
  • 工具返回结果后如何回答
  • 查询失败或没有结果时如何处理

人设的具体配置方法，请参考：如何设置 AI 员工人设？

四、重新测试工具调用效果

完成修改后，在右侧「问答测试」中先清除原有测试对话，再使用不同表达方式重新测试。可以分别测试“已经提供查询所需信息”和“缺少必要信息”两种情况，确认 AI 员工能否正确判断何时调用工具、如何补充必要信息，以及如何根据工具返回结果回答。

五、常见问题

1. 为什么工具调试成功，AI 员工还是没有调用？

工具调试成功只代表接口可以正常运行，不代表 AI 员工一定会在对话中调用该工具。

对于平台提供的插件，请确认添加的工具与用户咨询的问题相符，并在人设中补充调用条件。对于自定义工具，还需要检查工具名称、描述和参数设置是否清楚。

相关教程：《自定义插件和工具》

2. 为什么 AI 员工调用了错误的工具？

如果使用平台提供的插件，请确认是否为 AI 员工添加了正确的工具，并在人设中清楚区分不同工具的使用场景。

如果使用自定义工具，多个工具的名称或描述可能过于相似。建议在工具名称和描述中写明查询对象、用途和适用范围。

相关教程：《插件是什么？工具是什么？》

3. 为什么 AI 员工没有询问查询所需的信息？

请在人设中明确说明：缺少订单号、邮箱、手机号或其他必要信息时，应先向用户询问，获得查询所需信息后再调用工具。

如果使用自定义工具，还需要确认相关参数是否已经设置为必填，并填写了清楚的参数描述。

相关教程：《如何设置 AI 员工人设？》

4. 为什么工具返回了数据，AI 员工仍然回答错误？

如果使用自定义工具，请检查输出参数中是否包含回答需要的关键字段，以及字段名称和描述是否清楚。

对于订单、价格、库存和物流等实时数据，还应在人设中明确要求 AI 员工以工具返回结果为准，不得自行猜测。

相关教程：自定义插件和工具

5. 能否保证 AI 员工每次都调用指定工具？

AI 员工会根据用户表达、工具配置和人设规则判断是否调用工具，因此不同表达方式下可能存在差异。

请确保已经添加正确的工具，并在人设中写清调用条件、信息不足时的处理方式，以及查询失败时的回复方式。修改后，可以使用多种真实问题进行测试；如果回答不符合预期，可以使用排查小助手进一步分析。

相关教程：AI 员工回答不符合预期时如何排查？

六、相关推荐

上一个
自定义插件和工具
下一个
统计分析
最近修改: 2026-09-02Powered by