应用平台 APPSTAGE-创建知识检索流:知识检索流相关节点说明
下载应用平台 APPSTAGE用户手册完整版
知识检索流相关节点说明
本节仅介绍知识检索流特有的检索规划、召回及重排序三个节点，工作流其他基础节点说明请参见工作流基础节点说明。
- 检索规划
检索规划包含“Query拆解”、“Query改写”、“意图识别”三个执行动作，执行动作参数配置说明如表2所示。
- Query拆解：配置适当的模型将原始查询内容拆解为更简单、易理解的请求。
- Query改写：配置适当的模型对原始查询内容进行改写、优化，使得原始请求更准确。
- 意图识别：配置适当的模型对原始内容进行意图判断。
表2 检索规划执行动作参数说明 参数
说明
输入
模型服务调用ID
执行检索规划所调用的模型。
- 对于资产中心预置的模型，在资产中心选择“大模型”页签，单击模型卡片进入模型详情页面，查看模型服务调用ID。
- 对于我的模型（我部署的、我接入的）和我的路由策略，需要填写模型服务调用ID，请单击“获取模型服务调用ID”，进入“我的模型服务”页面，在模型服务列表中单击
复制。
原始查询内容
当执行动作为“拆解/改写”时，需要配置此参数。
表示待处理（拆解/改写）的原始内容。
原始文本内容
当执行动作为“意图识别”时，需要配置此参数。
表示待进行意图识别的原始内容。
意图类别
当执行动作为“意图识别”时，需要配置此参数。
定义意图类别，大模型会按照定义的意图类别对用户问题进行归类。
支持自定义数组或选择数组类型的节点输出，例如：["儿科医疗问题","消化科医疗问题"]。
输出
该执行动作是根据用户定义的内容输出指定参数。
节点实例
实例是节点的鉴权方式，如果未新增实例，节点就无法调通。
- 实例名称：必填项，自定义实例名称。
- 描述：选填项，输入实例相关描述信息。
- API Key：必填项，具体介绍请参见创建API Key。
节点备注
输入节点备注信息，方便后续查阅节点功能。
- 召回
召回节点包含“召回”一个执行动作，用于从知识库中检索并召回所有与查询相关的信息，参数配置说明如表3所示。
表3 召回执行动作参数说明 参数
说明
输入
知识库ID
请单击“获取知识库ID”，进入知识库列表，单击
复制。向量化检索内容
向量化检索的内容。
相似度阈值
相似度阈值的取值范围[0, 1]，例如配置为0.5，则返回相似度大于等于0.5的结果。
召回数量
从检索结果中返回的内容片段数量，取值范围：0~10。
文本过滤
过滤条件。默认为空，支持填入SearchSqlFilter类对象，SearchSqlFilter参数说明如表4所示，样例如下：
{ "group_type": "OR", "expressions": [ { "field": "metadata.file_name", "field_type": "STRING", "operator": "EQUAL", "values": [ "四大名著介绍.txt" ] }, { "field": "metadata.path", "field_type": "STRING", "operator": "EQUAL", "values": [ "四大名著介绍.txt" ] } ] }召回排序
排序规则。默认为空，支持填入SqlOrder类对象，SqlOrder参数说明如表6所示，样例如下：
{ "order_items": [ { "field": "metadata.order", "field_type": "INT", "order_type": "DESC" } ] }输出
该执行动作是根据用户定义的内容输出指定参数。
节点实例
实例是节点的鉴权方式，如果未新增实例，节点就无法调通。
- 实例名称：必填项，自定义实例名称。
- 描述：选填项，输入实例相关描述信息。
- API Key：必填项，具体介绍请参见创建API Key。
节点备注
输入节点备注信息，方便后续查阅节点功能。
表4 SearchSqlFilter 参数
是否必选
参数类型
描述
group_type
否
String
参数解释：
过滤条件运算符。
约束限制：
只有一个expression时，不需要group_type，group_type可以为null。
取值范围：
可以为null，如果不为null，枚举值AND和OR。
默认取值：
不涉及。
expressions
否
Array of Expression objects
参数解释：
过滤条件。
约束限制：
不涉及。
取值范围：
非空，条件数量介于1到10之间。
默认取值：
不涉及。
表5 Expression 参数
是否必选
参数类型
描述
field
否
String
参数解释：
过滤字段。
约束限制：
不涉及。
取值范围：
非空，字符串长度介于1到100之间。
默认取值：
不涉及。
field_type
否
String
参数解释：
过滤字段类型。
约束限制：
不涉及。
取值范围：
可以为null，如果不为null，枚举值：INT、FLOAT、BOOLEAN和STRING。
默认取值：
不涉及。
operator
否
String
参数解释：
过滤操作符。
约束限制：
不涉及。
取值范围：
可以为null，如果不为null，枚举值：EQUAL、NOT_EQUAL、GREAT_THAN、GREAT_EQUAL、LESS_THAN、LESS_EQUAL、IN、NOTIN和STARTS_WITH。
默认取值：
不涉及。
values
否
Array of strings
参数解释：
过滤值。
约束限制：
当operator参数的值为EQUAL（等于）、NOT_EQUAL（不等于）、GREAT_THAN（大于）、GREAT_EQUAL（大于等于）、LESS_THAN（小于）、LESS_EQUAL（小于等于）和STARTS_WITH（以xxx开头）时，数量限制为1。
取值范围：
非空，数量介于1到100之间，每个字符串长度最大不超过2000。
默认取值：
不涉及。
表6 SqlOrder 参数
是否必选
参数类型
描述
order_items
否
Array of OrderItem objects
参数解释：
排序规则。
约束限制：
不涉及。
取值范围：
非空，数量介于1到10之间。
默认取值：
不涉及。
表7 OrderItem 参数
是否必选
参数类型
描述
field
否
String
参数解释：
排序字段。
约束限制：
不涉及。
取值范围：
非空，字符串长度介于1到100之间。
默认取值：
不涉及。
field_type
否
String
参数解释：
排序字段类型。
约束限制：
不涉及。
取值范围：
可以为null，如果不为null，枚举值：INT、FLOAT、BOOLEAN和STRING。
默认取值：
不涉及。
order_type
否
String
参数解释：
排序类型。
约束限制：
不涉及。
取值范围：
不为null，枚举值：ASC（升序）和DESC（降序）。
默认取值：
不涉及。
- 重排序
重排序节点包含“重排序”一个执行动作，用于对召回结果进行重排序，参数配置说明如表8所示。
表8 重排序执行动作参数说明 参数
说明
输入
模型服务调用ID
执行重排序所调用的模型，例如平台预置的bge-reranker-large。
- 对于资产中心预置的模型，在资产中心选择“大模型”页签，单击模型卡片进入模型详情页面，查看模型服务调用ID。
- 对于我的模型（我部署的、我接入的）和我的路由策略，需要填写模型服务调用ID，请单击“获取模型服务调用ID”，进入“我的模型服务”页面，在模型服务列表中单击
复制。
原始查询内容
用户的请求内容。
排序返回数量
返回排名前n个文档。
召回结果
召回的结果，提供给模型进行重排序。
输出
该执行动作是根据用户定义的内容输出指定参数。
节点实例
实例是节点的鉴权方式，如果未新增实例，节点就无法调通。
- 实例名称：必填项，自定义实例名称。
- 描述：选填项，输入实例相关描述信息。
- API Key：必填项，具体介绍请参见创建API Key。
节点备注
输入节点备注信息，方便后续查阅节点功能。
