> ## 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।

सामान्य कामों के कुछ पैटर्न, जिनसे दिखता है कि Didit MCP किन कामों में अच्छा है। सादी भाषा में बताएँ, एजेंट खुद टूल चुनता है। नीचे बताया गया हर टूल [टूल संदर्भ](https://docs.didit.me/hi/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`

**कॉन्फ़िगरेशन**

* *"ID स्कैन और लाइवनेस के साथ KYC वर्कफ़्लो बनाएँ और मुझे एक सत्यापन लिंक दें।"* → `didit_workflow_create` → `didit_session_create`
* *"ऐसा पहचान सत्यापन वर्कफ़्लो बनाएँ जो केवल पासपोर्ट स्वीकार करे, और उसके बाद सेल्फ़ी लाइवनेस जाँच हो।"* → `didit_workflow_create` — बस `documents_allowed: ["PASSPORT"]` लिखें; MCP इसे हर देश के लिए केवल-पासपोर्ट सेटिंग में बदल देता है (देखें [उन्नत → सुविधा कॉन्फ़िगरेशन](https://docs.didit.me/hi/integration/mcp/advanced.md#सुविधा-कॉन्फ़िगरेशन-और-allow-lists))।
* *"नया वर्कफ़्लो: पासपोर्ट स्कैन करें; अगर ID अस्वीकृत हो, तो सत्र अस्वीकार करें; अगर बताया गया पेशा ≈ 'Software Engineer' (≥60%) है, तो लाइवनेस जाँच चलाएँ; अन्यथा स्पेनिश में पते का प्रमाण माँगें; फिर स्वतः निर्णय लें।"* → `didit_workflow_get_field_definitions` → `didit_workflow_validate_graph` → `didit_workflow_set_graph`
* *"वर्कफ़्लो `26d33c04…` में, ID सत्यापन के बाद: अगर यह अस्वीकृत हो, तो सत्र अस्वीकार करें; अगर पेशा '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. सत्यापन शुरू करें

> **आप:** "मेरे ऐप के लिए ID स्कैन और लाइवनेस के साथ Didit पहचान सत्यापन सेट करें, और मुझे एक लिंक दें जिसे मैं आज़मा सकूँ।"
>
> **एजेंट:** पहले मैं वर्कफ़्लो बनाऊँगा। *(`workflow_label: "Standard KYC"`, `features: [{ "feature": "OCR" }, { "feature": "LIVENESS" }]` के साथ `didit_workflow_create` कॉल करता है)* — प्रकाशित **"Standard KYC"**, `workflow_id = 6f2c…`। अब इसे आज़माने के लिए एक सत्र। *(`workflow_id: "6f2c…"`, `vendor_data: "test-user-1"` के साथ `didit_session_create` कॉल करता है)* — यह रहा आपका लिंक: `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` है।"
>
> **एजेंट:** *(`label: "Production"`, `url: "https://myapp.com/webhooks/didit"`, `webhook_version: "v3"`, `subscribed_events: ["status.updated"]` के साथ `didit_webhook_create` कॉल करता है)* — हो गया। मुझे वापस मिलने वाले रिस्पॉन्स में हस्ताक्षर सीक्रेट को छिपा दिया जाता है, इसलिए उसे कंसोल में **Webhooks** से कॉपी करें और `DIDIT_WEBHOOK_SECRET` के रूप में सहेजें। हर डिलीवरी पर भरोसा करने से पहले `X-Signature-V2` हेडर सत्यापित करें।

***

## 2. KYB: कंपनी रजिस्ट्री में कंपनी जाँचें

> **आप:** "क्या Acme Trading Ltd एक असली यूके कंपनी है? मेरी पंजीकरण संख्या 12345678 है।"
>
> **एजेंट:** *(`country_code: "GB"`, `name: "Acme Trading Ltd"`, `registration_number: "12345678"` के साथ `didit_verify_kyb_search` कॉल करता है)* — एक उम्मीदवार मिला: **ACME TRADING LTD**, 2019 में निगमित, स्थिति *सक्रिय*, पंजीकृत कार्यालय मैनचेस्टर में। क्या आप अधिकारियों और शेयरधारकों के साथ पूरा रिकॉर्ड चाहेंगे?
>
> **आप:** "हाँ, और बताइए कि वास्तविक स्वामी कौन हैं।"
>
> **एजेंट:** *(उम्मीदवार के `kyb_response_id` के साथ `didit_verify_kyb_select` कॉल करता है)* — पूरा रिकॉर्ड मिल गया: दो निदेशक, और एक व्यक्ति जिसका महत्वपूर्ण नियंत्रण है और जिसके पास 75%+ शेयर और मतदान अधिकार हैं। रिकॉर्ड में फ़ाइलिंग इतिहास और पंजीकृत पता भी शामिल है। यह एक शुल्क-योग्य रजिस्ट्री लुकअप था (क्रेडिट खर्च करने वाली दो कॉल)। अगर आप चाहते हैं कि यह हर व्यवसाय ग्राहक के लिए अपने आप हो, तो मैं `didit_workflow_create` से KYB वर्कफ़्लो में `KYB_REGISTRY` जोड़ सकता हूँ; `didit_workflow_get_kyb_registry_catalog` बताता है कि यूके रजिस्ट्री कौन-से डेटा स्तर बेचती है।

***

## 3. समीक्षा कतार पर काम करें

> **आप:** "मेरी समीक्षा के लिए क्या इंतज़ार कर रहा है, और हर एक में क्या गड़बड़ है?"
>
> **एजेंट:** *(`didit_session_search` को `status: "In Review"`, `limit: 10` के साथ कॉल करता है)* दो ऐप में चार सत्र समीक्षा में हैं। हर निर्णय पढ़ रहा हूँ। *(हर `session_id` के लिए `didit_session_get_decision` कॉल करता है)*
>
> | सत्र | ऐप | रुकने का कारण |
> | - | - | - |
> | `a1f3…` | ऑनबोर्डिंग | चेहरा मिलान स्कोर 71 (थ्रेशोल्ड 80), लाइवनेस पास हुई |
> | `b7c2…` | ऑनबोर्डिंग | दस्तावेज़ 2 महीने पहले समय-सीमा समाप्त हो गया |
> | `c904…` | मार्केटप्लेस | AML: एक PEP हिट, नाम मिलान 92%, जन्म तिथि अलग है |
> | `d215…` | मार्केटप्लेस | पते का प्रमाण 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 और पते के प्रमाण वाले दो मामले अभी खुले हैं; कहें तो मैं PEP हिट के लिए `didit_case_create` से केस खोल दूँगा।

***

## 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/hi/reference/data-models.md) देखें, और सत्यापन व पुनः प्रयास के नियमों के लिए [उन्नत → webhook](https://docs.didit.me/hi/integration/mcp/advanced.md#webhook-को-संभालना) देखें।

***

## इसे एक-प्रॉम्प्ट इंटीग्रेशन के साथ जोड़ें

MCP, Didit *चलाने* के लिए बढ़िया है। किसी एजेंट से पूरा इंटीग्रेशन *लिखवाने* के लिए (बैकएंड रूट + फ़्रंटएंड SDK + webhook हैंडलर + DB स्कीमा), उसे [इंटीग्रेशन प्रॉम्प्ट](https://docs.didit.me/hi/integration/integration-prompt.md) दें। वह सात चरणों से गुजरता है और वर्कफ़्लो, सत्र और webhook को लाइव बनाने के लिए MCP टूल कॉल करता है।

***

> [card] [टूल संदर्भ](https://docs.didit.me/hi/integration/mcp/tools.md)
>
> एजेंट जो कुछ कॉल कर सकता है, सब कुछ।

> [card] [उन्नत और समस्या निवारण](https://docs.didit.me/hi/integration/mcp/advanced.md)
>
> भूमिकाएँ, क्रॉस-ऐप व्यवहार, webhook, सेल्फ़-होस्टिंग।


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