> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# تكاملات MAIP

> ربط وكلاء الذكاء الاصطناعي الخاصين بك بالأدوات والمنصات التي يستخدمها فريقك بالفعل.

# تكاملات MAIP

يأتي بروتوكول هوية وكيل الجهاز (MAIP) مع عمليات تكامل تدمج هوية الوكيل والإيصالات وتسجيل الثقة في سير عملك الحالي. يعد الدليل المحلي وتقديم الإيصالات المستضافة والتحقق من التوقيع عمليات منفصلة. قم بتكوين واختبار التكامل الذي تستخدمه؛ التثبيت وحده لا ينشئ مسار تدقيق كاملاً.

> [!NOTE]
>
> **المتطلبات المسبقة:** تحتاج إلى حساب Truthlocks مع مفتاح API ووكيل واحد مسجل على الأقل. راجع [دليل هوية الجهاز](https://docs.truthlocks.com/ar/guides/machine-identity.md) لتسجيل وكيلك الأول.

> [!TIP]
>
> تصفح عمليات التكامل المتاحة في [مركز التكامل](https://truthlocks.com/resources/integrations). يتم تجميع الروابط حسب SDK وإطار عمل الذكاء الاصطناعي والمحرر وأداة التعاون.

## أدوات المطورين

### إضافة VS Code

لوحة جانبية لتصفح الإيصالات، وإنشاء الإيصالات من محرر النصوص الخاص بك، وعرض بيانات الثقة. قم بتثبيتها من [سوق Visual Studio](https://marketplace.visualstudio.com/items?itemName=truthlocks.maip-vscode).

**ماذا يفعل:**

* تصفح وابحث في إيصالات MAIP من الشريط الجانبي
* إنشاء إيصالات لتغييرات التعليمات البرمجية مباشرة من المحرر
* عرض درجات ثقة الوكيل وسلاسل الإيصالات

**التثبيت:**

1. افتح VS Code وانتقل إلى عرض الإضافات (`Ctrl+Shift+X` / `Cmd+Shift+X`).
2. ابحث عن "Truthlocks MAIP".
3. انقر فوق **تثبيت**.

بدلاً من ذلك، قم بالتثبيت من سطر الأوامر:

```bash theme={null}
code --install-extension truthlocks.maip-vscode
```

بعد التثبيت، افتح لوحة الشريط الجانبي لـ MAIP وأدخل مفتاح API ومعرف الوكيل للاتصال.

### مكون JetBrains الإضافي

تكامل MAIP لـ IntelliJ و PyCharm و WebStorm مع نفس إمكانيات تصفح الإيصالات وتوليدها مثل امتداد VS Code.

### إضافة Neovim

ثبّت المكون الإضافي `truthlocks/maip.nvim` المُصدر، مع توفر curl في مسار PATH الخاص بك:

```lua theme={null}
-- lazy.nvim
{ "truthlocks/maip.nvim", tag = "v1.1.0", main = "maip",
  opts = {
    api_url = "https://sandbox-api.truthlocks.com/v1",
    api_key = vim.env.MAIP_API_KEY or "",
    agent_id = vim.env.MAIP_AGENT_ID or "",
    auto_receipt_on_commit = false,
    telescope = false,
  } }
```

استخدم `:MAIPListAgents`، `:MAIPCreateReceipt`، `:MAIPListReceipts`،
`:MAIPVerifyReceipt`، `:MAIPShowTrust` و `:MAIPDashboard`. بيانات وصفية للإيصال هي
ليست توقيعًا موثقًا. إيصالات الالتزام التلقائية اختيارية وتراعي المدعومة
أحداث الالتزام المكتملة؛ لا يوجد خيار `auto_receipt` للحفظ في هذا الإصدار.
راجع [ملف README الموثق](https://github.com/truthlocks/maip.nvim) لـ Telescope
التكوين وحدود الاختبار التفاعلي الحالية.

### خادم MCP

ثبّت الملف التنفيذي على الجهاز الذي يشغل مضيف MCP الخاص بك:

```sh theme={null}
npm install --global @truthlocks/maip-mcp-server@1.2.4
```

```json theme={null}
{
  "mcpServers": {
    "truthlocks": {
      "command": "maip-mcp-server",
      "env": {
        "MAIP_API_URL": "https://sandbox-api.truthlocks.com/v1",
        "MAIP_API_KEY": "REPLACE_WITH_WORKSPACE_TEST_KEY",
        "MAIP_TIMEOUT_MS": "30000",
        "MAIP_MAX_RETRIES": "3"
      }
    }
  }
}
```

قم بتوفير بيانات الاعتماد من خلال التكوين الآمن للمضيف. استخدم مفتاحًا ووكيلًا
من نفس البيئة. اطلب من المضيف سرد الأدوات المتاحة، ثم استخدم
`maip_list_agents`، `maip_list_receipts` و `maip_verify_receipt`. توقيع إيجابي
تتطلب النتيجة `valid: true` و`signature_verified: true` و`verdict: "VALID"`.
التحقق من الشفافية هو نتيجة منفصلة. لا يتم إعادة محاولة عمليات الكتابة تلقائيًا.

## التعاون الجماعي

تتطلب تكاملات Slack و Linear و Notion تطبيقها/مساحة عملها الحقيقية الخاصة بها
بيانات الاعتماد بالإضافة إلى مصادقة Truthlocks. عملية توفيرهم الكاملة من المزود إلى الإيصال
القبول لا يزال معلقًا. لا تتعامل مع توفر المصدر، أو الاختبارات المحلية أو
مفتاح Truthlocks API كدليل على اتصال مساحة عمل خارجية.

راجع ملف README الخاص بحزمة المصدر للحصول على أذونات الموفر وتكوينه:
[Slack](https://github.com/truthlocks/truthlock/tree/main/packages/maip-slack)،
[Linear](https://github.com/truthlocks/truthlock/tree/main/packages/maip-linear)،
[Notion](https://github.com/truthlocks/truthlock/tree/main/packages/maip-notion).
استخدم مساحة عمل اختبار مخصصة قبل تمكين معالجة الأحداث الحقيقية.

### إعداد Slack والتحقق منه

Slack هو تثبيت مصدر، وليس حزمة npm منشورة `@truthlocks/maip-slack`.
اجتاز مصادقة الروبوت الخاصة به وتقديم رسالة اختبار مصرح بها من قبل المزود
الفحوصات. تظل أوامر الشرطة الكاملة للمستخدم الشخصي وسير عمل الأحداث المستضافة قيد
التحقق. اتبع [ملف README الخاص بـ Slack](https://github.com/truthlocks/truthlock/tree/main/packages/maip-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](https://github.com/truthlocks/truthlock/tree/main/packages/maip-notion)
لتهيئة قواعد البيانات مرة واحدة وإعادة استخدام معرفاتها. استخدم `WEBHOOK_SECRET` مع
عقد HMAC/الطابع الزمني الموثق؛ يتم رفض الطلبات غير الموقعة. حالة الإيصال
هي بيانات وصفية، لذا فإن الإيصال المكتمل لا يتحقق تلقائيًا من Notion
مربع **تم التحقق**. استخدم التحقق الصريح من التوقيع بشكل منفصل.

## CI/CD

مدخلات إجراء MAIP هي `maip-api-url` و`maip-api-key` و`maip-agent-id`.
الأسماء القديمة `api-key` و `agent-id` ليست مدخلات معلنة. للمراجعة
التحقق من المصدر مع `dist/index.js` المبني الخاص به، وسير عمل ضمان الجودة الذي يتم تشغيله بشكل صريح
يمكن استخدام هذه الخطوة:

```yaml theme={null}
- uses: ./packages/maip-github-action
  with:
    maip-api-url: https://sandbox-api.truthlocks.com/v1
    maip-api-key: ${{ secrets.TRUTHLOCKS_API_KEY }}
    maip-agent-id: ${{ vars.TRUTHLOCKS_AGENT_ID }}
    mode: receipt
    event-type: commit
    create-check: 'false'
    post-comment: 'false'
```

هذا مسار إجراء محلي بعد السحب والبناء، وليس سوقًا غير متحقق منه
علامة. قم بتثبيت الإصدارات التي تمت مراجعتها عند توزيع الإجراء. تحقق/علق على النشر
يتطلب أذونات GitHub متعمدة وقبولًا منفصلًا؛ لا تكشف أبدًا عن الأسرار
لسير العمل من الفروع غير الموثوق بها. راجع [ملف README الخاص بالإجراء](https://github.com/truthlocks/truthlock/tree/main/packages/maip-github-action).

## موصلات نموذج الذكاء الاصطناعي

تُلتقط الأحداث المنبعثة من خلال التكامل المكوّن بواسطة أغلفة Python. التجزئات المحلية ليست توقيعات خادم. يتم تكوين بيانات اعتماد المزود، وبيانات اعتماد Truthlocks، والإرسال المستضاف بشكل منفصل؛ افحص البيانات الوصفية التي ترسلها ولا تفترض أن التجزئة تزيل التزامات الخصوصية.

### الأطر المدعومة

| الإطار | التثبيت |
| :- | :- |
| LangChain | `pip install truthlocks-langchain` |
| LlamaIndex | `pip install truthlocks-llamaindex` |
| CrewAI | `pip install truthlocks-crewai` |
| التوليد التلقائي | `pip install truthlocks-autogen` |
| OpenAI | `pip install truthlocks-openai` |
| Anthropic | `pip install truthlocks-anthropic` |
| AWS Bedrock | `pip install truthlocks-bedrock` |

**مثال LangChain المحلي الكامل (لا يوجد طلب مستضاف):**

```python theme={null}
from langchain_core.runnables import RunnableLambda
from truthlocks_langchain import MAIPRunnableWrapper
from maip_ai_connectors.config import MAIPConfig

chain = RunnableLambda(lambda value: value.upper())
wrapped = MAIPRunnableWrapper(chain, config=MAIPConfig(auto_receipt=False))
print(wrapped.invoke("hello"))
receipts = wrapped.get_receipts()
print(receipts[0].payload_hash)
wrapped.clear_receipts()
```

`payload_hash` يصف الأدلة المحلية. للإرسال المستضاف استخدم `MAIPClient.create_receipt`
وتحقق من `receipt_id` الخادم المعروض؛ [ملف README الخاص بـ LangChain](https://github.com/truthlocks/truthlock/tree/main/packages/truthlocks-langchain)
يحتوي على مثال الإرسال غير المتزامن. للخطافات التلقائية غير المتزامنة، قم بالتفريغ و
أغلق الغلاف وافحص نتائج الإرسال قبل الإغلاق. المكالمات خارج
الغلاف المكون لا يتم ملاحظتها.

## خطوط أنابيب البيانات والتعلم الآلي

### موصل Kafka

يرسل موصل Go بصمات الرسائل كإيصالات MAIP `data.attestation`
باستخدام وكيل موجود. يستخدم عميل HTTP الخاص به `/v1/agent-receipts`، ويحافظ على الجزئي
نتائج الدفعة، وتتطلب توقيعًا مؤكدًا للتحقق الناجح.

ثبّت `github.com/truthlocks/kafka-maip-connector@v0.1.0` باستخدام `go get`.
راجع [مثال الإصدار والإكمال](https://github.com/truthlocks/kafka-maip-connector/releases/tag/v0.1.0).
يحدد مفتاح API مساحة العمل والبيئة؛ معرف المستأجر الذي يوفره المتصل لا يفعل ذلك
لا يتجاوز التفويض. لا يتم تحميل بايتات الرسالة ومفاتيح الرسائل الخام.

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

### تدفق الأحداث

ثبّت [Go event-stream v0.1.0](https://github.com/truthlocks/maip-event-stream/releases/tag/v0.1.0):

```sh theme={null}
go get github.com/truthlocks/maip-event-stream@v0.1.0
```

تتضمن المكتبة عميل Redis ملموس وواجهات محول لـ NATS
JetStream و EventBridge و Kinesis. يقوم مستهلكو Redis الذين يعيدون الاتصال بمسح بياناتهم الخاصة
الإدخالات المعلقة قبل الرسائل الجديدة؛ يبقى المعالجة الفاشلة غير معترف بها.
حافظ على أسماء المستهلكين مستقرة عبر عمليات إعادة التشغيل. المطالبة بانتظار مستهلك آخر
لا تزال الإدخالات تتطلب عملية استرداد صريحة. اجتاز العنصر المنشور
اختبار إعادة تشغيل/إقرار Redis حقيقي معزول ومجموعة اختبار Go race الكاملة.
تتطلب محولات الواجهة الخلفية الأخرى تطبيقات عميل حقيقية وموثقة. هذه المحولات
أغلفة أحداث النقل؛ لا تقوم تلقائيًا بإنشاء أو التحقق من توقيعات MAIP.
إنشاء إيصال Kafka هو موصل منفصل، موصوف أعلاه.

> [!WARNING]
>
> البوابة المستقلة ليست جاهزة للنشر: مصانع العملاء الخلفية الخاصة بها
> غير موصلة، وترفض الآن بدء التشغيل بدلاً من الإبلاغ عن مهام غير منفذة
> المنشورات كما هي مقبولة. لا يوجد إصدار `truthlocks_streaming.StreamingGateway`
> واجهة برمجة تطبيقات Python المقابلة للمثال الأقدم في هذه الصفحة.

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

يتحقق مدقق الإيصالات من البنية وروابط التجزئة المحلية؛ إنه ليس توقيعًا
المحقق. حافظ على التوجيه الموثق، والاحتفاظ الدائم، والتحقق التشفيري
في تصميم تطبيقك.

### MLflow و DVC و Delta Lake

ثبّت `mlflow-maip` أو `dvc-maip` أو `delta-lake-maip` للبيانات الوصفية المقابلة
البناة. تنتج هذه الحزم أدلة منظمة محلية؛ تثبيت واحدة لا
اجعل كل عملية إطار عمل إيصالًا مستضافًا موقعًا. لا يوجد دعم
`truthlocks_mlflow.TruthlocksPlugin.enable` API المقابل للمثال الأقدم.

استخدم الأمثلة المحلية والمستضافة الكاملة في ملفات README المصدر:
[MLflow](https://github.com/truthlocks/truthlock/tree/main/packages/mlflow-maip)،
[DVC](https://github.com/truthlocks/truthlock/tree/main/packages/dvc-maip)،
[Delta Lake](https://github.com/truthlocks/truthlock/tree/main/packages/delta-lake-maip).
لا تتحقق بيانات تعريف المزود ومعرفات الموارد الموحدة للقطع الأثرية بشكل مستقل من بايتات القطع الأثرية أو
إثبات حدوث عملية خارجية. لا يتحقق التحقق من التوقيع المستضاف
تأسيس تضمين سجل الشفافية ما لم ينجح هذا الفحص المنفصل.

## دوكر (Docker)

لا تثبت ملفات مصدر الحاوية أن صورة عامة قد تم إصدارها أو
اجتاز القبول. الصور `truthlocks/*:latest` المذكورة سابقًا والمجمعة
لم يتم التحقق من مثال التكوين كنشر عامل وهو ليس
البدء السريع المدعوم. لا تستنتج توفر الصورة من تلك الأسماء التاريخية.

استخدم إصدار الحزمة المنشور وملف README الخاص به لكل تكامل. إذا كنت تقوم بالبناء
حاوية من مصدر مراجع، قم بتثبيت هذا التعديل والتبعيات، قم بتوفير الأسرار
من خلال وقت التشغيل الخاص بك، واختبر اتصال المزود الفعلي. بالإضافة إلى ذلك، Slack
يتطلب بيانات اعتماد التطبيق الحقيقية؛ مفتاح API الخاص بـ Truthlocks وحده غير كافٍ.
بوابة تدفق الأحداث المستقلة لا تزال غير متاحة كما هو موضح أعلاه.

## الخطوات التالية

> [card] [هوية الجهاز](https://docs.truthlocks.com/guides/machine-identity.md)
>
> سجل وكيلك الأول وافهم بروتوكول MAIP.

> [card] [ترخيص الوكيل](https://docs.truthlocks.com/guides/agent-authorization.md)
>
> تكوين النطاقات، والجلسات، والوصول إلى الأدوات لوكلائك.

> [card] [التنزيلات](https://truthlocks.com/resources/downloads)
>
> ابحث عن إصدارات CLI و SDK و IDE المنشورة وتعليمات تثبيتها.

> [card] [مركز التكاملات](https://truthlocks.com/resources/integrations)
>
> تصفح جميع عمليات التكامل حسب الفئة.

### خطي

مصادقة مزود حقيقية، بحث عن مشكلة SDK وتعليق إيصال مع قراءة عكسية
تم تمريره في مشكلة ضمان الجودة المصرح بها صراحةً. هذا لا يؤسس خطاف ويب مستضاف
إنشاء الإيصال أو المزامنة المستمرة. يتحقق المستمع المصدر من Linear's
توقيع HMAC وطابع زمني موقّع، ويقيد الأحداث على المؤسسة المكونة
ومعرفات الفريق. تظل أتمتة مراحل المشروع غير متاحة بدلاً من إصدار
الأدلة المقدرة. انظر [إعداد وحدود Linear](https://github.com/truthlocks/truthlock/tree/main/packages/maip-linear#readme).


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