Skip to main content
يتيح استدعاء الدوال للنموذج اختيار استدعاءات أدوات مُهيكلة يمكن لتطبيقك تنفيذها. لا يشغّل النموذج الدالة بنفسه، بل يُعيد اسم الدالة ومعامِلاتها، ثم يشغّل الكود لديك الدالة، ثم ترسل النتيجة مرة أخرى إلى النموذج. استخدم استدعاء الدوال عندما يحتاج النموذج إلى بيانات حيّة، أو إجراءات في التطبيق، أو استعلامات قاعدة بيانات، أو حسابات حتمية.

تعريف الأداة الأساسي

عرّف الأدوات باستخدام مصفوفة tools المتوافقة مع OpenAI:

تنفيذ الأداة

عندما يختار النموذج أداة، افحص message.tool_calls، وحلّل المعامِلات، ونفّذ دالة تطبيقك، ثم أرسل النتيجة مرة أخرى بوصفها رسالة tool.
Python

اختيار النموذج

يعتمد دعم استدعاء الدوال على النموذج. استخدم صفحة النماذج النصية أو واجهة برمجة تطبيقات النماذج للعثور على النماذج التي تحمل supportsFunctionCalling.
تعامَل مع معامِلات الأدوات على أنها مدخلات غير موثوقة. تحقّق من صحّة المعامِلات قبل استخدامها في استعلامات قاعدة البيانات، أو أوامر الصدَفة، أو المدفوعات، أو أي عمليات ذات آثار جانبية.

خطوة أبعد

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

نصائح للتصميم

  • اجعل أسماء الأدوات وأوصافها قصيرة وحرفية.
  • استخدم JSON Schema لتسهيل إنتاج معامِلات صحيحة من قِبل النموذج.
  • فضّل الأدوات الضيّقة ذات المدخلات الواضحة على أداة واحدة عريضة ذات سلوكيات اختيارية كثيرة.
  • أعِد نتائج أدوات موجزة بحيث يمتلك الجواب النهائي سياقًا كافيًا دون هدر الرموز.

موارد ذات صلة