什么是逻辑建模

逻辑建模是通过配置化方式定义业务处理逻辑的功能。通过配置输入块、大模型、函数、数据搜索和输出块节点及参数，构建完整的数据处理与逻辑执行流程，支持在线调试、运行与发布，实现无代码或低代码方式完成业务逻辑开发。

创建与配置Logic

创建Logic

1. 登录百度胜算控制台，在选中的工作空间操作列单击打开按钮，进入空间内。
2. 侧边导航选择逻辑建模，在逻辑建模列表右上方单击创建。
3. 进入创建 Logic 对话框后，需完成名称、所属位置、描述三项基础配置，详细配置参数请参见表1。

表1 创建Logic基础配置说明

配置项	说明
名称	填写名称，名称不可重复。支持中文、英文、数字、中划线、下划线，不超过256字符。
所属位置	输入项目路径，也可以单击右侧浏览按钮，选择所属项目。
描述	填写描述信息，不超过500个字符。

添加并配置节点

完成创建Logic基础配置后，可配置输入Block、大模型、函数、数据搜索、输出Block节点，构建完整的数据处理与逻辑执行流程。

输入Block

定义逻辑的输入参数与数据结构时，需在输入下拉框中单击添加变量，依次配置变量名称、变量类型等参数，各参数的详细说明及配置要求请参见表2。

表2 输入Block参数配置说明

配置项	说明
变量名称	自定义的变量名称，支持英文大小写字母、数字、下划线，且必须以字母开头，大小不超过128个字符。
变量类型	支持String、Boolean、Date、DateTime、Number五种类型。
描述	对当前变量的补充说明，大小不超过256个字符。
必填	标识该变量是否为必填项。
默认值	系统预设的变量初始值，未手动配置时自动生效。
操作	添加变量：单击添加变量可再新增一条参数。 删除：单击可移除该参数（删除后不可恢复，需谨慎操作）。

大模型

配置大模型的调用参数及对应数据结构时，可按需添加一个或多个大模型，单击添加大模型节点，进入大模型调用配置界面，依次完成基本信息、模型信息的配置，各参数的详细说明及配置要求请参见表3。

表3 大模型参数配置说明

配置项	说明
基本信息	包含名称、系统提示词、用户提示词配置项。
名称	默认是大模型调用，可根据需求进行更改。支持中文、英文、数值以及_-./()特殊字符，不超过128字符。
系统提示词	设定模型的角色和行为模式，决定对话的整体基调和方向。
用户提示词	用户输入的具体问题或请求，决定模型在当前对话中的具体回答内容。
模型信息	包含模型、工具配置、输出参数配置项。
模型	目前仅支持deepseek-v3（预置）。
工具配置	目前仅支持本体对象查询工具。单击添加工具，选择本体对象查询工具，进行配置。 本体对象：选择本体对象。 属性：选择本体对象中的属性，支持多选。 操作：添加本体对象：单击添加本体对象可新增一个本体对象。删除：单击可移除该参数（删除后不可恢复，需谨慎操作）。 说明：本地对象查询工具需先完成本体配置后才能选择。
输出参数	变量名称：输出变量的名称。支持英文大小写字母、数字、下划线、中划线且必须以字母开头，大小不超过128个字符。 变量类型：输出变量的类型。支持String、本体对象、本体对象列表等多种类型。 描述：对输出变量的描述。

函数

配置函数的调用参数及对应数据结构时，可按需添加一个或多个函数，单击添加函数节点，进入函数调用配置界面，依次完成基本信息、函数信息的配置，各参数的详细说明及配置要求请参见表 4。

表4 函数参数配置说明

配置项	说明
基本信息	包含名称配置项。
名称	默认是函数调用，可根据需求进行更改。支持中文、英文、数值以及_-./()特殊字符，不超过256字符。
函数信息	包含函数名称和描述配置项。
函数名称	输入函数名称。支持英文大小写字母、数字、下划线、中划线且必须以字母开头，不超过256字符
描述	对函数的描述。大小不超过500个字符。
函数配置	包含输入函数、代码类型、函数代码、输出参数配置项。
输入函数	变量名称：输出变量的名称。支持英文大小写字母、数字、下划线、中划线且必须以字母开头，大小不超过128个字符。 变量类型：输出变量的类型。支持String、本体对象、本体对象列表等多种类型。 引用变量：引用上游Block输出的变量，作为当前输出变量的计算来源。变量名称、数据类型需与上游输出完全保持一致，否则会导致参数传递失败。 描述：对当前变量的补充说明，大小不超过256个字符。 默认值：系统预设的变量初始值，未手动配置时自动生效。 操作：添加变量：单击添加变量可新增一个变量。删除：单击可移除该参数，删除后不可恢复，请谨慎操作。
代码类型	支持JavaScript和Python两种变量类型。
函数代码	代码输入框。
输出参数	变量名称：输出变量的名称。支持英文大小写字母、数字、下划线、中划线且必须以字母开头，大小不超过128个字符。 变量类型：输出变量的类型。支持String、本体对象、本体对象列表等多种类型。 描述：对输出变量的描述。

数据搜索

配置数据搜索的调用参数及对应数据结构时，可按需添加一个或多个数据搜索节点，单击添加数据搜索节点，进入数据搜索调用配置界面，依次完成基本信息、函数信息的配置，各参数的详细说明及配置要求请参见表5。

表5 数据搜索参数配置说明

配置项	说明
基本信息	包含名称、检索服务、函数信息配置项。
名称	默认是数据搜索，可根据需求进行更改。支持中文、英文、数值以及_-./()特殊字符，不超过256字符。
检索服务	选择检索服务。
函数信息	query：选择上游的变量。 其余参数（ontology、recall、metadata_filters、rerank、top_k、score_threshold、chunk_expansion）：全部拉取服务端的配置默认填充，支持您根据业务需求修改。 输出参数：变量名称：输出变量的名称。支持英文大小写字母、数字、下划线、中划线且必须以字母开头，大小不超过128个字符。输出参数：变量类型：固定是Struct。输出参数：描述：对输出变量的描述。

输出Block

定义该业务逻辑的返回参数时，需在输入下拉框中单击添加变量，依次配置输出变量、引用变量等参数，各参数的详细说明及配置要求请参见表6。

表6 输入Block参数配置说明

配置项	说明
变量名称	自定义的变量名称，支持英文大小写字母、数字、下划线，且必须以字母开头，大小不超过128个字符。
引用变量	引用上游Block输出的变量，作为当前输出变量的计算来源。变量名称、数据类型需与上游输出完全保持一致，否则会导致参数传递失败。
输出已选属性	开启时，仅输出在本体查询工具中已选择的本体属性；关闭时，则输出本体对象的所有属性。
携带属性描述	是否将变量的描述页输出。
操作	添加变量：单击添加变量可再新增一条参数。 删除：单击可移除该参数（删除后不可恢复，需谨慎操作）。

基本信息

单击右侧基本信息按钮，在弹出的配置面板中可查看当前节点的名称、API名称、创建人、创建时间、所属位置和描述，并支持根据业务需求修改节点名称与描述。

测试

完成Logic节点配置后，单击右侧测试按钮，系统会根据Block的输入变量展示全部输入项供用户填写。用户输入完成后，点击运行测试按钮，将展开所有Block的运行信息及相关日志。

保存发布

完成配置与测试验证后，可单击保存按钮对当前Logic节点配置进行持久化存储。确认配置无误后，单击发布按钮将配置生效至运行环境，发布成功后即可正常调用。

查看数据建模列表

1. 登录百度胜算控制台，在选中的工作空间操作列单击打开按钮，进入空间内。
2. 侧边导航选择逻辑建模，即可查看逻辑建模列表的详细信息，也可根据名称进行搜索查看，具体字段说明可参考表7。

表7 数据建模列表字段说明

列表项	说明
名称	展示当前Logic的名称。
描述	展示当前Logic的描述。
API名称	展示当前Logic对外对应的API标识名称。
发布状态	当前Logic的发布状态。发布状态类型包含未发布、已发布和已发布有更新。支持按发布状态筛选Logic。
创建人	展示当前Logic的创建人。
创建时间	展示当前Logic的创建时间戳。支持按生序或降序进行筛选Logic。
操作	单击操作列不同按钮，对当前Logic进行不同操作。 编辑：单击编辑按钮，可对当前Logic进行编辑操作。 复制：单击复制按钮，会直接复制一个相同配置，名称不同的Logic。 删除：单击删除按钮，删除后进入回收站并同步删除底层索引，恢复时仅恢复元数据且索引状态为未索引，若存在重名则不允许恢复。进入回收站后，30天后自动彻底删除。 发布：单击发布按钮，将当前Logic发布至运行环境。