استدعاء الدوال

كيف يربط استدعاء الدوال النموذج بأدوات نظامك؟

استدعاء الدوال يسمح للنموذج بطلب تنفيذ وظيفة في نظامك بدل تخمين الإجابة: تصف الأدوات بمخطط JSON، فيعيد النموذج اسم الأداة والوسائط، ويقوم كودك بالتنفيذ ثم يعيد النتيجة إليه. في Plugsky يعمل هذا عبر واجهة متوافقة مع OpenAI مع البث ووضع JSON وأكثر من 30 نموذجاً.

Key facts

استدعاء الدوالمتاح (Live)
الصيغةمتوافقة مع tools/functions في OpenAI
البثمدعوم
وضع JSONمدعوم
النماذجأكثر من 30 نموذجاً — تحقق من مصفوفة القدرات
التحقق من المخططمسؤولية تطبيقك قبل تنفيذ أي أداة
الخطة المجانيةنموذجان مجانيان دون بطاقة
الحالةمتاح (Live)

TL;DR

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

How it works, step by step

  1. اكتب دالة واحدة بسيطة قابلة للاختبار أولاً.
  2. عرّف مخطط الأداة مع وصف يوضح متى تُستخدم.
  3. مرّر الأدوات في الطلب واحصل على نداء الدالة.
  4. تحقق من الوسائط ونفّذ الدالة في خدمتك.
  5. أعد النتيجة إلى النموذج للحصول على الرد النهائي.
  6. أضف حدوداً ومهلاً زمنياً وتسجيلاً لكل استدعاء.
  7. وسّع الأدوات تدريجياً بعد ثبات النمط.
1اكتب دالة واحدةبسيطة قابلةللاختبار أولاً.2عرّف مخطط الأداة معوصف يوضح متىتُستخدم.3مرّر الأدوات فيالطلب واحصل علىنداء الدالة.4تحقق من الوسائطونفّذ الدالة فيخدمتك.5أعد النتيجة إلىالنموذج للحصول علىالرد النهائي.6أضف حدوداً ومهلاًزمنياً وتسجيلاً لكلاستدعاء.

Try it yourself

افتح أداة اختبار استدعاء الدوال →

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

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

تعريف أدوات آمنة

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

أنماط تنفيذ وأخطاء شائعة

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

Honest comparison

القدرةPlugskyمزوّد متوافق آخربناء داخلي
استدعاء الدوالمتاح بصيغة OpenAIيتفاوتتنفيذه بنفسك
البثمدعوميتفاوتتنفيذه بنفسك
وضع JSONمدعومغالباً مدعومتتحقق يدوياً
النماذجأكثر من 30 نموذجاًحسب الكتالوجتستضيف كل نموذج
جهد الترحيلسطر واحديتفاوتأسابيع

Frequently asked questions

هل استدعاء الدوال متاح؟

نعم، وهو متاح (Live) بصيغة متوافقة مع OpenAI مع الأدوات والوسائط.

هل يمكن استدعاء أكثر من أداة؟

يمكن للنموذج طلب عدة نداءات في دور واحد حسب النموذج؛ تحقق من مصفوفة القدرات واختبر مسارك.

هل يتوافق مع البث؟

نعم، البث مدعوم ويمكن دمجه مع استدعاء الدوال في التطبيق نفسه.

كيف أحمي نظامي من نداءات خاطئة؟

تحقق من الوسائط وحدّد الصلاحيات، ولا تنفّذ أي عملية حساسة دون تحقق إضافي.

هل وضع JSON بديل مناسب؟

استخدم وضع JSON عندما تحتاج مخرجات منظمة بلا تنفيذ أدوات؛ وكلاهما مدعوم.

هل الانتقال من OpenAI مكلف؟

لا، الصيغة متوافقة؛ غيّر عنوان URL الأساسي واحتفظ بمنطق الأدوات.

كيف أبدأ؟

أنشئ حساباً، عرّف أداة واحدة، وجرّبها عبر الأداة التفاعلية ثم راجع صفحة الأسعار عند التوسع.

هل تدعم النماذج طريقة الأدوات المتوازية؟

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