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

# مراجعات وكيل مستقلة

> اطلب مراجعة بشرية، واجمع قرارات مميزة، وطبق النتيجة النهائية في تطبيقك.

تسجل موافقات الوكيل القرارات البشرية بشأن إجراء وكيل مقترح في بيئة عمل واحدة. وهي منفصلة عن موافقات محرك سير العمل، ومنح الأذونات، وإيصالات الإجراءات التشفيرية، وتنفيذ Temporal.

## قبل أن تبدأ

* استخدم وكيلًا نشطًا من نفس مساحة العمل والبيئة مثل بيانات الاعتماد الخاصة بك.
* إنشاء طلبات باستخدام مفتاح API لمساحة العمل أو مستخدم مساحة عمل مسجل الدخول.
* يجب أن يكون المراجعون أعضاء نشطين في مساحة العمل البشرية ولديهم إذن `tenant:governance:approve` على مستوى مساحة العمل. الدور الخاص بالمؤسسة فقط غير كافٍ.
* لا يمكن للمُرسِل الموافقة على طلبه أو رفضه. يمكن لكل مراجع أن يقرر مرة واحدة. لا يمكن لمفاتيح API الإدلاء بأصوات بشرية.

في Console، افتح **AI Agents → Agent Approvals**. تحتوي نماذج الطلب والمراجعة والإلغاء على صفحة مخصصة لكل منها. احفظ رابط الطلب للعودة إليه بعد أن يغادر قائمة الانتظار المعلقة.

## إنشاء طلب

يطلب هذا المثال موافقتين مستقلتين في نافذة مدتها ساعة واحدة. استبدل معرف الوكيل بوكيل sandbox موجود؛ لا يمكن استخدام وكيل إنتاج مع بيانات اعتماد sandbox.

```bash theme={null}
curl --fail-with-body https://sandbox-api.truthlocks.com/v1/approvals \
  -H "X-API-Key: $TRUTHLOCKS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
    "agent_id": "YOUR_SANDBOX_AGENT_ID",
    "action": "publish reviewed report",
    "resource": "reports/quarterly-review",
    "scope": "reports:publish",
    "risk_level": "high",
    "justification": "The report has completed technical review. Confirm the approved version before publication.",
    "required_approvals": 2,
    "ttl_minutes": 60
  }'
```

يحتوي رد `201` على `id`، و`requested_by`، و`status: "pending"`، و`current_approvals: 0`، و`expires_at`. احفظ `id`؛ لا يؤدي الإنشاء إلى نشر التقرير أو إنشاء سير عمل في الخلفية.

## المراجعة مع جلسة بشرية

استخدم Console للقرارات التفاعلية. إذا كان تكاملك يستخدم واجهة برمجة التطبيقات، فقدم جلسة حامل مساحة عمل المراجع قصيرة الأجل. لا تستبدل مفتاح API أو تضمّن رمز جلسة في التعليمات البرمجية المصدر.

```bash theme={null}
curl --fail-with-body "https://sandbox-api.truthlocks.com/v1/approvals/$APPROVAL_ID/approve" \
  -H "Authorization: Bearer $TRUTHLOCKS_REVIEWER_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"reason":"Reviewed the exact report version and its supporting evidence."}'
```

الموافقة الأولى في هذا المثال تعيد `status: "pending"` و `current_approvals: 1`. يجب أن يقدم مراجع معتمد مختلف الصوت الثاني. إعادة استخدام نفس المراجع يعيد تعارضًا. رفض واحد يغير الطلب فورًا إلى `rejected` بغض النظر عن الموافقات السابقة.

تتحقق الخدمة من أذونات العضوية الحالية، وملكية الطلب، وتاريخ الانتهاء، والأصوات الموجودة داخل معاملة القرار. تلتزم الأصوات وحدث التدقيق معًا. لا يمكن تعديل القرارات أو حذفها من خلال واجهات برمجة التطبيقات هذه.

## التحقق من النتيجة وتطبيقها

```bash theme={null}
curl --fail-with-body "https://sandbox-api.truthlocks.com/v1/approvals/$APPROVAL_ID" \
  -H "X-API-Key: $TRUTHLOCKS_API_KEY"
```

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

| الحالة | المعنى |
| - | - |
| `pending` | مطلوب المزيد من الموافقات المستقلة. |
| `approved` | تم الوصول إلى النصاب القانوني المحدد ضمن نافذة المراجعة. |
| `rejected` | رفض مراجع مستقل الطلب. |
| `expired` | تجاوز طلب معلق موعد مراجعته النهائي. |
| `cancelled` | ألغاه طالبه الأصلي. |

يحدد الموعد النهائي للمراجعة متى يمكن تقديم القرارات. لا يحول طلبًا تمت الموافقة عليه بالفعل إلى رمز وصول منتهي الصلاحية. حدد أي موعد نهائي للتنفيذ في تطبيقك الخاص.

## قائمة الانتظار والإلغاء والأخطاء

`GET /v1/approvals` يعيد مصفوفة تتكون من 100 طلب معلق وغير منتهي الصلاحية كحد أقصى. لا يحتوي على ترقيم صفحات أو مرشح حالة تاريخية. يتجاهل قائمة الانتظار سجل القرار الفردي؛ استرجع طلبًا حسب المعرف لذلك السجل.

يمكن للمُرسِل الأصلي إرسال `POST /v1/approvals/{approvalID}/cancel` مع `reason` غير فارغ. لا يمكن إعادة فتح الطلب بعد الإلغاء أو الرفض أو الموافقة أو انتهاء الصلاحية. أنشئ طلبًا جديدًا إذا تغير الإجراء المقترح.

| حالة HTTP | ما يجب التحقق منه |
| - | - |
| `400` | حدود الحقول، معرف طلب UUID، وسبب قرار غير فارغ. |
| `403` | إذن مراجع مساحة العمل الحالي، المراجعة الذاتية للمُطالب، التصويت بمفتاح API، أو ملكية الإلغاء. |
| `404` | ينتمي الطلب أو الوكيل النشط إلى بيئة مساحة العمل المحددة. |
| `409` | الطلب نهائي أو منتهي الصلاحية أو قام هذا الشخص بالتصويت بالفعل. |

تدعم هذه السجلات عملية المراجعة الخاصة بك؛ ولا تثبت امتثال SOC 2، أو شهادة ISO، أو التحقق من وثيقة الهوية، أو صحة الأدلة المقدمة.


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