跳到主要内容

工具调用

在 XpertAI 工作流系统中,工具节点用于调用外部能力与服务,支持数据处理、系统集成、MCP工具调用等多种功能。通过工具节点,用户可以将复杂逻辑与第三方系统能力无缝整合进自动化流程中。

工具类型概览

工具节点支持三类工具接入方式:

  • 内置工具:由 XpertAI 官方提供,开箱即用,部分工具在首次使用前需进行授权配置。
  • 自定义工具:用户可通过标准接口(如 OpenAPI/Swagger/OData)导入或手动配置,适用于接入企业内部系统或专有服务。
  • MCP 工具:支持高度定制,适用于复杂业务逻辑或异步任务,用户可选择已有模块或自行开发。

✅ 所有工具均可在「XpertAI → 工作空间 → 工具」菜单中统一创建和管理。


工具节点参数配置

在使用工具节点时,需在属性面板中完成工具选择与参数配置。具体操作流程如下:

  1. 添加工具节点 在工作流画布中插入「工具」节点。

  2. 选择工具集与工具 在右侧属性面板中,依次选择:

    • 工具集(即创建的工具集)
    • 工具(工具集中的某个工具)
  3. 配置输入参数变量 工具通常需要输入参数,如用户ID、关键词、时间范围等。你可以使用工作流中的状态变量作为输入,例如:

    用户输入内容 → ${human.input}
    当前时间 → ${sys.datetime}
    上一个节点的输出 → ${<node_name>.result}
    • 可以通过工具“复制参数示例”查看参数格式。
    • 支持使用 {{变量}} 语法进行引用。
  4. 输出处理(可选) 工具调用成功后,其返回结果将以变量形式提供给后续节点。你可以通过变量名(如 ${<tool_name>.text})在下游使用或映射指定字段。


高级功能:异常处理机制

为保证流程稳定性,工具节点支持异常处理配置

  • 启用「异常处理」开关后,系统将自动创建一个异常分支(Catch)

  • 用户可在异常分支中添加备用节点,如:

    • 发送错误提醒
    • 返回默认数据
    • 记录日志并终止流程

该机制可有效防止因第三方服务异常导致整个流程中断。


应用示例

  • 使用自定义工具调用 ERP 系统获取订单信息
  • 使用 MCP 工具同步数据至数据中台

小贴士

  • 使用前请确保相关工具已正确创建并测试通过
  • 输入参数尽量使用工作流变量,确保流程通用性与可复用性
  • 对重要调用建议开启异常处理保障流程健壮性