> ## 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)** سجلات هوية لوكلاء الذكاء الاصطناعي، والروبوتات، والخدمات الآلية — لتسجيل الوكلاء وتسجيل أذوناتهم ونشاطهم.

> [!WARNING]
>
> تسجل بعض عمليات MAIP حاليًا النتائج التي يوفرها المتصل بدلاً من تنفيذها أو التحقق منها بشكل مستقل. يتم محاكاة استخراج المستندات وأحكام الذكاء الاصطناعي؛ تصنف الحواجز النتيجة المقدمة؛ تنشئ معالجات التنسيق وسير العمل سجلات تتبع. تستخدم العديد من الإيصالات التي تم إنشاؤها علامات النظام بدلاً من التوقيعات المشفرة. اقرأ قيود تنفيذ العملية قبل الاعتماد على مخرجاتها كدليل.

## لماذا هوية الآلة؟

مع انتشار وكلاء الذكاء الاصطناعي عبر سير عمل المؤسسات، تواجه المنظمات تحديًا حاسمًا: **كيف تعرف أي وكيل فعل ماذا، وما إذا كان مصرحًا له بذلك؟**

يحل MAIP هذا بـ:

* **هوية الوكيل التشفيرية** — يحصل كل وكيل على معرف فريد (`maip-agent:<ulid>`) ومفاتيح توقيع
* **الترخيص المستند إلى النطاق** — تتحكم نطاقات الأذونات الدقيقة في ما يمكن لكل وكيل القيام به
* **تطبيق سياسة وقت التشغيل** — [سياسات MAIP](https://docs.truthlocks.com/ar/guides/maip-policies.md) تقيّم درجات الثقة، والنطاقات، وعمق التفويض قبل كل إجراء حساس
* **تسجيل الثقة** — ينتج التقييم السلوكي المستمر درجة ثقة من 0 إلى 100
* **إدارة الجلسات** — سياقات تنفيذ محددة بوقت مع انتهاء صلاحية تلقائي
* **تفويض عبر المستأجرين** — يمكن للوكلاء تفويض السلطة عبر الحدود التنظيمية
* **مفتاح الإيقاف** - إلغاء فوري وطارئ لوصول أي وكيل

## البنية

```
┌─────────────────────────────────────────────┐
│              Your Application                │
│  ┌─────────┐  ┌─────────┐  ┌─────────────┐  │
│  │ Agent A │  │ Agent B │  │  Agent C    │  │
│  └────┬────┘  └────┬────┘  └──────┬──────┘  │
│       │            │              │          │
│  ┌────▼────────────▼──────────────▼──────┐  │
│  │         MAIP SDK (JS / Go / Py)       │  │
│  └────────────────┬──────────────────────┘  │
└───────────────────┼─────────────────────────┘
                    │ HTTPS
    ┌───────────────▼───────────────┐
    │   Machine Identity Service    │
    │  ┌──────┐ ┌───────┐ ┌──────┐ │
    │  │Agents│ │Scopes │ │Trust │ │
    │  │      │ │       │ │Scores│ │
    │  └──────┘ └───────┘ └──────┘ │
    └───────────────────────────────┘
```

## جربها في ساحة التجربة

تحتوي كل نقطة نهاية MAIP على ساحة لعب API تفاعلية مدمجة في الوثائق. يمكنك بناء الطلبات، والتبديل بين بيئات [Sandbox and Production](https://docs.truthlocks.com/ar/environments.md#try-it-in-the-api-playground)، وإرسالها مباشرة — لا حاجة لأداة منفصلة.

تتم تغطية جميع نقاط نهاية MAIP، وتمتد عبر عشر مجموعات API: [وكلاء الآلة](https://docs.truthlocks.com/ar/api-reference/machine-identity/agents/register.md)، [جلسات وأدوات الوكيل](https://docs.truthlocks.com/ar/api-reference/machine-identity/sessions/create.md)، [الثقة والشهود](https://docs.truthlocks.com/ar/api-reference/machine-identity/trust-scores/get.md)، [سياسات MAIP](https://docs.truthlocks.com/ar/api-reference/machine-identity/policies/list.md)، [مطالبات ووثائق الحقيقة](https://docs.truthlocks.com/ar/api-reference/machine-identity/truth-claims/create.md)، [الامتثال والشذوذ](https://docs.truthlocks.com/ar/api-reference/machine-identity/compliance/create-check.md)، [مجموعات البيانات والنماذج](https://docs.truthlocks.com/ar/api-reference/machine-identity/datasets/attest.md)، [التنسيقات وسير العمل](https://docs.truthlocks.com/ar/api-reference/machine-identity/orchestrations/execute.md)، [الحواجز والتفويض](https://docs.truthlocks.com/ar/api-reference/machine-identity/guardrails/check.md)، و [المراقبة](https://docs.truthlocks.com/ar/api-reference/machine-identity/observability/events.md).

تدعم ساحة اللعب كلاً من `X-API-Key` ومصادقة Bearer JWT. استخدم `X-API-Key` للاختبار السريع وBearer JWT عندما تحتاج إلى المصادقة باستخدام رمز جلسة من وكيل قيد التشغيل.

> [!TIP]
>
> افتح أي نقطة نهاية في مرجع API [وكلاء الآلة](https://docs.truthlocks.com/ar/api-reference/machine-identity/agents/register.md) وانقر فوق **إرسال** لتجربتها مباشرة مقابل Sandbox.

## بدء سريع

### 1. تسجيل وكيل

```bash cURL theme={null}
curl -X POST https://api.truthlocks.com/v1/agents \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "order-processor",
    "type": "autonomous",
    "scopes": ["receipts:write", "attestations:read"],
    "metadata": {
      "framework": "langchain",
      "model": "gpt-4o",
      "owner": "platform-team"
    }
  }'
```

```javascript JavaScript theme={null}
import { TruthlocksMAIP } from "@truthlocks/sdk";

const maip = new TruthlocksMAIP({ apiKey: process.env.TL_API_KEY });

const agent = await maip.agents.register({
  name: "order-processor",
  type: "autonomous",
  scopes: ["receipts:write", "attestations:read"],
  metadata: {
    framework: "langchain",
    model: "gpt-4o",
    owner: "platform-team",
  },
});
```

### 2. إنشاء جلسة

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/agent-sessions \
  -H "X-API-Key: $API_KEY" \
  -d '{
    "agent_id": "maip-agent:01JXXXX",
    "scopes": ["receipts:write"],
    "ttl_seconds": 3600,
    "ip_allowlist": ["10.0.0.0/8"]
  }'
```

### 3. التنفيذ باستخدام تسجيل الثقة

يتم تسجيل كل إجراء يتخذه الوكيل وتقييمه. يتم تحديث درجة الثقة باستمرار:

```bash theme={null}
# Check current trust score
curl https://api.truthlocks.com/v1/trust-scores/maip-agent:01JXXXX \
  -H "X-API-Key: $API_KEY"
```

الاستجابة:

```json theme={null}
{
  "agent_id": "maip-agent:01JXXXX",
  "score": 87,
  "factors": {
    "behavioral_compliance": 92,
    "scope_adherence": 95,
    "anomaly_score": 12,
    "peer_attestations": 78
  },
  "trend": "stable",
  "computed_at": "2026-04-06T12:00:00Z"
}
```

### 4. مفتاح الإيقاف الطارئ

إلغاء فوري لجميع وصول الوكلاء:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/agents/maip-agent:01JXXXX/kill \
  -H "X-API-Key: $API_KEY" \
  -d '{ "reason": "Anomalous behavior detected", "revoke_sessions": true }'
```

## المفاهيم الأساسية

### أنواع الوكلاء

| النوع | الوصف | حالة الاستخدام |
| - | - | - |
| `autonomous` | اتخاذ قرارات مستقلة تمامًا | روبوتات التداول، محركات سير العمل |
| `supervised` | يتطلب موافقة بشرية للإجراءات الحرجة | الإشراف على المحتوى، الامتثال |
| `delegated` | يتصرف نيابة عن وكيل أو مستخدم آخر | حسابات الخدمة، الوكلاء |
| `system` | وكيل على مستوى البنية التحتية | المراقبة، فحوصات السلامة |

### النطاقات

تتبع النطاقات نمط `resource:action`:

* `agents:read` / `agents:write` — إدارة الوكيل
* `receipts:write` — إصدار إيصالات الإجراءات
* `attestations:read` — قراءة بيانات الإثبات
* `trust-scores:read` — الوصول إلى درجات الثقة
* `delegations:offer` / `delegations:accept` — التفويض عبر المستأجرين
* `compliance:write` — تشغيل فحوصات الامتثال
* `orchestrations:execute` — تنفيذ سير عمل متعدد الوكلاء

### مكونات درجة الثقة

| العامل | الوزن | الوصف |
| - | - | - |
| الامتثال السلوكي | 35% | الإجراءات ضمن النطاق المعلن |
| الالتزام بالنطاق | 25% | لا توجد محاولات وصول خارج النطاق |
| درجة الشذوذ | 20% | الانحراف عن الأنماط التاريخية |
| شهادات الأقران | 10% | وكلاء آخرون يشهدون على السلوك |
| نظافة الجلسة | 10% | إنشاء/إنهاء الجلسة بشكل صحيح |

## الفواتير والحصص

يتم قياس ميزات هوية الآلة وفقًا لخطتك. يتم تتبع أربعة عدادات استخدام MAIP في كل دورة فوترة:

| المقياس | ما يحسبه | المطور | الأعمال | المؤسسة |
| :- | :- | :- | :- | :- |
| `maip.agents` | وكلاء الجهاز المسجلون | 2 | 50 | يعتمد على الخطة |
| `maip.sessions` | جلسات الوكيل التي تم إنشاؤها شهريًا | 100 | 10,000 | يعتمد على الخطة |
| `maip.trust_computes` | حسابات درجة الثقة عند الطلب | 50 | 5,000 | يعتمد على الخطة |
| `maip.compliance_checks` | طلبات التحقق من الامتثال | 10 | 500 | يعتمد على الخطة |

راقب استهلاكك باستخدام [usage API](https://docs.truthlocks.com/ar/api-reference/billing/usage.md) أو في وحدة التحكم ضمن **الإعدادات > الفواتير > الاستخدام** في قسم **MAIP**.

> [!NOTE]
>
> راجع [نظرة عامة على الفواتير](https://docs.truthlocks.com/ar/billing/overview.md#metered-products) للحصول على القائمة الكاملة للمنتجات الـ 16 المقاسة. قم بترقية خطتك على [console.truthlocks.com/billing](https://console.truthlocks.com/billing) لزيادة الحدود.

## تكاملات المحرر وخط الأنابيب

يتكامل MAIP مع الأدوات التي يستخدمها فريقك بالفعل. يولد كل تكامل إيصالات تشفير تلقائيًا.

| الفئة | التكاملات |
| :- | :- |
| **ملحقات المحرر** | [VS Code](https://docs.truthlocks.com/ar/guides/maip-integrations.md#vs-code-extension)، [JetBrains](https://docs.truthlocks.com/ar/guides/maip-integrations.md#jetbrains-plugin)، [Neovim](https://docs.truthlocks.com/ar/guides/maip-integrations.md#neovim-plugin) (Telescope، statusline، auto-receipt on save) |
| **مساعدو الذكاء الاصطناعي** | [خادم MCP](https://docs.truthlocks.com/ar/guides/maip-integrations.md#mcp-server) — 20 أداة لمساعدي ترميز الذكاء الاصطناعي للاستعلام عن الوكلاء والإيصالات ودرجات الثقة |
| **خطوط أنابيب البيانات** | [مكتبة تدفق الأحداث وموصل Kafka](https://docs.truthlocks.com/ar/guides/maip-integrations.md#event-streaming) — تتطلب محولات المزود عملاء ملموسين؛ البوابة المستقلة ليست جاهزة |
| **CI/CD** | [إجراء GitHub](https://docs.truthlocks.com/ar/guides/maip-integrations.md#github-action) — إيصالات للالتزامات، طلبات السحب، الإصدارات، ومصنوعات البناء |
| **أطر عمل الذكاء الاصطناعي** | LangChain, LlamaIndex, CrewAI, AutoGen, OpenAI, Anthropic, AWS Bedrock |
| **أدوات الفريق** | Slack، Linear، Notion |

راجع [دليل تكامل MAIP](https://docs.truthlocks.com/ar/guides/maip-integrations.md) للحصول على تعليمات الإعداد وأمثلة التعليمات البرمجية.

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

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

> [card] [سياسات MAIP](https://docs.truthlocks.com/guides/maip-policies.md)
>
> قواعد التنفيذ في وقت التشغيل بناءً على درجات الثقة، والنطاقات، وعمق التفويض.

> [card] [درجات الثقة](https://docs.truthlocks.com/guides/trust-scores.md)
>
> فهم وتقييم الثقة المستمر.

> [card] [التفويض عبر المستأجرين](https://docs.truthlocks.com/guides/cross-tenant-delegation.md)
>
> تمكين الوكلاء من العمل عبر الحدود التنظيمية.

> [card] [تنسيق الذكاء الاصطناعي](https://docs.truthlocks.com/guides/ai-orchestration.md)
>
> تنفيذ سير عمل متعدد الوكلاء مع حواجز أمان.

> [card] [تكاملات MAIP](https://docs.truthlocks.com/guides/maip-integrations.md)
>
> ربط الوكلاء بـ Slack، وGitHub، وVS Code، وNeovim، وLangChain، والمزيد.


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