配置调用节点
在对话流程中,如果需要对接外部内容或其他业务系统,可以使用调用节点,通过调用节点为助手灵活添加多种外部能力。
可以使用以下几种调用节点:
- 大模型调用:调用大模型生成内容,并赋值到变量或者实体。
- API调用:调用Rest接口,解析返回结果,并赋值到变量或实体。
- 自定义调用:调用FunctionGraph,解析返回结果,并赋值到变量或实体。
大模型调用节点
在对话过程中,需要用到模型的返回结果时,可配置大模型调用节点将返回结果供后续使用。
- 在左上角节点列表中,拖拽“大模型调用”节点到中间空白区域,单击“大模型调用”节点,界面右侧展开“大模型调用”页签。
图1 大模型调用
- 根据表1设置参数信息。
表1 参数说明 参数名称
参数说明
Prompt
系统自带System提示词,单击“添加信息”,可以添加User、Assistant的提示词。
- System:为对话提供高层指导。
- User:向模型提供指令、查询或任何基于文本的输入。
- Assistant:基于用户消息的模型回复。
Prompt中用&引用变量,@引用实体,示例如下:
###任务:你是一位专业购物导购,按照&{用户输入},收集购物类信息,按照以下规则。##规则: 1、购物品类可以是具体的商品类别,例如衣服、鞋子、手机等。2、购物品类可以是具体的商品,例如乐事薯片、耐克球鞋。记忆
聊天记忆设置。大模型可以结合历史对话,回答问题。
记忆窗口:打开按钮可以设置记忆多少轮的历史对话,取值范围为1-30。
赋值到变量
选择将结果赋值给实体或者变量。
API调用节点
在对话过程中,需要API调用结果时,可配置API调用节点,收集返回结果供后续使用。
使用API调用节点,您先得准备好API的信息,包括API接口地址、接口请求头、接口参数。
- 在左上角节点列表中,拖拽“API调用”节点到中间空白区域,单击“API调用”节点,界面右侧展开“API调用”页签。
图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函数的处理结果供后续使用。
- 在左上角节点列表中,拖拽“自定义调用”节点到中间空白区域,单击“自定义调用”节点,界面右侧展开“自定义调用”页签。
图3 自定义调用
- 根据表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