استدعاء الأدوات في واجهة OpenAI لبرمجة التطبيقات

يسمح لك استدعاء الأدوات بربط نماذج OpenAI بأدوات وأنظمة خارجية. هذا مفيد لأمور كثيرة، مثل تعزيز مساعدي AI بإمكانات، أو بناء تكاملات عميقة بين تطبيقاتك والنماذج اللغوية الكبيرة (LLM).

تعرّف على المزيد في دليل المطوّرين لاستدعاء الأدوات لدينا.

في يونيو 2024، أطلقنا المخرجات المنظَّمة. عند تشغيلها عبر ضبط strict: true في تعريف الدالة لديك، تضمن المخرجات المنظَّمة أن تطابق الوسائط التي ينشئها النموذج لاستدعاء دالة مخطط JSON الذي قدّمته في تعريف الدالة تمامًا.

في أكتوبر 2024، أطلقنا ميزة «إنشاء أي شيء»، التي تتيح للمطوّرين وصف دالة أو لصقها مباشرةً أو لصق التعليمات البرمجية الخاصة بك وإنشاء مخطط دالة صالح. تعرّف على المزيد حول «إنشاء أي شيء» في مقالة مركز المساعدة هنا

كيف يمكنني استخدام استدعاء الأدوات؟

استدعاء الأدوات مفيد لعدد كبير من حالات الاستخدام، مثل:

• تمكين المساعدين من جلب البيانات:

• تمكين المساعدين من اتخاذ إجراءات:

• تمكين المساعدين من إجراء عمليات حسابية:

• بناء مسارات عمل غنية:

• مسار معالجة لاستخراج البيانات يجلب نصًا خامًا، ثم يحوّله إلى بيانات منظَّمة ويحفظه في قاعدة بيانات.

يُدعَم استدعاء الأدوات في واجهة برمجة تطبيقات Responses، التي توحّد الإمكانات التي كانت مقسّمة سابقًا بين واجهة برمجة تطبيقات إكمال المحادثات وواجهة برمجة تطبيقات Assistants.

كيف يمكنني استخدام وضع JSON؟

عند تشغيل وضع JSON، يتم ضمان أن تكون مخرجات النموذج بصيغة JSON صالحة، باستثناء بعض الحالات الطرفية التي ينبغي عليك اكتشافها والتعامل معها على نحو مناسب.

لطلب وضع JSON باستخدام واجهة برمجة تطبيقات إكمال المحادثات، اضبط response_format على { "type": "json_object" } في النماذج المدعومة. باستخدام واجهة برمجة تطبيقات Responses، اضبط text.format على { "type": "json_object" }، مثلًا text: { "format": { "type": "json_object" } }، حيثما ينطبق ذلك. في أيٍّ من واجهتَي برمجة التطبيقات، لا يعمل وضع JSON إلا عند استيفاء المتطلبات المسبقة للنموذج/الرسالة/الأداة (مثلًا، أن يدعم النموذج json_object، وأن تتضمن المحادثة تعليمات لإنتاج JSON، وأن تكون أي قيود للأدوات متوافقة). يجب أن تحتوي رسالة طلب واحدة على الأقل أو رسالة إدخال واحدة في سياق الإدخال الفعّال على json بصيغة غير حساسة لحالة الأحرف، مثل JSON أو json أو Json؛ وإلا فستُرجع واجهة برمجة التطبيقات خطأً. في Responses، لا يكفي حقل التعليمات ذي المستوى الأعلى وحده لاجتياز هذا التحقق. عند استخدام استدعاء الأدوات على نماذج/مسارات متوافقة، تُطبَّق قيود JSON تلقائيًا على وسائط استدعاء الدالة؛ وقد تُرفض النماذج غير المتوافقة أو مجموعات الأدوات/تنسيق الاستجابة غير المتوافقة، أو قد لا تستخدم أخذ عينات مقيَّدًا بـ JSON.

ملاحظات مهمة:

• عند استخدام وضع JSON، يجب عليك دائمًا توجيه النموذج لإنتاج JSON عبر رسالة ما في المحادثة، مثلًا عبر رسالة النظام لديك. إذا لم تُدرج تعليمات صريحة لإنشاء JSON، فقد ينشئ النموذج دفقًا لا ينتهي من المسافات البيضاء، وقد يستمر الطلب في العمل إلى أن يصل إلى حد الرموز. للمساعدة في ضمان ألا تنسى ذلك، يرفض وضع JSON الطلبات ما لم تتضمن رسائل الإدخال أو التعليمات ذات الصلة كلمة json بشكل ما، دون حساسية لحالة الأحرف.

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

• يجب أن يكتشف تطبيقك الحالات الطرفية التي قد تؤدي إلى ألا تكون مخرجات النموذج كائن JSON كاملًا وأن يتعامل معها (انظر أدناه)