> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Didit MCP 的示例提示词与智能体对话：KYC 工作流与会话、KYB 企业注册表搜索、审核队列、规则回测、Webhook 配置。

A few patterns that show what the Didit MCP is good at。下面列出 Didit MCP 擅长的几类场景。用自然语言描述即可，由智能体选择工具。下文提到的每个工具都能在[工具参考](https://docs.didit.me/zh/integration/mcp/tools.md)中找到。

***

## 快速提示词

**运营与监控（跨应用）**

* *"显示我所有应用中最近 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 会为每个国家/地区将其展开为仅限护照（参见[高级 → 功能配置](https://docs.didit.me/zh/integration/mcp/advanced.md#功能配置与允许列表)）。
* *"新建工作流：扫描护照；如果证件被拒绝，则拒绝该会话；如果声明的职业 ≈ '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 创建会话：
>
> ```bash theme={null}
> 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 预设的频率规则。

***

## 会话结果是异步的

`didit_session_create` 返回 `session_id`、`session_token` 和托管 `url`，但此时验证尚未发生。用户打开 `url` 并完成流程。最终决策通过以下方式获取：

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

两者的结构相同：**始终为数组（而非单个对象）**，每个条目都有一个 `node_id`：

```json theme={null}
{
  "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": []
}
```

切勿读取单数形式的 V2 键（`id_verification`、`liveness`）。这些键仅在某个目标被明确固定为 `webhook_version: "V2"` 时才会下发。有关各功能的字段参考，请参阅[数据模型](https://docs.didit.me/zh/reference/data-models.md)；有关验证和重试规则，请参阅[高级 → Webhook](https://docs.didit.me/zh/integration/mcp/advanced.md#处理-webhook)。

***

## 搭配单提示词集成使用

MCP 非常适合*运行* Didit。若要让代理*编写*完整集成（后端路由、前端 SDK、Webhook 处理程序和数据库架构），请将[集成提示词](https://docs.didit.me/zh/integration/integration-prompt.md)交给它。它会按七个步骤执行，并调用 MCP 工具实时创建工作流、会话和 Webhook。

***

> [card] [工具参考](https://docs.didit.me/zh/integration/mcp/tools.md)
>
> 代理可以调用的所有工具。

> [card] [高级与故障排查](https://docs.didit.me/zh/integration/mcp/advanced.md)
>
> 角色、跨应用行为、Webhook、自托管。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.