Contoh Didit MCP: Prompt & Percakapan Agen

​

Prompt cepat

• “Tampilkan 5 sesi terakhir yang dalam peninjauan di semua aplikasi saya.” → didit_session_search dengan status: "In Review", limit: 5
• “Berapa banyak orang yang mencoba verifikasi telepon tetapi meninggalkan proses dalam 15 hari terakhir?” → didit_analytics dengan last_n_days: 15 (satu panggilan; membaca corong fitur)
• “Temukan pelanggan dengan vendor_data user_8842 dan beri tahu saya aplikasi dan statusnya.” → didit_vendor_user_search
• “Berapa saldo kredit saya dan tingkat konversi bulan ini?” → didit_org_get_balance + didit_analytics

• “Buat alur kerja KYC dengan pemindaian ID + Deteksi Liveness dan beri saya tautan verifikasi.” → didit_workflow_create → didit_session_create
• “Buat alur kerja verifikasi ID yang hanya menerima paspor, lalu Deteksi Liveness dengan swafoto.” → didit_workflow_create — cukup tulis documents_allowed: ["PASSPORT"]; MCP akan memperluasnya menjadi hanya paspor untuk setiap negara (lihat Lanjutan → konfigurasi fitur).
• “Alur kerja baru: pindai paspor; jika ID ditolak, tolak sesi; jika profesi yang dinyatakan ≈ ‘Software Engineer’ (≥60%), jalankan Deteksi Liveness; jika tidak, minta Bukti Alamat dalam bahasa Spanyol; lalu buat keputusan otomatis.” → didit_workflow_get_field_definitions → didit_workflow_validate_graph → didit_workflow_set_graph
• “Di alur kerja 26d33c04…, setelah verifikasi ID: jika ditolak, tolak sesi; jika profesi memiliki kemiripan ≥80% dengan ‘Software Engineer’, tambahkan langkah Document AI untuk bukti dana; lalu lanjutkan.” → didit_workflow_search → didit_workflow_get_graph → didit_workflow_edit_graph (perubahan kecil, disimpan sebagai draf yang dapat ditinjau)
• “Di negara-negara mana saya dapat menawarkan login BankID atau MitID sebagai ganti pemindaian dokumen?” → didit_workflow_get_id_verification_methods_catalog
• “Daftarkan tujuan webhook untuk pembaruan status di https://myapp.com/webhooks/didit.” → didit_webhook_create

• “Skrining AML pada dompet ini dan tambahkan ke daftar blokir jika cocok.” → didit_transaction_screen_wallet → didit_blocklist_add
• “Buka kasus untuk sesi … dan tugaskan ke saya.” → didit_case_create → didit_case_manage
• “Apakah Acme Ltd perusahaan terdaftar di Inggris, dan siapa saja pemegang sahamnya?” → didit_verify_kyb_search → didit_verify_kyb_select

​

1. Siapkan verifikasi

Anda: “Siapkan verifikasi identitas Didit untuk aplikasi saya dengan pemindaian ID dan liveness, dan beri saya tautan yang bisa saya coba.” Agen: Saya akan membuat alur kerjanya terlebih dahulu. (memanggil didit_workflow_create dengan workflow_label: "Standard KYC", features: [{ "feature": "OCR" }, { "feature": "LIVENESS" }]) — Dipublikasikan “Standard KYC”, workflow_id = 6f2c…. Sekarang sesi untuk mencobanya. (memanggil didit_session_create dengan workflow_id: "6f2c…", vendor_data: "test-user-1") — Ini tautan Anda: https://verify.didit.me/session/…. Buka di ponsel Anda untuk menjalankan alurnya. Di produksi, backend Anda membuat sesi dengan 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 tersebut adalah kunci API REST aplikasi Anda untuk backend; kunci ini terpisah dari cara Anda masuk ke MCP ini, yang menggunakan Log in with Didit. Apakah saya juga perlu mendaftarkan tujuan webhook? Anda: “Ya — endpoint saya adalah https://myapp.com/webhooks/didit.” Agen: (memanggil didit_webhook_create dengan label: "Production", url: "https://myapp.com/webhooks/didit", webhook_version: "v3", subscribed_events: ["status.updated"]) — Selesai. Rahasia penandatanganan disamarkan dalam data yang saya terima, jadi salin dari Webhook di konsol dan simpan sebagai DIDIT_WEBHOOK_SECRET. Verifikasi header X-Signature-V2 pada setiap pengiriman sebelum mempercayainya.

​

2. KYB: periksa perusahaan di registri

Anda: “Apakah Acme Trading Ltd perusahaan Inggris yang sah? Nomor registrasinya 12345678.” Agen: (memanggil didit_verify_kyb_search dengan country_code: "GB", name: "Acme Trading Ltd", registration_number: "12345678") — Ada satu kandidat: ACME TRADING LTD, didirikan 2019, status aktif, kantor terdaftar di Manchester. Apakah Anda ingin catatan lengkap beserta pengurus dan pemegang saham? Anda: “Ya, dan beri tahu saya siapa pemilik manfaatnya.” Agen: (memanggil didit_verify_kyb_select dengan kyb_response_id kandidat) — Catatan lengkap berhasil diambil: dua direktur, dan satu orang dengan kendali signifikan yang memegang 75%+ saham dan hak suara. Catatan ini mencakup riwayat pengajuan dan alamat terdaftar. Ini adalah pencarian registri yang dikenai biaya (dua panggilan yang menggunakan kredit). Jika Anda ingin ini berjalan otomatis untuk setiap pelanggan bisnis, saya dapat menambahkan KYB_REGISTRY ke alur kerja KYB dengan didit_workflow_create; didit_workflow_get_kyb_registry_catalog memberi tahu kami tingkat data apa saja yang dijual registri Inggris.

​

3. Mengerjakan antrean peninjauan

Anda: “Apa yang menunggu peninjauan saya, dan apa masalah di setiap sesi?” Agen: (memanggil didit_session_search dengan status: "In Review", limit: 10) Empat sesi di dua aplikasi sedang dalam peninjauan. Membaca keputusan untuk setiap sesi. (memanggil didit_session_get_decision untuk setiap session_id)

Sesi	Aplikasi	Alasan berhenti
a1f3…	Onboarding	Skor kecocokan wajah 71 (ambang batas 80), deteksi liveness berhasil
b7c2…	Onboarding	Dokumen kedaluwarsa 2 bulan lalu
c904…	Marketplace	AML: satu kecocokan PEP, kecocokan nama 92%, tanggal lahir berbeda
d215…	Marketplace	Bukti alamat berusia lebih dari 90 hari

Anda: “Setujui a1f3, saya sudah melihat swafotonya dan itu orang yang sama. Tolak b7c2, dokumennya kedaluwarsa.” Agen: (memanggil didit_session_update_status dengan session_id: "a1f3…", new_status: "Approved", lalu dengan session_id: "b7c2…", new_status: "Declined", comment: "Expired document") Keduanya sudah diperbarui. (memanggil didit_session_add_review pada a1f3… dengan catatan “Peninjauan swafoto manual: orang yang sama”) Catatan peninjauan sudah ditambahkan agar log audit mencatat alasan skor ditimpa. Dua kasus AML dan bukti alamat masih terbuka. Beri tahu saya jika ingin membuka kasus untuk hit PEP dengan didit_case_create.

​

4. Uji balik aturan transaksi sebelum diaktifkan

Anda: “Saya ingin menandai siapa pun yang melakukan lebih dari 3 transfer di atas $1,000 dalam satu jam. Seberapa banyak positif palsu yang akan dihasilkan?” Agen: (memanggil didit_transaction_rule_backtest dengan conditions pada amount > 1000, aggregation berupa count ≥ 3 dalam jendela 1 jam, period_days: 90) Selama 90 hari terakhir, aturan ini akan terpicu pada 14 transaksi dari 6 subjek. 2 dari subjek tersebut sudah ditandai. Mau saya buat dalam mode TEST agar hanya mencatat kecocokan tanpa menjalankan tindakan apa pun? Anda: “Ya, mode TEST.” Agen: (memanggil didit_transaction_rule_create dengan title: "Velocity: 3+ transfers over $1,000 per hour", category: "aml_ctf", mode: "TEST", conditions dan aggregation yang sama, serta daftar actions yang menandai subjek) Sudah dibuat. Pantau dengan didit_transaction_rule_get setelah beberapa hari. Jika sudah puas, didit_transaction_rule_update akan mengubah mode menjadi ACTIVE. didit_transaction_rule_library_list juga memuat aturan kecepatan transaksi bawaan Didit jika Anda ingin memasang salah satunya.

​

Hasil sesi bersifat asinkron

1. Webhook status.updated (direkomendasikan), atau
2. didit_session_get_decision (polling, sebagai cadangan).

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

​

Gabungkan dengan integrasi satu prompt