配置服务集成

前提条件

• 确保已完成服务所需模型的部署。

• 与发起调用的系统确认服务的出参和入参。

步骤一：创建服务

进行服务集成之前，您需要先创建服务。

1. 登录多方安全建模控制台。

2. 在左侧导航栏，单击 模型部署 > 服务集成。

3. 在 服务集成 页面，单击 新建服务，完成以下配置。

   参数	描述
   版本编排模板	根据实际业务需求，选择空白模板或选择系统提供的模板。
   服务名称	设置服务名称，命名要求如下： 由中文、英文字母、数字或下划线组成。 长度不超过 40 个字符。
   唯一标识	唯一标识由英文字母、数字或下划线组成，且要求全局唯一。 如果已经线下约定了服务标识，则服务唯一标识为服务标识中最后一个“.”之后的部分。例如，服务标识为 dx.datalab.NODE_TEST_PREDICTION_bvyYhN7z.HB_MODEL，则服务唯一标识为 HB_MODEL。
   服务描述（可选）	服务对应的描述。
   版本名称	服务的版本名称，仅支持数字、英文字母和英文句号（.）。
   版本描述	版本对应的描述。

4. 单击 新建，即可成功创建服务。

步骤二：编排流程

成功创建服务后，需进行流程编排。

1. 登录多方安全建模控制台。

2. 在左侧导航栏，单击 模型部署 > 服务集成。

3. 在 服务集成 页面，单击指定服务名称，再单击指定版本号，进入服务的流程编排页面。

   

4. 编排流程。

   将左侧工具栏中的组件拖动到右侧的画布中，并以连线的方式串接服务流程。

   说明

   编排流程必须以开始组件作为流程的开始，以结束组件作为流程的终止。

   • 规则集：支持类似 CASE WHEN 语句的条件判断规则。

   • 脚本：支持加入 Java 代码作为变量的处理。

   • 模型：在“模型部署”中部署成功的模型，支持在此处引用。

   • 分叉：支持类似 IF ELSE 语句的条件判断规则。

步骤三：验证服务

完成服务的流程编排后，可以开始验证服务。

1. 在服务的流程编排页面，单击右上角的 验证 > 单条验证。

2. 在 单条验证 页面，配置服务验证信息。

   • 决策入参：根据实际情况设置决策入参信息。

   • 决策出参（可选）：建议填写预期的正确值，方便后续进行正确验证时对比数值。

   • 选择发起调用的节点：选择需要主动发起服务验证的节点。

3. 配置完成，单击 确认。

步骤四：提交服务

1. 在服务的流程编排页面，单击右上角的 提交。

2. 在弹出的确认提交对话框中，单击 确认。

   • 已经提交的服务不能再编排服务流程，但仍可以在服务流程编排页面验证服务。

   • 已经提交的服务如果未进行服务部署或部署后已被下线，则可以删除服务。

步骤五：部署服务

您可以将验证通过的服务部署到节点上，部署成功即可发起服务调用，完成模型投产。

1. 在 服务集成 页面，单击指定服务名称，再单击指定服务版本右侧的 部署。

2. 在 服务部署 页面，配置服务部署信息。

   参数	描述
   服务名称	选择待部署服务的名称。
   版本名称	选择待部署服务的版本。
   部署节点	选择作为主动方发起调用的节点，双向调用时，需同时选择两个节点。

3. 单击 提交申请，开始部署服务。

步骤六：调整流量

当某节点上部署的同一个服务存在多个版本时，这些版本的调用接口都相同。线上调用服务时，系统会根据设置的分流比例，随机将线上流量分发给不同版本的服务，实现服务版本的灰度调整。

1. 在 服务集成 页面，单击指定服务名称右侧的 部署详情。

2. 在服务详情页面，单击 调整分流。

   调整分流的策略：当在某个节点中部署了一个服务的多个版本时，各版本的流量比例相加需为 100%。

3. 调整完成，单击 确定。