> ## 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.

# درجات الثقة

> تقييم مستمر للثقة السلوكية لوكلاء الذكاء الاصطناعي مع عوامل تسجيل قابلة للتكوين.

# درجات الثقة

توفر درجات الثقة **تقييمًا مستمرًا وفي الوقت الفعلي** لموثوقية سلوك وكيل الذكاء الاصطناعي. يتلقى كل وكيل في منصة Truthlocks درجة تتراوح من 0 إلى 100، يتم تحديثها بعد كل إجراء.

## كيف يعمل

```
Agent Action → Event Logged → Score Recomputed → Policy Evaluated
                                    │
                              ┌─────┴─────┐
                              │ Score: 87  │
                              │ Trend: ↑   │
                              └────────────┘
                                    │
                        ┌───────────┼───────────┐
                        ▼           ▼           ▼
                    No Action   Alert Team   Suspend Agent
                   (score > 70) (50 < s < 70) (score < 50)
```

> [!TIP]
>
> تحتوي جميع نقاط نهاية نقاط الثقة والشهود على منصة اختبار واجهة برمجة تطبيقات تفاعلية. افتح أي نقطة نهاية في مرجع واجهة برمجة تطبيقات [الثقة والشهود](https://docs.truthlocks.com/ar/api-reference/machine-identity/trust-scores/get.md) وانقر على **إرسال** لتجربتها مباشرة.

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

| العامل | الوزن الافتراضي | الوصف |
| - | - | - |
| `behavioral_compliance` | 35% | الإجراءات تبقى ضمن حدود النطاق المعلن |
| `scope_adherence` | 25% | لا توجد محاولات للوصول إلى موارد غير مصرح بها |
| `anomaly_score` | 20% | انحراف إحصائي عن أنماط السلوك التاريخية |
| `peer_attestations` | 10% | وكلاء آخرون في شبكة الشهود يضمنون السلوك |
| `session_hygiene` | 10% | دورة حياة الجلسة الصحيحة (الإنشاء، التجديد، الإنهاء) |

## قراءة درجات الثقة

### الحصول على النتيجة الحالية

```bash theme={null}
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,
    "session_hygiene": 90
  },
  "trend": "stable",
  "computed_at": "2026-04-06T12:00:00Z"
}
```

### الحصول على سجل النقاط

```bash theme={null}
curl "https://api.truthlocks.com/v1/trust-scores/maip-agent:01JXXXX/history?period=7d" \
  -H "X-API-Key: $API_KEY"
```

### فرض إعادة الحساب

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

## تكوين العتبات

| العتبة | الإجراء الموصى به |
| - | - |
| 90-100 | استقلالية كاملة — يعمل الوكيل بدون تدخل |
| 70-89 | عملية قياسية — مراقبة عادية |
| 50-69 | مراقبة محسّنة — تنبيه الفريق، زيادة تفاصيل التسجيل |
| 30-49 | وضع مقيد - يتطلب موافقة بشرية للإجراءات الحرجة |
| 0-29 | تعليق تلقائي - تم تشغيل مفتاح الإيقاف |

## شبكة الشهود

يمكن للوكلاء المشاركة في **شبكة شهود** حيث يشهد الأقران على سلوك بعضهم البعض.

### إنشاء طلب شاهد

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/witness/request \
  -H "X-API-Key: $API_KEY" \
  -d '{
    "subject_agent_id": "maip-agent:01JXXXX",
    "claim": "Completed invoice processing without errors",
    "evidence": { "task_id": "task_456", "records_processed": 150 }
  }'
```

### التصديق كشاهد

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/witness/maip-witness:01JWWWW/attest \
  -H "X-API-Key: $API_KEY" \
  -d '{
    "attestor_agent_id": "maip-agent:01JBBBB",
    "verdict": "confirmed",
    "confidence": 0.95
  }'
```

### الإجماع

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

```json theme={null}
{
  "witness_id": "maip-witness:01JWWWW",
  "consensus": "confirmed",
  "confidence": 0.91,
  "attestations": 4,
  "quorum_met": true
}
```

## التكامل مع محرك المخاطر

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

```
Trust Score < 50 → Risk Signal: HIGH → Action blocked or requires approval
```

## قياس الاستخدام

تزيد كل عملية حساب لدرجة الثقة عند الطلب عداد استخدام `maip.trust_computes` لدورة الفوترة الخاصة بك. تُحتسب تحديثات الدرجات في الخلفية التي يتم تشغيلها بواسطة المنصة (مثل بعد إجراءات الوكيل) ضمن هذا المقياس أيضًا.

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

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

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

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

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


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