تكاملات MAIP
يأتي بروتوكول هوية وكيل الجهاز (MAIP) مع عمليات تكامل تدمج هوية الوكيل والإيصالات وتسجيل الثقة في سير عملك الحالي. يعد الدليل المحلي وتقديم الإيصالات المستضافة والتحقق من التوقيع عمليات منفصلة. قم بتكوين واختبار التكامل الذي تستخدمه؛ التثبيت وحده لا ينشئ مسار تدقيق كاملاً.المتطلبات المسبقة: تحتاج إلى حساب Truthlocks مع مفتاح API ووكيل واحد مسجل على الأقل. راجع دليل هوية الجهاز لتسجيل وكيلك الأول.
أدوات المطورين
إضافة VS Code
لوحة جانبية لتصفح الإيصالات، وإنشاء الإيصالات من محرر النصوص الخاص بك، وعرض بيانات الثقة. قم بتثبيتها من سوق Visual Studio. ماذا يفعل:- تصفح وابحث في إيصالات MAIP من الشريط الجانبي
- إنشاء إيصالات لتغييرات التعليمات البرمجية مباشرة من المحرر
- عرض درجات ثقة الوكيل وسلاسل الإيصالات
- افتح VS Code وانتقل إلى عرض الإضافات (
Ctrl+Shift+X/Cmd+Shift+X). - ابحث عن “Truthlocks MAIP”.
- انقر فوق تثبيت.
مكون JetBrains الإضافي
تكامل MAIP لـ IntelliJ و PyCharm و WebStorm مع نفس إمكانيات تصفح الإيصالات وتوليدها مثل امتداد VS Code.إضافة Neovim
ثبّت المكون الإضافيtruthlocks/maip.nvim المُصدر، مع توفر curl في مسار PATH الخاص بك:
:MAIPListAgents، :MAIPCreateReceipt، :MAIPListReceipts،
:MAIPVerifyReceipt، :MAIPShowTrust و :MAIPDashboard. بيانات وصفية للإيصال هي
ليست توقيعًا موثقًا. إيصالات الالتزام التلقائية اختيارية وتراعي المدعومة
أحداث الالتزام المكتملة؛ لا يوجد خيار auto_receipt للحفظ في هذا الإصدار.
راجع ملف README الموثق لـ Telescope
التكوين وحدود الاختبار التفاعلي الحالية.
خادم MCP
ثبّت الملف التنفيذي على الجهاز الذي يشغل مضيف MCP الخاص بك:maip_list_agents، maip_list_receipts و maip_verify_receipt. توقيع إيجابي
تتطلب النتيجة valid: true وsignature_verified: true وverdict: "VALID".
التحقق من الشفافية هو نتيجة منفصلة. لا يتم إعادة محاولة عمليات الكتابة تلقائيًا.
التعاون الجماعي
تتطلب تكاملات Slack و Linear و Notion تطبيقها/مساحة عملها الحقيقية الخاصة بها بيانات الاعتماد بالإضافة إلى مصادقة Truthlocks. عملية توفيرهم الكاملة من المزود إلى الإيصال القبول لا يزال معلقًا. لا تتعامل مع توفر المصدر، أو الاختبارات المحلية أو مفتاح Truthlocks API كدليل على اتصال مساحة عمل خارجية. راجع ملف README الخاص بحزمة المصدر للحصول على أذونات الموفر وتكوينه: Slack، Linear، Notion. استخدم مساحة عمل اختبار مخصصة قبل تمكين معالجة الأحداث الحقيقية.إعداد Slack والتحقق منه
Slack هو تثبيت مصدر، وليس حزمة npm منشورة@truthlocks/maip-slack.
اجتاز مصادقة الروبوت الخاصة به وتقديم رسالة اختبار مصرح بها من قبل المزود
الفحوصات. تظل أوامر الشرطة الكاملة للمستخدم الشخصي وسير عمل الأحداث المستضافة قيد
التحقق. اتبع ملف README الخاص بـ Slack
للبناء المراجع وجميع الإعدادات المطلوبة.
ربط التطبيق بـ SLACK_TEAM_ID و SLACK_ALLOWED_USER_IDS الشخصية الصريحة.
استخدم MAIP_AGENT_ID من وكيل Truthlocks مسجل موجود للإنشاء؛
معرّف عضو Slack ليس هوية جهاز. قم بتوفير مفتاح sandbox و
https://sandbox-api.truthlocks.com/v1 أثناء التقييم. يتم تسجيل الأوامر
في إعدادات تطبيق Slack. يوفر كل من وضع HTTP و Socket Mode /webhook/maip، ولكن
استضافة المستمع لا تشترك تلقائيًا في أحداث Truthlocks إليه.
تبقى موافقات التفويض قيد مراجعة Console المصادقة. حماية إعادة التشغيل المحلية
هي عملية محلية؛ يتطلب التسليم الإنتاجي تتبعًا دائمًا في المنبع.
إعداد Notion والتحقق منه
Notion هي حزمة مصدر خاصة، وليست تثبيت npm. قبول ضمان الجودة الحقيقي أنشأ صفحة فرعية ومخططات قواعد بيانات، وأدخل إيصال مساحة عمل موجودة، كرر المزامنة دون تكرار تلك الصفحة، وتحقق من قراءة المزود. لا تزال الأتمتة المستضافة المستمرة والاسترداد الدائم قيد التحقق. قم بتوصيل الصفحة المقصودة فقط باستخدام قائمة Notion ••• ← الاتصالات. اتبع ملف README في Notion لتهيئة قواعد البيانات مرة واحدة وإعادة استخدام معرفاتها. استخدمWEBHOOK_SECRET مع
عقد HMAC/الطابع الزمني الموثق؛ يتم رفض الطلبات غير الموقعة. حالة الإيصال
هي بيانات وصفية، لذا فإن الإيصال المكتمل لا يتحقق تلقائيًا من Notion
مربع تم التحقق. استخدم التحقق الصريح من التوقيع بشكل منفصل.
CI/CD
مدخلات إجراء MAIP هيmaip-api-url وmaip-api-key وmaip-agent-id.
الأسماء القديمة api-key و agent-id ليست مدخلات معلنة. للمراجعة
التحقق من المصدر مع dist/index.js المبني الخاص به، وسير عمل ضمان الجودة الذي يتم تشغيله بشكل صريح
يمكن استخدام هذه الخطوة:
موصلات نموذج الذكاء الاصطناعي
تُلتقط الأحداث المنبعثة من خلال التكامل المكوّن بواسطة أغلفة Python. التجزئات المحلية ليست توقيعات خادم. يتم تكوين بيانات اعتماد المزود، وبيانات اعتماد Truthlocks، والإرسال المستضاف بشكل منفصل؛ افحص البيانات الوصفية التي ترسلها ولا تفترض أن التجزئة تزيل التزامات الخصوصية.الأطر المدعومة
مثال LangChain المحلي الكامل (لا يوجد طلب مستضاف):
payload_hash يصف الأدلة المحلية. للإرسال المستضاف استخدم MAIPClient.create_receipt
وتحقق من receipt_id الخادم المعروض؛ ملف README الخاص بـ LangChain
يحتوي على مثال الإرسال غير المتزامن. للخطافات التلقائية غير المتزامنة، قم بالتفريغ و
أغلق الغلاف وافحص نتائج الإرسال قبل الإغلاق. المكالمات خارج
الغلاف المكون لا يتم ملاحظتها.
خطوط أنابيب البيانات والتعلم الآلي
موصل Kafka
يرسل موصل Go بصمات الرسائل كإيصالات MAIPdata.attestation
باستخدام وكيل موجود. يستخدم عميل HTTP الخاص به /v1/agent-receipts، ويحافظ على الجزئي
نتائج الدفعة، وتتطلب توقيعًا مؤكدًا للتحقق الناجح.
ثبّت github.com/truthlocks/kafka-maip-connector@v0.1.0 باستخدام go get.
راجع مثال الإصدار والإكمال.
يحدد مفتاح API مساحة العمل والبيئة؛ معرف المستأجر الذي يوفره المتصل لا يفعل ذلك
لا يتجاوز التفويض. لا يتم تحميل بايتات الرسالة ومفاتيح الرسائل الخام.
تقوم أغلفة المنتج/المستهلك بتخزين الإيصالات مؤقتًا في الذاكرة. تسليم الوسيط والإيصال
التسليم هي عمليات منفصلة؛ لا يضمن نجاح كتابة Kafka
تم الاحتفاظ بالإيصال. يتطلب تسليم التدقيق المطلوب صندوق بريد تطبيق دائم
ومعالجة الفشل الصريحة. استشر دليل الإصدار قبل الاستخدام في الإنتاج.
تدفق الأحداث
ثبّت Go event-stream v0.1.0:MLflow و DVC و Delta Lake
ثبّتmlflow-maip أو dvc-maip أو delta-lake-maip للبيانات الوصفية المقابلة
البناة. تنتج هذه الحزم أدلة منظمة محلية؛ تثبيت واحدة لا
اجعل كل عملية إطار عمل إيصالًا مستضافًا موقعًا. لا يوجد دعم
truthlocks_mlflow.TruthlocksPlugin.enable API المقابل للمثال الأقدم.
استخدم الأمثلة المحلية والمستضافة الكاملة في ملفات README المصدر:
MLflow،
DVC،
Delta Lake.
لا تتحقق بيانات تعريف المزود ومعرفات الموارد الموحدة للقطع الأثرية بشكل مستقل من بايتات القطع الأثرية أو
إثبات حدوث عملية خارجية. لا يتحقق التحقق من التوقيع المستضاف
تأسيس تضمين سجل الشفافية ما لم ينجح هذا الفحص المنفصل.
دوكر (Docker)
لا تثبت ملفات مصدر الحاوية أن صورة عامة قد تم إصدارها أو اجتاز القبول. الصورtruthlocks/*:latest المذكورة سابقًا والمجمعة
لم يتم التحقق من مثال التكوين كنشر عامل وهو ليس
البدء السريع المدعوم. لا تستنتج توفر الصورة من تلك الأسماء التاريخية.
استخدم إصدار الحزمة المنشور وملف README الخاص به لكل تكامل. إذا كنت تقوم بالبناء
حاوية من مصدر مراجع، قم بتثبيت هذا التعديل والتبعيات، قم بتوفير الأسرار
من خلال وقت التشغيل الخاص بك، واختبر اتصال المزود الفعلي. بالإضافة إلى ذلك، Slack
يتطلب بيانات اعتماد التطبيق الحقيقية؛ مفتاح API الخاص بـ Truthlocks وحده غير كافٍ.
بوابة تدفق الأحداث المستقلة لا تزال غير متاحة كما هو موضح أعلاه.
الخطوات التالية
هوية الجهاز
سجل وكيلك الأول وافهم بروتوكول MAIP.
ترخيص الوكيل
تكوين النطاقات، والجلسات، والوصول إلى الأدوات لوكلائك.
التنزيلات
ابحث عن إصدارات CLI و SDK و IDE المنشورة وتعليمات تثبيتها.
مركز التكاملات
تصفح جميع عمليات التكامل حسب الفئة.

