sumsub-create-kyt-rules

用途

该技能用于配置 Sumsub 的完整 KYT（交易监控）栈，包括三部分：

规则（Rules）：将用户意图翻译为 KytTxnRule 载荷并逐条 POST。支持创建新规则和修改现有规则（通过发布新修订）。
标签与申请人评分（Tags & applicant scoring）：创建和配置标签（具名风险标记），以及将标签权重映射为申请人综合风险分数的评估配置。
风险等级（Risk levels）：配置将数字风险分数转换为可读标签（如 Low / Med / High）的阈值。

三者构成单一流水线：规则触发 → 应用标签 → 标签累积加权分数 → 分数映射为风险等级。

该技能覆盖以下端点：

GET /resources/api/agent/tm/rules/-/installed — 列出已有规则，支持 ?limit=<n> 和 ?offset=<n>，需要 seeKytRules 权限。
POST /resources/api/agent/tm/rules — 创建新规则或新修订。创建时省略 id 和 name；修订时包含已有 name slug 和 "id": null。需要 manageKytRules 权限。
GET /resources/api/agent/tm/rules/-/bundle/{bundleName}/{category} — 按名称和安装状态列出 bundle 中的规则，category 可为 installed、available、archived。
GET /resources/api/agent/tm/rules/{id} — 按 id 读取单条规则。
GET /resources/api/agent/tm/settings/tags — 列出所有 KYT 标签及其评估配置和关联规则。
POST /resources/api/agent/tm/settings/tag — 创建或更新 KYT 标签。
GET /resources/api/agent/tm/settings/applicantAssessment — 获取申请人评估评分配置。
PATCH /resources/api/agent/tm/settings/applicantAssessment — 替换申请人评估评分配置。
GET /resources/api/agent/tm/settings/riskLevel — 获取风险等级阈值。
PATCH /resources/api/agent/tm/settings/riskLevel — 替换风险等级阈值。
GET /resources/api/agent/tm/clientLists/{listName} — 按名称获取客户名单。
POST /resources/api/agent/tm/clientLists/{listName} — 创建客户名单（幂等）。

认证：使用 App Token + secret，仅限沙箱令牌。若用户提供生产令牌，必须拒绝并要求其在 https://cockpit.sumsub.com/checkus/home?sbx=true 生成沙箱令牌对。辅助脚本会拒绝不以 sbx: 开头的令牌。

环境变量：SUMSUB_APP_TOKEN（沙箱 App Token）、SUMSUB_SECRET_KEY（配对密钥）、SUMSUB_BASE（可选，默认 https://api.sumsub.com）。

租户权限（Entitlements）：权限按交易类型分别授权，而非全局。各类型需要的 key：

finance：KYT
travelRule：TRAVEL_RULE
kyc：TM_INDIVIDUAL_APPLICANT_SCORING · TM_COMPANY_APPLICANT_SCORING · KYT_ANTI_FRAUD · KYT · DEVICE_INTELLIGENCE
userPlatformEvent：KYT_ANTI_FRAUD · KYT
scheduledEvent：TM_SCHEDULED_EVENTS · KYT

创建或修改规则前，需运行 bash scripts/check_permissions.sh。标签、申请人评估和风险等级无需权限。

交易类型（Transaction Types）：

finance → finance transactions（支付转账、存款、提现），需 conditionEl
travelRule → Travel Rule transactions，需 conditionEl
kyc → Verification session events（面向用户时切勿写 "kyc"），需 conditionEl
userPlatformEvent → User platform events（登录、密码重置、2FA 事件），需 conditionEl
scheduledEvent → Scheduled events（定期申请人复查），不使用 conditionEl，改用 noEventTrigger，且必须单独出现在 types 中

创建与修改：创建模式仅需 title 和 types（至少 1 个值），切勿发送 id 或 name。修改模式需包含 "name": "<existing-slug>" 和 "id": null（注意不能用空字符串），并沿用未变更字段。

testMode 默认：每条新规则以 dryRun: true 启动，其结果出现在 dryScore 中但不影响真实分数或动作。需在仪表盘将其设为 "Active" 才生效。

适用于需要在 Sumsub 平台上搭建或调整 KYT 交易监控体系的合规与风控场景，例如：创建大额转账持有规则、配置申请人风险评分与等级标签、管理客户名单等。