> ## 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 فرض قيود على سلوك وكيل الذكاء الاصطناعي في وقت التشغيل. عندما يطلب وكيل الوصول إلى مورد محدد النطاق، يتم تقييم جميع السياسات النشطة قبل متابعة الإجراء. إذا رفضت أي سياسة الطلب، يتم حظر الإجراء.

> [!NOTE]
>
> تختلف سياسات MAIP عن [سياسات الإصدار](https://docs.truthlocks.com/ar/guides/issuance-policies.md). تحكم سياسات الإصدار **سك بيانات الاعتماد والتحقق منها** للمستخدمين والمصدرين البشريين. تحكم سياسات MAIP **سلوك وكيل الجهاز** في وقت التشغيل — التحكم فيما يمكن للوكلاء فعله بناءً على درجات الثقة وعمق التفويض والنطاقات ونوع الوكيل.

## متى تستخدم سياسات MAIP

استخدم سياسات MAIP عندما تحتاج إلى:

* حظر الوكلاء ذوي درجات الثقة المنخفضة من تنفيذ العمليات الحساسة
* طلب موافقة بشرية عندما يكون الوكيل عميقًا في سلسلة تفويض
* تقييد أنواع وكلاء محددة (مثل `llm` أو `worker`) من الوصول إلى نطاقات معينة
* فرض قواعد مختلفة لمستويات المخاطر المختلفة دون تغيير رمز الوكيل
* إضافة حواجز حماية وقت التشغيل إلى سير عمل تنسيق الوكلاء المتعددين

إذا لم تقم بإنشاء أي سياسات MAIP، يتم التحكم في وصول الوكيل فقط من خلال تعيينات النطاق وحالة الوكيل.

## كيف تعمل السياسات

تحتوي كل سياسة MAIP على قاعدة واحدة أو أكثر. تحتوي كل قاعدة على:

* **الشروط** — فحوصات على مستوى الحقل يتم تقييمها مقابل سياق الوكيل الطالب
* **التأثير** - `allow`، `deny`، أو `require_approval`
* **requires\_approval** — علامة اختيارية تؤدي إلى سير عمل موافقة بشرية

يتم تقييم القواعد داخل السياسة بشكل مستقل. إذا تطابقت **أي** قاعدة ذات تأثير `deny`، يتم حظر الإجراء بغض النظر عن أي قواعد `allow`. هذا نموذج **الرفض يتجاوز**.

```
Agent requests scope → Evaluate all active policies (priority order)
                              │
                     ┌────────┼────────┐
                     ▼        ▼        ▼
                  Policy A  Policy B  Policy C
                  (p: 10)   (p: 20)  (p: 100)
                     │        │        │
                     ▼        ▼        ▼
               Any deny? ──yes──→ Action BLOCKED
                  │
                  no
                  │
                  ▼
             Action ALLOWED
```

### ترتيب التقييم

1. **حالة الوكيل** — يجب أن يكون الوكيل `active`. يتم رفض الوكلاء المعلقين أو الملغاة دائمًا.
2. **فحص النطاق** — يجب أن يكون النطاق المطلوب ضمن النطاقات الممنوحة للوكيل. النطاقات المرفوضة صراحةً (المسبوقة بـ `!`) تمنع الوصول دائمًا.
3. **قواعد السياسة** — يتم تقييم جميع سياسات المستأجر النشطة بترتيب الأولوية (الأرقام الأقل أولاً). يتم ربط شروط كل قاعدة بـ AND.

### حقول الشرط

| الحقل | النوع | العوامل | الوصف |
| - | - | - | - |
| `trust_score` | number | `lt`، `gt`، `le`، `ge` | درجة ثقة الوكيل الحالية (0.0-1.0) |
| `scope` | string | `eq`، `ne`، `in`، `contains` | النطاق المطلوب (مثال: `data:write`) |
| `agent_type` | string | `eq`، `ne`، `in` | نوع الوكيل (مثال: `llm`، `worker`، `orchestrator`) |
| `delegation_depth` | number | `gt`، `ge`، `lt`، `le` | الموضع في سلسلة التفويض (0 = مباشر) |

### المشغلون

| عامل التشغيل | الوصف | قيمة مثال |
| - | - | - |
| `eq` | يساوي | `"data:write"` |
| `ne` | لا يساوي | `"system"` |
| `lt` | أقل من | `0.5` |
| `gt` | أكبر من | `3` |
| `le` | أقل من أو يساوي | `0.3` |
| `ge` | أكبر من أو يساوي | `0.7` |
| `in` | يطابق أي قيمة في قائمة | `["llm", "worker"]` |
| `contains` | السلسلة تحتوي على سلسلة فرعية | `"write"` |

### التأثيرات

| التأثير | السلوك |
| - | - |
| `allow` | السماح بالإجراء صراحةً. لا يتجاوز الرفض من القواعد الأخرى. |
| `deny` | حظر الإجراء. الرفض الأول يفوز. |
| `require_approval` | اسمح بالإجراء ولكن قم بوضع علامة عليه للموافقة البشرية قبل المتابعة. |

## إنشاء سياسة

```bash cURL theme={null}
curl -X POST https://api.truthlocks.com/v1/maip/policies \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Block Low-Trust Write Operations",
    "description": "Deny data:write scope for agents with trust score below 0.5",
    "category": "trust",
    "priority": 10,
    "rules": [
      {
        "conditions": [
          {"field": "trust_score", "op": "lt", "value": 0.5},
          {"field": "scope", "op": "eq", "value": "data:write"}
        ],
        "effect": "deny",
        "requires_approval": false
      }
    ]
  }'
```

```javascript JavaScript theme={null}
const response = await fetch("https://api.truthlocks.com/v1/maip/policies", {
  method: "POST",
  headers: {
    "X-API-Key": "tl_live_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name: "Block Low-Trust Write Operations",
    description: "Deny data:write scope for agents with trust score below 0.5",
    category: "trust",
    priority: 10,
    rules: [
      {
        conditions: [
          { field: "trust_score", op: "lt", value: 0.5 },
          { field: "scope", op: "eq", value: "data:write" },
        ],
        effect: "deny",
        requires_approval: false,
      },
    ],
  }),
});
const policy = await response.json();
```

```python Python theme={null}
import requests

response = requests.post(
    "https://api.truthlocks.com/v1/maip/policies",
    headers={
        "X-API-Key": "tl_live_...",
        "Content-Type": "application/json",
    },
    json={
        "name": "Block Low-Trust Write Operations",
        "description": "Deny data:write scope for agents with trust score below 0.5",
        "category": "trust",
        "priority": 10,
        "rules": [
            {
                "conditions": [
                    {"field": "trust_score", "op": "lt", "value": 0.5},
                    {"field": "scope", "op": "eq", "value": "data:write"},
                ],
                "effect": "deny",
                "requires_approval": False,
            }
        ],
    },
)
policy = response.json()
```

يتم إنشاء جميع السياسات الجديدة باستخدام `status: "active"` وتدخل حيز التنفيذ فورًا.

### فئات السياسة

| الفئة | حالة الاستخدام |
| - | - |
| `scope` | تقييد الوصول بناءً على نطاقات أو موارد محددة |
| `trust` | تقييد الوصول بناءً على عتبات درجة الثقة |
| `rate` | تقييد تكرار أو حجم الوصول |
| `custom` | منطق تنفيذ مخصص (افتراضي إذا تم حذفه) |

### الأولوية

يتحكم الحقل `priority` في ترتيب التقييم. يتم تقييم الأرقام الأقل أولاً. النطاق: 1-1000. الافتراضي: `100`. إذا كانت سياسات متعددة تشترك في نفس الأولوية، يتم تقييمها بترتيب الإنشاء.

## تقييم السياسات في وقت التشغيل

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

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/maip/policies/evaluate \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "maip:t1234567:01HYX3KPZQ7RJGBN0WFMV8SDEH",
    "scope": "data:write",
    "action": "update_customer_record",
    "resource": "customers/cust_12345"
  }'
```

**الاستجابة المسموح بها:**

```json theme={null}
{
  "allowed": true,
  "requires_approval": false
}
```

**استجابة مرفوضة:**

```json theme={null}
{
  "allowed": false,
  "denied_by": ["Block Low-Trust Write Operations"],
  "reason": "denied by policy",
  "requires_approval": false
}
```

**يتطلب استجابة موافقة:**

```json theme={null}
{
  "allowed": true,
  "requires_approval": true
}
```

عندما يكون `requires_approval` هو `true`، يجب أن يوجه تطبيقك الإجراء عبر سير عمل موافقة بشرية قبل المتابعة.

## سرد السياسات

```bash theme={null}
curl https://api.truthlocks.com/v1/maip/policies \
  -H "X-API-Key: $API_KEY"
```

يُرجع جميع سياسات MAIP لمستأجرك، بما في ذلك قواعدها، وأولويتها، وحالتها.

## الأنماط الشائعة

### حظر الوكلاء غير الموثوق بهم من كتابة البيانات

رفض أي وكيل لديه درجة ثقة أقل من 0.5 من الوصول إلى نطاقات الكتابة.

```json theme={null}
{
  "name": "Block Low-Trust Writes",
  "category": "trust",
  "priority": 10,
  "rules": [
    {
      "conditions": [
        { "field": "trust_score", "op": "lt", "value": 0.5 },
        { "field": "scope", "op": "eq", "value": "data:write" }
      ],
      "effect": "deny"
    }
  ]
}
```

### طلب الموافقة على سلاسل التفويض العميقة

يجب على الوكلاء الذين يزيد عمقهم عن ثلاثة مستويات في سلسلة التفويض الحصول على موافقة بشرية لأي إجراء.

```json theme={null}
{
  "name": "Approval for Deep Delegation",
  "category": "scope",
  "priority": 20,
  "rules": [
    {
      "conditions": [
        { "field": "delegation_depth", "op": "gt", "value": 3 }
      ],
      "effect": "require_approval",
      "requires_approval": true
    }
  ]
}
```

### تقييد وكلاء LLM من تنفيذ الأدوات

منع وكلاء من نوع LLM من استدعاء نطاقات تنفيذ الأدوات مع السماح لأنواع الوكلاء الأخرى.

```json theme={null}
{
  "name": "No Tool Execution for LLMs",
  "category": "scope",
  "priority": 15,
  "rules": [
    {
      "conditions": [
        { "field": "agent_type", "op": "eq", "value": "llm" },
        { "field": "scope", "op": "eq", "value": "tool:execute" }
      ],
      "effect": "deny"
    }
  ]
}
```

### حظر أنواع وكلاء متعددة من نطاق

استخدم عامل التشغيل `in` للمطابقة مع قائمة من القيم بدلاً من كتابة قواعد منفصلة لكل نوع وكيل.

```json theme={null}
{
  "name": "No Autonomous Writes",
  "category": "scope",
  "priority": 10,
  "rules": [
    {
      "conditions": [
        { "field": "agent_type", "op": "in", "value": ["llm", "worker"] },
        { "field": "scope", "op": "eq", "value": "data:write" }
      ],
      "effect": "deny"
    }
  ]
}
```

### رفض جميع نطاقات الكتابة بقاعدة واحدة

استخدم عامل التشغيل `contains` لمطابقة أي نطاق يتضمن سلسلة فرعية، بدلاً من سرد كل نطاق كتابة على حدة.

```json theme={null}
{
  "name": "Read-Only for Low Trust",
  "category": "trust",
  "priority": 10,
  "rules": [
    {
      "conditions": [
        { "field": "trust_score", "op": "lt", "value": 0.5 },
        { "field": "scope", "op": "contains", "value": "write" }
      ],
      "effect": "deny"
    }
  ]
}
```

### دمج قواعد متعددة في سياسة واحدة

يمكن أن تحتوي السياسة الواحدة على قواعد متعددة للتطبيق الطبقي:

```json theme={null}
{
  "name": "Production Safety Net",
  "category": "custom",
  "priority": 5,
  "rules": [
    {
      "conditions": [
        { "field": "trust_score", "op": "lt", "value": 0.3 }
      ],
      "effect": "deny"
    },
    {
      "conditions": [
        { "field": "trust_score", "op": "lt", "value": 0.7 },
        { "field": "scope", "op": "eq", "value": "data:write" }
      ],
      "effect": "require_approval",
      "requires_approval": true
    }
  ]
}
```

تمنع هذه السياسة الوكلاء الذين تقل درجات ثقتهم عن 0.3 تمامًا، وتتطلب موافقة بشرية لعمليات الكتابة من الوكلاء الذين تتراوح درجاتهم بين 0.3 و 0.7.

## سياسات MAIP مقابل سياسات RBAC

| | سياسات MAIP | سياسات RBAC (الإصدار) |
| - | - | - |
| **يحكم** | سلوك وقت تشغيل وكيل الجهاز | سك بيانات الاعتماد والتحقق منها وتصديرها |
| **المواضيع** | وكلاء الذكاء الاصطناعي المعرفون بواسطة معرف MAIP | المستخدمون البشريون والمصدرون |
| **حقول الشرط** | `trust_score`، `scope`، `agent_type`، `delegation_depth` | `jurisdiction`، `trust_tier`، `risk_rating`، `key.age_days` |
| **نموذج التقييم** | تجاوزات الرفض (أي كتل رفض) | الفوز بالمطابقة الأولى |
| **مسار API** | `/v1/maip/policies` | `/v1/policies` |

## ذات صلة

> [card] [مرجع واجهة برمجة تطبيقات سياسات MAIP](https://docs.truthlocks.com/api-reference/machine-identity/policies/list.md)
>
> إنشاء سياسات MAIP وإدراجها وتقييمها عبر واجهة برمجة تطبيقات REST.

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

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

> [card] [هوية الجهاز](https://docs.truthlocks.com/guides/machine-identity.md)
>
> نظرة عامة كاملة على بروتوكول هوية وكيل الجهاز.


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