إضافة موافقة بشرية إلى أداة وكيل ذات آثار جانبية

إيقاف تشغيل الوكيل قبل تغيير خارجي كي يراجع شخص الإجراء المحدد ويوافق عليه.

الهدف

جعل استدعاءات الأدوات التي تتطلب حكماً بشرياً تنتظر قبل أي أثر جانبي.

أدرج الأدوات التي تكتب البيانات أو ترسلها أو تحذفها ضمن سياسة الموافقة. [openai-human] [openai-tools]
اضبط @function_tool(needs_approval=True) على الأداة أو سياسة منطقية حسب المعاملات كي يتوقف Runner قبل التنفيذ. [openai-human] [openai-tools]
افحص result.interruptions ثم استدعِ state=result.to_state() واعرض للمراجع اسم الأداة ومعاملاتها وهدفها. [openai-human] [openai-tools]
استدعِ state.approve(interruption) للموافقة الصريحة فقط واستخدم state.reject(...) للرفض ثم await Runner.run(agent, state). [openai-human] [openai-tools]
استخدم أداة وهمية للتحقق من أن الموافقة تنفذ والرفض لا ينفذ وأن الإجراء المراجع يطابق المعاملات الفعلية. [openai-human] [openai-tools]

في بيئة اختبار، وافق وارفض مرة؛ يجب أن يستدعي المسار الموافق عليه وحده دالة الأثر الجانبي.

إذا لم يتوقف التنفيذ للموافقة، فتحقق من آلية الموافقة في SDK ومن أن الأداة لم تعمل قبل نقطة التوقف.

Python 3.10+ وopenai-agents المتوافق مع المراجعة المثبتة وبيانات اعتماد مزود نموذج مصرح بها (باستثناء الاختبار الوهمي المحلي)

استخدم بيئة محلية أو معزولة؛ وطبّق أقل الصلاحيات والموافقة للبيانات الخارجية أو الآثار الجانبية

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

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

لا تتوفر لقطة مقاييس بعد.

الترخيص: MIT