> ## 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. Phrase things in plain language, and the agent picks the tools. Every tool named below exists in the [справочник инструментов](https://docs.didit.me/ru/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/ru/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`
* *"Зарегистрируй адрес назначения webhook для обновлений статуса на `https://myapp.com/webhooks/didit`."* → `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, а для входа используется *Войти через 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. KYB: проверка компании в реестре

> **Вы:** "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%+ акций и прав голоса. В запись входят история подачи документов и зарегистрированный адрес. Это был платный запрос к реестру (два вызова, за которые списываются кредиты). Если вы хотите, чтобы такая проверка выполнялась автоматически для каждого бизнес-клиента, я могу добавить `KYB_REGISTRY` в KYB-сценарий через `didit_workflow_create`; `didit_workflow_get_kyb_registry_catalog` покажет, какие уровни данных продаёт реестр Великобритании.

***

## 3. Работа с очередью проверок

> **Вы:** «Что ждёт моей проверки и что не так с каждой из них?»
>
> **Агент:** *(вызывает `didit_session_search` с `status: "In Review"`, `limit: 10`)* — Четыре сессии в двух приложениях находятся на проверке. Читаю решение по каждой. *(вызывает `didit_session_get_decision` для каждого `session_id`)*
>
> | Сессия | Приложение | Причина остановки |
> | - | - | - |
> | `a1f3…` | Онбординг | Оценка сравнения лиц 71 (порог 80), проверка живости пройдена |
> | `b7c2…` | Онбординг | Документ истёк 2 месяца назад |
> | `c904…` | Marketplace | AML: одно совпадение с 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"`)* — Оба обновлены. *(вызывает `didit_session_add_review` для `a1f3…` с примечанием «Ручная проверка селфи: тот же человек»)* — Примечание к проверке добавлено, чтобы в журнале аудита было видно, почему оценка была переопределена. Два кейса по AML и подтверждению адреса всё ещё открыты; скажите, и я открою кейс по совпадению с PEP с помощью `didit_case_create`.

***

## 4. Бэктестирование правила транзакций перед запуском

> **Вы:** «Хочу помечать всех, кто делает больше 3 переводов на сумму свыше \$1,000 за час. Насколько это будет шумно?»
>
> **Агент:** *(вызывает `didit_transaction_rule_backtest` с `conditions` по `amount > 1000`, `aggregation` с количеством ≥ 3 за окно в 1 час, `period_days: 90`)* — За последние 90 дней это правило сработало бы на 14 транзакциях от 6 субъектов; 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/ru/reference/data-models.md), а правила проверки и повторных попыток для webhook — в разделе [Расширенные возможности → webhook](https://docs.didit.me/ru/integration/mcp/advanced.md#обработка-webhooks).

***

## Интеграция с помощью одного промпта

MCP отлично подходит для *работы* с Didit. Чтобы агент *написал* полную интеграцию (маршрут бэкенда + фронтенд-SDK + обработчик webhook + схему БД), передайте ему [Промпт для интеграции](https://docs.didit.me/ru/integration/integration-prompt.md): он пройдёт семь шагов и вызовет инструменты MCP, чтобы создать сценарий, сессию и webhook в рабочем режиме.

***

> [card] [Справочник инструментов](https://docs.didit.me/ru/integration/mcp/tools.md)
>
> Все, что может вызвать агент.

> [card] [Расширенные возможности и устранение неполадок](https://docs.didit.me/ru/integration/mcp/advanced.md)
>
> Роли, поведение между приложениями, webhook, самостоятельное развёртывание.


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