التحقق من هوية المستخدم باستخدام كلود: دليل عملي

النقاط الرئيسية

• هذا دليل تشغيلي: الكلمات الدقيقة التي يجب كتابتها في كلود، ما يمر به مقدم الطلب، كيفية قراءة الإجابة، وماذا تفعل عندما تحتاج الجلسة إلى مراجعة.
• يتيح موصل بروتوكول سياق النموذج (MCP) الخاص بشركة Didit للمشغل المسجل الدخول استخدام سير العمل والأذونات الحالية من الدردشة دون كتابة أي كود.
• يتحكم سير العمل في فحوصات اعرف عميلك (KYC) التي يتم تشغيلها. إدراج سير العمل يجد الخيارات؛ قراءة سير العمل المحدد يكشف عن تكوينه.
• يكمل مقدم الطلب الفحوصات المكونة على صفحة مستضافة من Didit. يسترد كلود ويوضح نتيجة Didit؛ لا يقوم بفحص وثيقة الشخص أو وجهه بنفسه.
• قيد المراجعة هو تسليم للحكم البشري، وليس كلمة أخرى لـ «مرفوض». اطلب من كلود فصل الأدلة المعادة عن المعلومات المفقودة قبل أن يغير أي شخص الحالة.

لا تحتاج إلى معرفة مخطط واجهة برمجة التطبيقات (API) لمساعدة مقدم طلب واحد في التحقق من الهوية. تحتاج إلى حساب Didit، وسير عمل تحقق معتمد، وموصل Didit ممكّن في كلود، وسلطة بموجب سياسة المراجعة الخاصة بمؤسستك. يمكن أن يحدث الباقي بلغة عادية.

يتعمد هذا الدليل أن يكون حول الشخص الذي يدير المحادثة. لا يكرر آليات إنشاء الرابط والاستعلام التي تم تناولها بالفعل في MCP لـ KYC ودليل خادم KYC MCP. احتفظ بهذه المراجع مفتوحة عندما تحتاج إلى تفاصيل دورة الحياة أو التكامل. استخدم هذه الصفحة عندما يكون السؤال العملي هو: "ماذا يجب أن أكتب، وماذا يجب أن أخبر مقدم الطلب، وماذا أفعل بالإجابة؟"

قبل مقدم الطلب: إنشاء مساحة العمل الصحيحة

أضف موصل Didit إلى كلود وأكمل تسجيل الدخول إلى Didit. تستخدم نقطة النهاية المستضافة OAuth (الترخيص المفتوح) 2.1 مع PKCE (مفتاح إثبات لتبادل الكود)، وليس مفتاح API. يعمل كلود بدور المستخدم المسجل الدخول في Didit، لذلك يجب أن يكون لدى المشغل بالفعل إذن لأي إجراء يطلبه.

ابدأ كل محادثة تشغيلية جديدة بجعل النطاق مرئيًا:

استخدم Didit لمساعدتي في التحقق من مقدم طلب واحد. أولاً، استدع didit_context_get. أخبرني أي منظمة وتطبيق تم تحديدهما. لا تنشئ أو تغير أي شيء بعد.

هذا يكتشف أسهل خطأ تشغيلي: العمل في التطبيق الخطأ عندما يمكن لشخص واحد الوصول إلى عدة تطبيقات. إذا أظهر كلود أكثر من خيار واحد، قم بتسمية المنظمة والتطبيق الذي تنوي استخدامه قبل المتابعة.

اختر سير عمل دون تخمين فحوصاته

يسرد didit_workflow_list سير العمل المتاحة. لا يعيد الرسم البياني الكامل لسير العمل أو التكوين. استخدمه للعثور على اسم سير العمل المعتمد وworkflow_id، ثم استرداد سير العمل المحدد بشكل صريح.

اسرد سير عمل التحقق في التطبيق المحدد باستخدام didit_workflow_list. أظهر فقط اسم كل سير عمل، و workflow_id، وحالته. لا تصف فحوصاته بعد.

بعد تحديد واحد، اطلب التكوين الفعلي:

استرد سير العمل WORKFLOW_UUID باستخدام didit_workflow_get. إذا كانت خطواته أو فروعه تتطلب تفاصيل الرسم البياني، فاستدع أيضًا didit_workflow_get_graph مع include_config: false. ثم اشرح، باللغة الإنجليزية العادية، ما يجب على مقدم الطلب فعله. افصل الخطوات المرئية للمقدم عن الفحوصات التي تعمل في الخلفية. لا تنشئ جلسة.

استخدم didit_workflow_get للحصول على التكوين الكامل لسير العمل المحدد. استخدم didit_workflow_get_graph عندما تحتاج إلى العقد، الفروع، الشروط، أو خطوات معالجة المستندات؛ تكوينه الملخص الافتراضي يكفي لشرح المشغل. يمنع هذا النمط المكون من خطوتين كلود من استنتاج حزمة فقط من تسمية سير العمل.

اطلب رابطًا لمقدم طلب واحد

بمجرد تأكيد مساحة العمل وسير العمل، يمكن أن تظل تعليمات المشغل قصيرة:

أنشئ جلسة واحدة باستخدام didit_session_create باستخدام workflow_id WORKFLOW_UUID وبيانات البائع customer-8421. أعد session_id و url. لا ترسل الرابط أو تغير أي سجل آخر.

المدخل الوحيد المطلوب لـ didit_session_create هو workflow_id؛ vendor_data هو مرجع عميل اختياري. يتضمن الرد url. انسخ هذا الرابط المستضاف إلى بريدك الإلكتروني المعتمد، أو الدعم، أو قناة الإعداد. إنشاء الجلسة لا يعني بحد ذاته أنه تم الاتصال بمقدم الطلب.

هذه هي كل الآلية التي يحتاجها دليل المشغل هذا. إذا كنت تقوم بتنفيذ التسليم الآلي، أو الاستدعاءات، أو الويب هوكس، أو الاستعلام، فاستخدم الأدلة الفنية المرتبطة بدلاً من تحويل محادثة المشغل إلى دليل تكامل.

أخبر مقدم الطلب بما سيحدث

يفتح مقدم الطلب صفحة مستضافة من Didit في متصفحه؛ لا يحتاج إلى كلود أو اتصال MCP. التجربة الدقيقة تتبع سير العمل المحدد. يمكن أن تتضمن حزمة KYC الكاملة المكونة التقاط وثيقة الهوية، والتحقق السلبي من الحيوية، ومطابقة الوجه واحد لواحد، وتحليل بروتوكول الإنترنت (IP). قد يحتوي سير عمل مختلف على عدد أقل من الفحوصات، أو فحوصات إضافية، أو فروع مشروطة.

اطلب من كلود صياغة رسالة تستند فقط إلى التكوين المسترد:

اكتب رسالة من أربع نقاط لمقدم الطلب تشرح ما سيراه بعد فتح الرابط. استخدم فقط تكوين سير العمل المحدد. اذكر أي وثيقة أو جهاز يتطلبه فعليًا. لا تعد بالموافقة، أو بوقت إنجاز، أو بفحوصات غير مكونة.

تشرح رسالة المشغل الجيدة سبب تلقي الشخص للرابط، والخطوات المرئية التي سيكملها، وأين يطلب المساعدة. لا ينبغي أن تكشف عن الرمز الداخلي للجلسة، أو تنسخ البيانات الشخصية إلى الدردشة، أو تصف فحص الخلفية كإجراء لمقدم الطلب.

تدعم Didit أكثر من 220 دولة ومنطقة، وأكثر من 14000 نوع من المستندات، وأكثر من 48 لغة. تصف هذه الأرقام الخاصة بالتغطية المنصة؛ لا يزال سير العمل المحدد ووثيقة مقدم الطلب يحددان الشاشات الفعلية المتاحة في تلك الجلسة.

اطلب نتيجة باللغة الإنجليزية العادية

عندما يقول مقدم الطلب إنه انتهى، لا تسأل كلود عما إذا كان قد "اجتاز". اطلب منه استرداد القرار المسجل وفصل الحالة عن الأدلة:

استدع didit_session_get_decision للجلسة SESSION_UUID. اشرح النتيجة لمشغل إعداد غير تقني. ابدأ بالحالة الحالية بالضبط. ثم اسرد فقط نتائج الوحدات النمطية المكونة والحقول التي تم إرجاعها بالفعل. افصل الأدلة المؤكدة، والأدلة المفقودة، والتعارضات، والعناصر التي تحتاج إلى حكم بشري. لا تغير الجلسة.

هذه الصياغة تجعل الهلوسة أسهل في الملاحظة. يحتوي القرار على مخرجات الوحدات النمطية المكونة لسير العمل هذا، وليس مجموعة عالمية من وثائق الهوية، والحيوية، ومطابقة الوجه، ومكافحة غسل الأموال (AML)، وفحوصات الاحتيال. إذا لم يتم تشغيل وحدة نمطية أو كان حقل غائبًا، يجب أن يقول الرد ذلك بدلاً من سد الفجوة.

اقرأ الحالة على أنها حالة الجلسة الحالية:

• يعني لم تبدأ أو قيد التقدم أنه يجب على المشغل الانتظار أو مساعدة مقدم الطلب على إكمال التدفق المستضاف.
• يعني قيد المراجعة أن الأدلة أو منطق سير العمل قد وجه الجلسة إلى قرار بشري.
• تمت الموافقة أو مرفوض هي حالة القرار الحالية. يمكن أن يعكس أي منهما الأتمتة المكونة أو التجاوز اليدوي لمراجع معتمد، لذا استخدم الأدلة المصاحبة وسجل التدقيق عندما تتطلب السياسة ذلك.
• يعني تمت إعادة التقديم أن عقد سير العمل المحددة قد تم إرسالها مرة أخرى لمحاولة أخرى؛ إنها ليست جلسة جديدة وغير مرتبطة.

يعمل استنتاج النموذج في أقل من ثانيتين بـ p99، لكن هذا ليس وعدًا بشأن المدة التي سيستغرقها مقدم الطلب لالتقاط مستند، أو إكمال التدفق، أو انتظار المراجعة البشرية.

ماذا تفعل عندما تكون الإجابة قيد المراجعة

لا تترجم قيد المراجعة إلى "فشل"، ولا تطلب من كلود الموافقة أو الرفض في نفس المطالبة التي تشرح الأدلة. اطلب أولاً حزمة مراجعة للقراءة فقط:

هذه الجلسة قيد المراجعة. استدع didit_session_get_decision و didit_session_list_reviews. لا تغير البيانات أو الحالة. أظهر السبب المعاد أو الأدلة المحفزة، ومخرجات الوحدة النمطية المكونة ذات الصلة بها، وأي معلومات متضاربة أو مفقودة، وسجل المراجعة أو الحالة السابقة. ضع علامة "غير معروف" على أي شيء لم يتم إرجاعه.

ثم اتبع سياسة التصعيد الخاصة بمؤسستك. قد يقارن المراجع بيانات الهوية المستخرجة بأدلة المستند، ويقيم المطابقة أو مرشح الفحص، ويطلب محاولة أخرى لعقد سير العمل الفاشلة بالضبط، أو يتخذ قرار حالة معتمد. يمكن لكلود تنظيم السجل، لكنه لا يحل محل المراجع أو سياسة القبول الخاصة بالمؤسسة.

إذا كنت مخولًا بتوثيق المراجعة، فاحتفظ بالملاحظة منفصلة عن القرار النهائي:

أضف هذا التعليق باستخدام didit_session_add_review إلى الجلسة SESSION_UUID: "تم التصعيد للمراجعة اليدوية بسبب [الأدلة المرصودة]." لا تمرر new_status ولا تعدل البيانات المستخرجة.

يتطلب didit_session_add_review session_id، ويقبل comment، ويمكنه اختياريًا تغيير الحالة. حذف new_status يجعل القصد واضحًا هنا: تسجيل ملاحظة المراجعة دون اتخاذ قرار بشأن الحالة. لتصحيحات، وإعادة التقديم الجزئي، وإجراءات الموافقة، والرفض، استخدم دليل قائمة انتظار مراجعة KYC مع كلود المخصص.

قائمة التحقق النهائية للمشغل

• تأكد من المنظمة والتطبيق ومرجع مقدم الطلب قبل إنشاء أي شيء.
• اسرد سير العمل أولاً، ثم استرد تكوين أو رسم بياني سير العمل المحدد قبل وصف فحوصاته.
• أرسل فقط url المستضاف المعاد من خلال قناة عملاء معتمدة.
• اطلب من كلود الإبلاغ عن الأدلة المعادة، وليس استنتاج الوحدات النمطية الغائبة أو تحويل الحالة إلى قصة.
• تعامل مع "قيد المراجعة" كتسليم بشري. افصل التحقيق، وملاحظة التدقيق، وتصحيح البيانات، والحالة النهائية إلى خطوات متعمدة.
• احتفظ بالبيانات الشخصية غير الضرورية، وصور المستندات، والرموز الداخلية خارج المحادثة.

خادم MCP نفسه مجاني. تبلغ تكلفة حزمة KYC الكاملة المكونة 0.33 دولارًا أمريكيًا وتشمل التحقق من وثيقة الهوية، والتحقق السلبي من الحيوية، ومطابقة الوجه، وتحليل IP. تتضمن كل ميزة 500 عملية تحقق مجانية شهريًا. تخدم Didit أكثر من 2000 شركة في الإنتاج وهي بنية تحتية للهوية والاحتيال.

روابط مرجعية

• نظرة عامة على MCP — نقطة نهاية مستضافة وبنية معمارية
• وثائق أدوات MCP — الأسماء والمخططات الكنسية
• Didit MCP على GitHub — مصدر عام مرخص بموجب ترخيص MIT
• صفحة مطوري Didit MCP — نظرة عامة على المنتج
• ربط Didit بـ Claude — إعداد الموصل