可接入的数据源

一笔申请进入决策流,熟客却又被当成陌生人处理,因为规则读不到核心银行系统里的客户记录。负责该系统的团队说,这些记录已经能通过网关上的 API 获取。另一家服务商还能提供设备信息,但 API 密钥还在团队的密码管理器里。您的集成工单排在平台团队的待办事项中,对方还在询问规则需要读取哪些字段。所需信息就在附近,决策却用不上多少。

什么是数据源

数据源是对公共互联网中的 REST API 或 SOAP Web 服务发起调用。您将调用配置为数据源,整个决策流都能读取返回结果,无论接口属于服务商,还是贵公司运行的服务。

请求方式适用场景
GET简单查询,参数放在 URL 中
POST较大的请求,可使用表单字段、JSON 或原始请求体模板
PUT向其他系统发送决策结果
SOAP使用 WSDL 和方法名的旧式 Web 服务

参数可以设为固定值,也可以从数据对象中映射。选择「Flow」后,决策流步骤中会显示该参数,供您进行映射。URL 中的占位符会使用同名参数的值。您还可以随请求发送请求头,包括授权密钥。

POST 请求可以发送表单字段、JSON 或原始请求体模板。在模板中,您可以按 API 要求编写格式,并用占位符填入参数值。API 可以返回 JSON 或 XML。引擎会将 XML 响应转换为 JSON 结构,再添加到数据对象中。

您可以为每个数据源设置超时时间,最长为 15 秒。如果 API 未能及时响应,决策流会继续运行,规则会像读取其他值一样处理这次失败调用。

API 返回结果的去向

引擎会将完整响应写入数据对象,并按 $.output、步骤名和数据源名的层级保存。规则、决策表、评分卡或函数可以按字段路径读取返回值。

在演示案件中,名为 ip_check 的数据源位于名为 checks 的节点中,并返回 AbuseIPDB 响应,因此规则读取的路径是 $.output.checks.ip_check.abuseConfidenceScore。

响应旁还会记录调用信息,包括 __http_code、__attempts 和 __cached。调用失败时,输出中还会包含 __error 和 __error_details。

配置调用认证

选择接口要求的认证方式。数据源页面提供「HTTP Authentication」,用于用户名和密码,也提供「OAuth2 Authentication」,用于令牌端点、客户端 ID 和密钥。OAuth2 支持客户端凭证授权或密码授权,也可以选填 scope、audience 或 realm。

引擎会缓存 OAuth2 令牌,并在需要时重新请求。如果 API 返回 401 拒绝令牌,引擎会丢弃该令牌,并在本次调用中重新请求一次。API 密钥可以放在请求头或参数中。

密钥、令牌或密码字段可以引用凭证库中的凭证,配置中只保留类似 secret:openai_main 的引用。凭证值不会进入导出文件或发布版本。

接入自有服务

决策流调用贵公司的服务,方式与调用服务商接口相同。放贷机构或保险公司可以在决策中调用以下服务:

  • 核心系统中的客户记录,包括已有产品、逾期情况和在贷月数,让服务十年的客户不再被当成陌生人。
  • 余额或风险敞口服务,查询各产品当前余额,供新额度上限使用。
  • 定价或产品服务,集中保存利率表或产品目录。
  • CRM 或案件系统,查询该客户是否已有申请、投诉或欺诈案件在处理中。
  • 自有文档或 KYC 服务,查询身份文件是否已核验及核验时间。
  • 通过 PUT 将决策结果发送到其他系统。

Decisimo 调用公共互联网中的地址,因此需要通过 API 网关为服务提供可从公共互联网访问的地址,并使用密钥或 OAuth2 保护。调用前会拒绝环回地址、10/8、172.16/12 和 192.168/16 私有网段地址,以及链路本地地址。被拒绝的地址会返回 __error_details.type,值为 ssrf_blocked。系统不会跟随重定向,请直接配置最终 URL。

较旧的核心系统通常使用 SOAP。配置 WSDL URL 和方法名后,即可按路径映射嵌套参数。SOAP 版本由 WSDL 绑定决定,响应会像 REST 响应一样转换为 JSON。

将这些审核规则纳入决策流

制定信贷、反欺诈或催收规则,并用于实际决策。

多次调用、失败和重试

一个环节可以包含多个数据源。决策引擎会同时调用它们,该环节要等最慢的响应返回。把成本较低的检查放在同一个环节,申请人只需等其中最慢的检查完成。

超时、连接失败、端点被拦截或 HTTP 错误都不会中止整个决策流。输出会记录错误及原因,决策流随后继续运行。规则可以将申请转到备用分支或人工队列。有关备用处理规则,请参阅服务商调用失败时仍能运行的决策策略。

只有在再次调用不会产生额外费用或重复记录时,才使用「Retry this call if it fails」。启用重试后,遇到连接失败,或收到 HTTP 408、425、429、502、503 或 504 响应,引擎会再尝试一次。两次尝试间隔为 200 毫秒至 2 秒,且只会在步骤剩余时间允许时重试。__attempts 会记录尝试次数。

您还可以将数据源的响应按决策步骤缓存到自有 PostgreSQL 数据库中的 Data cache 目标。默认缓存期限为 30 天。匹配条件可以使用请求内容,也可以使用您选择的一组参数。凭证不参与匹配,错误响应不会保存。__cached 表示该步骤是否使用了已保存的响应。

用助手编写数据源配置

数据源页面上的“AI Assistant”按钮会打开聊天窗口,您可以描述 API,助手会提出配置方案。方案会显示在当前设置旁边,供您查看。“Apply Configuration”会填入表单,点击 Save 会保存数据源。

如果 API 需要密钥,「Credential needed」框可让您选择已有凭证,或将新凭证添加到凭证库。对话中只会传递凭证名称。构建决策流时,决策流助手也可以添加数据源任务。

选择「Run test」即可调用数据源并查看响应。

常见的数据服务

Fingerprint会返回访客 ID,以及设备是否疑似机器人。MaxMind minFraud会返回风险评分,以及邮箱是否为一次性邮箱。Trestle会返回邮箱是否有效,以及电话号码对应的线路类型。

在邮箱检查方面,Have I Been Pwned会返回某个邮箱地址涉及的泄露事件、发生日期和数据类型,Email Hippo则评估邮箱地址本身。在 IP 和设备检查方面,AbuseIPDB会返回 0 到 100 的滥用置信度评分。macaddress.io和WhatIsMyBrowser的指南也会以同样方式接入另外两种设备检查。

其他指南介绍了用于银行卡的BINLIST、用于查询公司信息的Companies House,以及用于查询地理位置和地址信息的Google Places。这些服务按检查内容归类在集成页面中。

除了调用数据源,决策流还可以调用 LLM 模型,并使用根据决策内容填充的提示词模板,还可选定输出格式。也可以把自有训练模型作为决策流节点。自有的拦截名单、放行名单和观察名单保存在您的数据库中,决策流运行时会检查这些名单。

常见问题

Decisimo 能否调用私有网络中的服务?

请通过 API 网关为服务提供可从公共互联网访问的地址。调用前会拒绝私有网络地址。

服务商响应缓慢时会怎样?

您可以设置最长 15 秒的超时时间。如果服务商未能及时响应,决策流会带着错误及原因继续运行,后续处理由规则决定。

谁负责与服务商签约?

您负责与服务商签订合同并持有密钥。Decisimo 不提供服务商的数据。

一个步骤能否调用两家服务商?

多个数据源会同时调用,步骤会等待最慢的一项返回。

将这些审核规则纳入决策流

制定信贷、反欺诈或催收规则,并用于实际决策。