دليل الدخل بالوكلاءموارد عامة مجانية
中文 EN العربية

العودة إلى الفهرس / أدوات الوكلاء

تعريف أداة دالة معتمدة للوكيل

إتاحة دالة تطبيق محدودة كأداة ذات عقد معاملات واضح.

الهدف

منح الوكيل أداة ذات مدخلات محددة ويمكن التنبؤ بها.

الخطوات

  1. حدّد أولاً المهمة الواحدة للأداة والآثار الجانبية المحظورة. [openai-tools]
  2. أتِح دالة محدودة عبر @function_tool أو @tool واستخدم تلميحات أنواع Python أو BaseModel من Pydantic لإنشاء مخطط المعاملات والتحقق منه. [openai-tools]
  3. استخدم Field(ge=..., le=...) للحدود العددية وLiteral[...] للاختيارات، وأعد فحص قيود الأعمال عند مدخل المعالج. [openai-tools]
  4. سجّل الدالة فقط للوكلاء الذين يحتاجونها ووثّق وصفها الظاهر. [openai-tools]
  5. تحقق من المخطط وسلوك الرفض بمدخلات صالحة وناقصة وخارج الحدود. [openai-tools]

طريقة التحقق

تحقق من احتواء مخطط الأداة على الحقول المطلوبة ومن أن المدخلات غير الصالحة لا تسبب آثاراً جانبية.

معالجة الأعطال

إذا كان المخطط واسعاً جداً، فقسّم المهمة إلى أدوات أضيق وأعد التحقق عند حد الدالة.

الصلاحيات

المتطلبات السابقة

الصلاحيات

القيود

يختلف سلوك SDK باختلاف الإصدار. قارن المراجعة المثبتة بالوكيل أو العميل المستخدم، ثم راجع الاحتفاظ بالبيانات والتفويض والآثار الجانبية قبل الإنتاج.

المصدر الأصلي المثبت

https://github.com/openai/openai-agents-python/blob/f53c62451c7f34c15f0c87fa745e05404025420f/docs/tools.md

المستودع
openai/openai-agents-python
مسار الملف
docs/tools.md
الإيداع المثبت
f53c62451c7f34c15f0c87fa745e05404025420f
تاريخ فحص المصدر
2026-10-14 · تمت المراجعة مقابل المصدر الأصلي المثبت

مقاييس المستودع

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

النجوم
لم يُجمع
التفرعات
لم يُجمع
وقت الرصد
لم يُجمع

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

الترخيص: MIT

الموضوع الرئيسي

انقل مساعد البرمجة من فهم السياق إلى التحقق من التغيير

موارد ذات صلة