Exemples del MCP de Didit: prompts i converses amb agents

​

Peticions ràpides

• “Mostra’m les 5 últimes sessions en revisió de totes les meves aplicacions.” → didit_session_search amb status: "In Review", limit: 5
• “Quantes persones van intentar la verificació de telèfon però van abandonar en els últims 15 dies?” → didit_analytics amb last_n_days: 15 (una sola crida; llegeix l’embut de funcionalitats)
• “Troba el client amb vendor_data user_8842 i digue’m de quina aplicació és i quin estat té.” → didit_vendor_user_search
• “Quin és el meu saldo de crèdits i la taxa de conversió d’aquest mes?” → didit_org_get_balance + didit_analytics

• “Crea un flux de treball KYC amb escaneig del document d’identitat i prova de vida, i dona’m un enllaç de verificació.” → didit_workflow_create → didit_session_create
• “Crea un flux de treball de verificació d’identitat que només accepti passaports, i després una prova de vida amb selfie.” → didit_workflow_create; digues només documents_allowed: ["PASSPORT"]. L’MCP ho amplia perquè només s’acceptin passaports de tots els països (consulta Avançat → configuracions de funcionalitats).
• “Flux de treball nou: escaneja un passaport; si el document d’identitat és rebutjat, rebutja la sessió; si la professió declarada és ≈ ‘Software Engineer’ (≥60%), fes una prova de vida; en cas contrari, demana un comprovant de domicili en espanyol; després decideix automàticament.” → didit_workflow_get_field_definitions → didit_workflow_validate_graph → didit_workflow_set_graph
• “Al flux de treball 26d33c04…, després de la verificació d’identitat: si es rebutja, rebutja la sessió; si la professió és ≥80% similar a ‘Software Engineer’, afegeix un pas de comprovant de fons amb Document AI; després continua.” → didit_workflow_search → didit_workflow_get_graph → didit_workflow_edit_graph (petites operacions, desades com a esborrany revisable)
• “En quins països puc oferir un inici de sessió amb BankID o MitID en lloc d’un escaneig del document?” → didit_workflow_get_id_verification_methods_catalog
• “Registra una destinació de webhook per a les actualitzacions d’estat a https://myapp.com/webhooks/didit.” → didit_webhook_create

• “Fes un cribratge AML d’aquesta cartera i afegeix-la a la llista de bloqueig si coincideix.” → didit_transaction_screen_wallet → didit_blocklist_add
• “Obre un cas per a la sessió … i assigna-me’l.” → didit_case_create → didit_case_manage
• “Acme Ltd és una empresa registrada al Regne Unit? I qui són els seus accionistes?” → didit_verify_kyb_search → didit_verify_kyb_select

​

1. Posar en marxa la verificació

Tu: “Configura la verificació d’identitat de Didit per a la meva aplicació amb escaneig del document d’identitat i prova de vida, i dona’m un enllaç per provar-la.” Agent: Primer crearé el flux de treball. (crida didit_workflow_create amb workflow_label: "Standard KYC", features: [{ "feature": "OCR" }, { "feature": "LIVENESS" }]) — Publicat “Standard KYC”, workflow_id = 6f2c…. Ara una sessió per provar-lo. (crida didit_session_create amb workflow_id: "6f2c…", vendor_data: "test-user-1") — Aquest és el teu enllaç: https://verify.didit.me/session/…. Obre’l al mòbil per executar el flux de treball. En producció, el teu backend crea sessions amb l’API REST:

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" }'

Aquest x-api-key és la clau d’API REST de la teva aplicació per al teu backend; és diferent de la manera com has iniciat sessió en aquest MCP, que usa Log in with Didit. Vols que registri també la destinació del webhook? Tu: “Sí; el meu endpoint és https://myapp.com/webhooks/didit.” Agent: (crida didit_webhook_create amb label: "Production", url: "https://myapp.com/webhooks/didit", webhook_version: "v3", subscribed_events: ["status.updated"]) — Fet. El secret de signatura està ocult en la resposta que rebo, així que copia’l des de Webhooks a la consola i guarda’l com a DIDIT_WEBHOOK_SECRET. Verifica la capçalera X-Signature-V2 de cada lliurament abans de confiar-hi.

​

2. KYB: comprovar una empresa al registre mercantil

Tu: “Acme Trading Ltd és una empresa real del Regne Unit? Tinc el número de registre 12345678.” Agent: (crida didit_verify_kyb_search amb country_code: "GB", name: "Acme Trading Ltd", registration_number: "12345678") — Hi ha un candidat: ACME TRADING LTD, constituïda el 2019, estat actiu, domicili social a Manchester. Vols el registre complet amb administradors i accionistes? Tu: “Sí, i digue’m qui són els titulars reals.” Agent: (crida didit_verify_kyb_select amb el kyb_response_id del candidat) — Registre complet recuperat: dos administradors i una persona amb control significatiu que té el 75% o més de les accions i dels drets de vot. El registre inclou l’historial de presentacions i el domicili social. Aquesta va ser una consulta de registre facturable (dues crides que consumeixen crèdits). Si vols que això passi automàticament per a cada client empresarial, puc afegir KYB_REGISTRY a un flux de treball KYB amb didit_workflow_create; didit_workflow_get_kyb_registry_catalog ens indica quins nivells de dades ven el registre mercantil del Regne Unit.

​

3. Gestiona la cua de revisió

Tu: “Què està pendent de la meva revisió i què falla en cadascun?” Agent: (crida didit_session_search amb status: "In Review", limit: 10) Hi ha quatre sessions en revisió en dues aplicacions. Llegeixo la decisió de cadascuna. (crida didit_session_get_decision per a cada session_id)

Sessió	Aplicació	Per què s’ha aturat
a1f3…	Alta	Puntuació de coincidència facial 71 (llindar 80), prova de vida superada
b7c2…	Alta	Document caducat fa 2 mesos
c904…	Marketplace	AML: una coincidència PEP, coincidència de nom del 92%, data de naixement diferent
d215…	Marketplace	Comprovant de domicili de més de 90 dies

Tu: “Aprova a1f3: he mirat la selfie i és la mateixa persona. Rebutja b7c2, document caducat.” Agent: (crida didit_session_update_status amb session_id: "a1f3…", new_status: "Approved", i després amb session_id: "b7c2…", new_status: "Declined", comment: "Expired document") Totes dues s’han actualitzat. (crida didit_session_add_review sobre a1f3… amb la nota “Manual selfie review: same person”) S’ha afegit una nota de revisió perquè el registre d’auditoria mostri per què s’ha sobreescrit la puntuació. Els dos casos d’AML i de comprovant de domicili continuen oberts; digues-m’ho i obriré un cas per a la coincidència PEP amb didit_case_create.

​

4. Prova retrospectiva d’una regla de transaccions abans de publicar-la

Tu: “Vull marcar qualsevol persona que faci més de 3 transferències de més de $1,000 en una hora. Quant de soroll generaria?” Agent: (crida didit_transaction_rule_backtest amb conditions sobre amount > 1000, una aggregation de recompte ≥ 3 en una finestra d’1 hora, period_days: 90) Durant els últims 90 dies aquesta regla s’hauria activat en 14 transaccions de 6 subjectes; 2 d’aquests subjectes ja estan marcats. Vols que la creï en mode TEST, perquè registri les coincidències sense executar cap acció? Tu: “Sí, mode TEST.” Agent: (crida didit_transaction_rule_create amb title: "Velocity: 3+ transfers over $1,000 per hour", category: "aml_ctf", mode: "TEST", els mateixos conditions i aggregation, i una llista actions que marca el subjecte) Creada. Revisa-la amb didit_transaction_rule_get d’aquí a uns dies; quan estiguis satisfet, didit_transaction_rule_update canvia mode a ACTIVE. didit_transaction_rule_library_list també té les regles de velocitat predefinides de Didit si prefereixes instal·lar-ne una.

​

Els resultats de la sessió són asíncrons

1. Un webhook status.updated (recomanat), o
2. didit_session_get_decision (sondeig, com a alternativa).

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

​

Combina-ho amb la integració de prompt únic