العودة إلى الفهرس / أدوات الوكلاء
تعريف أداة دالة معتمدة للوكيل
إتاحة دالة تطبيق محدودة كأداة ذات عقد معاملات واضح.
الهدف
منح الوكيل أداة ذات مدخلات محددة ويمكن التنبؤ بها.
الخطوات
- حدّد أولاً المهمة الواحدة للأداة والآثار الجانبية المحظورة. [openai-tools]
- أتِح دالة محدودة عبر
@function_toolأو@toolواستخدم تلميحات أنواع Python أوBaseModelمن Pydantic لإنشاء مخطط المعاملات والتحقق منه. [openai-tools] - استخدم
Field(ge=..., le=...)للحدود العددية وLiteral[...]للاختيارات، وأعد فحص قيود الأعمال عند مدخل المعالج. [openai-tools] - سجّل الدالة فقط للوكلاء الذين يحتاجونها ووثّق وصفها الظاهر. [openai-tools]
- تحقق من المخطط وسلوك الرفض بمدخلات صالحة وناقصة وخارج الحدود. [openai-tools]
طريقة التحقق
تحقق من احتواء مخطط الأداة على الحقول المطلوبة ومن أن المدخلات غير الصالحة لا تسبب آثاراً جانبية.
معالجة الأعطال
إذا كان المخطط واسعاً جداً، فقسّم المهمة إلى أدوات أضيق وأعد التحقق عند حد الدالة.
الصلاحيات
المتطلبات السابقة
- Python 3.10+ وopenai-agents المتوافق مع المراجعة المثبتة وبيانات اعتماد مزود نموذج مصرح بها (باستثناء الاختبار الوهمي المحلي)
الصلاحيات
- استخدم بيئة محلية أو معزولة؛ وطبّق أقل الصلاحيات والموافقة للبيانات الخارجية أو الآثار الجانبية
القيود
يختلف سلوك SDK باختلاف الإصدار. قارن المراجعة المثبتة بالوكيل أو العميل المستخدم، ثم راجع الاحتفاظ بالبيانات والتفويض والآثار الجانبية قبل الإنتاج.
المصدر الأصلي المثبت
- المستودع
- openai/openai-agents-python
- مسار الملف
- docs/tools.md
- الإيداع المثبت
f53c62451c7f34c15f0c87fa745e05404025420f- تاريخ فحص المصدر
- 2026-10-14 · تمت المراجعة مقابل المصدر الأصلي المثبت
مقاييس المستودع
تعكس هذه القيم المستودع الأصلي كله، ولا تمثل إعجابات أو شعبية مهارة أو دليل منفرد.
- النجوم
- لم يُجمع
- التفرعات
- لم يُجمع
- وقت الرصد
- لم يُجمع
لا تتوفر لقطة مقاييس بعد.
الترخيص: MIT
الموضوع الرئيسي
انقل مساعد البرمجة من فهم السياق إلى التحقق من التغيير