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

قبل أن تبدأ

  • استخدم وكيلًا نشطًا من نفس مساحة العمل والبيئة مثل بيانات الاعتماد الخاصة بك.
  • إنشاء طلبات باستخدام مفتاح API لمساحة العمل أو مستخدم مساحة عمل مسجل الدخول.
  • يجب أن يكون المراجعون أعضاء نشطين في مساحة العمل البشرية ولديهم إذن tenant:governance:approve على مستوى مساحة العمل. الدور الخاص بالمؤسسة فقط غير كافٍ.
  • لا يمكن للمُرسِل الموافقة على طلبه أو رفضه. يمكن لكل مراجع أن يقرر مرة واحدة. لا يمكن لمفاتيح API الإدلاء بأصوات بشرية.
في Console، افتح AI Agents → Agent Approvals. تحتوي نماذج الطلب والمراجعة والإلغاء على صفحة مخصصة لكل منها. احفظ رابط الطلب للعودة إليه بعد أن يغادر قائمة الانتظار المعلقة.

إنشاء طلب

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

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

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

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

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

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

GET /v1/approvals يعيد مصفوفة تتكون من 100 طلب معلق وغير منتهي الصلاحية كحد أقصى. لا يحتوي على ترقيم صفحات أو مرشح حالة تاريخية. يتجاهل قائمة الانتظار سجل القرار الفردي؛ استرجع طلبًا حسب المعرف لذلك السجل. يمكن للمُرسِل الأصلي إرسال POST /v1/approvals/{approvalID}/cancel مع reason غير فارغ. لا يمكن إعادة فتح الطلب بعد الإلغاء أو الرفض أو الموافقة أو انتهاء الصلاحية. أنشئ طلبًا جديدًا إذا تغير الإجراء المقترح. تدعم هذه السجلات عملية المراجعة الخاصة بك؛ ولا تثبت امتثال SOC 2، أو شهادة ISO، أو التحقق من وثيقة الهوية، أو صحة الأدلة المقدمة.