Примеры 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
• “Зарегистрируй адрес назначения 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:

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 по частоте транзакций, если хотите установить одно из них.

​

Результаты сессии приходят асинхронно

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": []
}

​

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