更新时间:2026-02-02 GMT+08:00
分享

配置调用节点

在对话流程中,如果需要对接外部内容或其他业务系统,可以使用调用节点,通过调用节点为助手灵活添加多种外部能力。

可以使用以下几种调用节点:

  • 大模型调用:调用大模型生成内容,并赋值到变量或者实体。
  • API调用:调用Rest接口,解析返回结果,并赋值到变量或实体。
  • 自定义调用:调用FunctionGraph,解析返回结果,并赋值到变量或实体。

大模型调用节点

在对话过程中,需要用到模型的返回结果时,可配置大模型调用节点将返回结果供后续使用。

  1. 在左上角节点列表中,拖拽“大模型调用”节点到中间空白区域,单击“大模型调用”节点,界面右侧展开“大模型调用”页签。
    图1 大模型调用

  2. 根据表1设置参数信息。
    表1 参数说明

    参数名称

    参数说明

    Prompt

    系统自带System提示词,单击“添加信息”,可以添加User、Assistant的提示词。

    • System:为对话提供高层指导。
    • User:向模型提供指令、查询或任何基于文本的输入。
    • Assistant:基于用户消息的模型回复。

    Prompt中用&引用变量,@引用实体,示例如下:

    ###任务:你是一位专业购物导购,按照&{用户输入},收集购物类信息,按照以下规则。##规则: 1、购物品类可以是具体的商品类别,例如衣服、鞋子、手机等。2、购物品类可以是具体的商品,例如乐事薯片、耐克球鞋。

    记忆

    聊天记忆设置。大模型可以结合历史对话,回答问题。

    记忆窗口:打开按钮可以设置记忆多少轮的历史对话,取值范围为1-30。

    赋值到变量

    选择将结果赋值给实体或者变量。

API调用节点

在对话过程中,需要API调用结果时,可配置API调用节点,收集返回结果供后续使用。

使用API调用节点,您先得准备好API的信息,包括API接口地址、接口请求头、接口参数。

  1. 在左上角节点列表中,拖拽“API调用”节点到中间空白区域,单击“API调用”节点,界面右侧展开“API调用”页签。
    图2 接口调用

  2. 根据表2设置参数信息。
    表2 参数说明

    参数名称

    参数说明

    Method

    接口调用方法,包括:

    • POST
    • GET
    • PUT
    • DELETE

    目标URL

    API接口地址。

    Headers

    接口请求头。

    Parameters

    接口参数。

    Body

    符合JSON格式的请求body体。

    出参设置

    出参设置非必填。

    如果需要获取接口返回的内容,可解析返回的JSON格式数据,并支持赋值到变量和实体。可处理多层级JSON格式数据,遵循JSON Pointer语法规范。必须以“/”开头,表示获取根目录。多层级之间使用“/”进行分割。对于数组格式数据,可使用数字获取对应下标的元素。示例如下:

    返回格式:

    {
      "message": "data received",
      "received_data": {
        "key": "value1"
      },
      "received_multi_data": [
        {
          "key": "value2"
        },
        {
          "key": "value3"
        }
      ]
    }

    表达式 1:/message

    结果 1:Data received

    表达式 2:/received_data/key

    结果 2:Value 1

    表达式 3:/received_multi_data/0/key

    结果 3:Value 2

    表达式 4:/

    结果 4:整个json

自定义调用节点

在对话过程中,需要代码处理时,可以配置自定义调用节点,以Function graph函数的处理结果供后续使用。

  1. 在左上角节点列表中,拖拽“自定义调用”节点到中间空白区域,单击“自定义调用”节点,界面右侧展开“自定义调用”页签。
    图3 自定义调用

  2. 根据表3设置参数信息。
    表3 参数说明

    参数名称

    参数说明

    自定义模式

    目前只能选择FunctionGraph。

    函数选择

    可以选择FunctionGraph中的函数进行调用。

    入参设置

    入参取值配置。

    出参设置

    出参设置非必填。

    如果需要获取接口返回的内容,可解析返回的JSON格式数据,并支持赋值到变量和实体。可处理多层级JSON格式数据,遵循JSON Pointer语法规范。必须以“/”开头,表示获取根目录。多层级之间使用“/”进行分割。对于数组格式数据,可使用数字获取对应下标的元素。示例如下:

    返回格式:

    {
      "message": "data received",
      "received_data": {
        "key": "value1"
      },
      "received_multi_data": [
        {
          "key": "value2"
        },
        {
          "key": "value3"
        }
      ]
    }

    表达式 1:/message

    结果 1:Data received

    表达式 2:/received_data/key

    结果 2:Value 1

    表达式 3:/received_multi_data/0/key

    结果 3:Value 2

    表达式 4:/

    结果 4:整个json

相关文档