Didit MCP 示例：提示词与智能体对话

​

快速提示词

• “显示我所有应用中最近 5 个审核中的会话。” → didit_session_search，参数为 status: "In Review"，limit: 5
• “过去 15 天里，有多少人尝试了电话验证但中途流失？” → didit_analytics，参数为 last_n_days: 15（一次调用；读取功能漏斗）
• “查找 vendor_data 为 user_8842 的客户，并告诉我其所属应用和状态。” → didit_vendor_user_search
• “我的额度余额是多少，本月的转化率是多少？” → didit_org_get_balance + didit_analytics

• “创建一个 KYC 工作流，包含证件扫描和活体检测，并给我一个验证链接。” → didit_workflow_create → didit_session_create
• “创建一个身份证件验证工作流，只接受护照，然后进行自拍照活体检测。” → didit_workflow_create，只需说明 documents_allowed: ["PASSPORT"]；MCP 会为每个国家/地区将其展开为仅限护照（参见高级 → 功能配置）。
• “新建工作流：扫描护照；如果证件被拒绝，则拒绝该会话；如果声明的职业 ≈ ‘Software Engineer’（≥60%），则执行活体检测；否则要求以西班牙语提供地址证明；然后自动决策。” → didit_workflow_get_field_definitions → didit_workflow_validate_graph → didit_workflow_set_graph
• “在工作流 26d33c04… 中，身份证件验证之后：如果被拒绝，则拒绝该会话；如果职业与 ‘Software Engineer’ 的相似度 ≥80%，则添加一个资金证明的 Document AI 步骤；然后继续。” → didit_workflow_search → didit_workflow_get_graph → didit_workflow_edit_graph（小范围操作，保存为可审阅的草稿）
• “哪些国家/地区可以提供 BankID 或 MitID 登录，替代证件扫描？” → didit_workflow_get_id_verification_methods_catalog
• “为 https://myapp.com/webhooks/didit 注册一个 Webhook 目标，用于接收状态更新。” → didit_webhook_create

• “对该钱包进行 AML 筛查，如果命中则将其加入黑名单。” → didit_transaction_screen_wallet → didit_blocklist_add
• “为会话 … 创建案件，并分配给我。” → didit_case_create → didit_case_manage
• “Acme Ltd 是否是英国注册公司？它的股东是谁？” → didit_verify_kyb_search → didit_verify_kyb_select

​

1. 搭建身份验证

您： “为我的应用设置 Didit 身份验证，包含证件扫描和活体检测，并给我一个可以试用的链接。” 智能体： 我先创建工作流。（调用 didit_workflow_create，参数：workflow_label: "Standard KYC"，features: [{ "feature": "OCR" }, { "feature": "LIVENESS" }]），已发布 “Standard KYC”，workflow_id = 6f2c…。现在创建一个会话供您试用。（调用 didit_session_create，参数：workflow_id: "6f2c…"，vendor_data: "test-user-1"），这是您的链接：https://verify.didit.me/session/…。请在手机上打开它以运行流程。在生产环境中，您的后端通过 REST API 创建会话：

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "workflow_id": "6f2c...", "vendor_data": "internal-user-id", "callback": "https://myapp.com/done" }'

这里的 x-api-key 是您应用的 REST API 密钥，用于您的后端；它与您登录此 MCP 的方式不同，后者使用 Log in with Didit。需要我也注册 Webhook 目标吗？ 您： “是的，我的 endpoint 是 https://myapp.com/webhooks/didit。” 智能体： （调用 didit_webhook_create，参数：label: "Production"，url: "https://myapp.com/webhooks/didit"，webhook_version: "v3"，subscribed_events: ["status.updated"]），已完成。返回的签名密钥已被隐藏，因此请从控制台的 Webhook 中复制，并将其保存为 DIDIT_WEBHOOK_SECRET。在信任每次投递之前，请验证其 X-Signature-V2 请求头。

​

2. 在公司登记中核查企业

您： “Acme Trading Ltd 是真实存在的英国公司吗？我的注册号是 12345678。” 智能体： （调用 didit_verify_kyb_search，参数：country_code: "GB"，name: "Acme Trading Ltd"，registration_number: "12345678"），找到一个候选企业：ACME TRADING LTD，成立于 2019 年，状态为“存续”，注册办公地址位于曼彻斯特。需要包含高管和股东的完整记录吗？ 您： “是的，并告诉我谁是实际受益人。” 智能体： （调用 didit_verify_kyb_select，使用候选企业的 kyb_response_id），已获取完整记录：两名董事，一名具有重大控制权的人员持有 75%+ 的股份和表决权。记录包括申报历史和注册地址。这是一次可计费的公司登记查询（两次消耗额度的调用）。如果您希望为每位企业客户自动执行此操作，我可以使用 didit_workflow_create 将 KYB_REGISTRY 添加到 KYB 工作流中；didit_workflow_get_kyb_registry_catalog 会告诉我们英国公司登记提供哪些数据层级。

​

3. 处理审核队列

您： “哪些内容正在等待我审核？每一项有什么问题？” 代理： （调用 didit_session_search，参数为 status: "In Review"、limit: 10） ——两个应用中共有四个会话处于审核中。正在读取每项决策。（对每个 session_id 调用 didit_session_get_decision）

会话	应用	停止原因
a1f3…	Onboarding	人脸比对分数 71（阈值 80），活体检测通过
b7c2…	Onboarding	证件已于 2 个月前过期
c904…	Marketplace	AML：1 条 PEP 命中，姓名匹配度 92%，出生日期不一致
d215…	Marketplace	地址证明已超过 90 天

您： “通过 a1f3，我已看过自拍照，是同一个人。拒绝 b7c2，证件已过期。” 代理： （调用 didit_session_update_status，参数为 session_id: "a1f3…"、new_status: "Approved"，然后是 session_id: "b7c2…"、new_status: "Declined"、comment: "Expired document"） ——两者均已更新。（对 a1f3… 调用 didit_session_add_review，备注为 “Manual selfie review: same person”） ——已添加审核备注，以便审计日志显示覆盖分数的原因。AML 和地址证明这两个案件仍处于开放状态。您说一声，我就用 didit_case_create 为 PEP 命中创建一个案件。

​

4. 上线前回测交易规则

您： “我想标记一小时内每笔超过 $1,000 的转账超过 3 笔的用户。这会产生多少噪声？” 代理： （调用 didit_transaction_rule_backtest，其中 conditions 为 amount > 1000，aggregation 为 1 小时窗口内 count ≥ 3，period_days: 90） ——过去 90 天内，该规则会在 6 个主体的 14 笔交易上触发；其中 2 个主体已被标记。要我以 TEST 模式创建它吗？这样它只记录命中结果，不执行任何操作。 您： “好，用 TEST 模式。” 代理： （调用 didit_transaction_rule_create，参数为 title: "Velocity: 3+ transfers over $1,000 per hour"、category: "aml_ctf"、mode: "TEST"，以及相同的 conditions 和 aggregation，并包含标记该主体操作的 actions 列表） ——已创建。几天后用 didit_transaction_rule_get 查看其表现；确认无误后，用 didit_transaction_rule_update 将 mode 切换为 ACTIVE。如果您更想直接安装现成规则，didit_transaction_rule_library_list 也提供 Didit 预设的频率规则。

​

会话结果是异步的

1. status.updated Webhook（推荐），或
2. didit_session_get_decision（轮询，作为备用方式）。

{
  "session_id": "uuid",
  "status": "Approved",
  "session_kind": "user",
  "id_verifications":  [ { "node_id": "first_id", "status": "Approved", "first_name": "Jane" } ],
  "liveness_checks":   [ { "node_id": "first_liveness", "status": "Approved", "score": 95.4 } ],
  "face_matches":      [ { "node_id": "first_face_match", "status": "Approved", "score": 96.1 } ],
  "aml_screenings":    [ { "node_id": "first_aml", "status": "Approved", "total_hits": 0, "hits": [] } ],
  "reviews": []
}

​

搭配单提示词集成使用