استخدام Gemini API لطلب الوظائف


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

يمكنك تزويد نماذج Gemini بأوصاف الدوالّ. وهي الدوال التي تكتبها بلغة تطبيقك (أي أنها ليست Cloud Functions). قد يطلب منك النموذج استدعاء دالة ثم إرجاعها النتيجة لمساعدة النموذج في التعامل مع استعلامك.

يمكنك مزيد من المعلومات حول استدعاء الدوال في وثائق Google Cloud.

قبل البدء

يُرجى إكمال دليل بدء استخدام حِزم تطوير البرامج (SDK) لنظام التشغيل Vertex AI in Firebase إذا لم يسبق لك ذلك. تأكَّد من تنفيذ كلّ ما يلي:

  1. يمكنك إعداد مشروع جديد أو حالي في Firebase، بما في ذلك استخدام خطة أسعار Blaze وتفعيل واجهات برمجة التطبيقات المطلوبة

  2. ربط تطبيقك بمنصّة Firebase، بما في ذلك تسجيل تطبيقك وإضافة إعدادات Firebase إلى تطبيقك

  3. أضِف حزمة تطوير البرامج (SDK) وابدأ إعداد خدمة Vertex AI والنموذج التوليدي في تطبيقك.

بعد ربط تطبيقك بمنصّة Firebase وإضافة حزمة تطوير البرامج (SDK) وإعداد Vertex AI الخدمة والنموذج التوليدي، أصبحت جاهزًا للاتصال بـ Gemini API.

إعداد طلب دالة

في هذا الدليل التعليمي، ستجعل النموذج يتفاعل مع واجهة برمجة تطبيقات افتراضية لخدمات تبادل العملات تتوافق مع المَعلمات التالية:

المعلمة النوع مطلوب الوصف
currencyFrom السلسلة نعم العملة المطلوب التحويل منها
currencyTo السلسلة نعم العملة المطلوب تحويلها إليها

مثال على طلب البيانات من واجهة برمجة التطبيقات

{
  "currencyFrom": "USD",
  "currencyTo": "SEK"
}

مثال على ردّ من واجهة برمجة التطبيقات

{
  "base": "USD",
  "rates": {"SEK": 10.99}
}

الخطوة 1: إنشاء الدالة التي تقدّم طلب واجهة برمجة التطبيقات

ابدأ بإنشاء الدالة التي تقدّم طلبًا إلى واجهة برمجة التطبيقات إذا لم يسبق لك ذلك.

لأغراض توضيحية في هذا الدليل التعليمي، بدلاً من إرسال طلب واجهة برمجة تطبيقات حقيقي، ستُعرِض قيمًا مُبرمَجة بشكل ثابت بالتنسيق نفسه الذي ستُعرِضه واجهة برمجة تطبيقات فعلية.

الخطوة 2: إنشاء بيان دالة

أنشئ بيان الدالة الذي ستمرره إلى النموذج التوليدي (الخطوة التالية في هذا الدليل التعليمي).

وعليك تضمين أكبر قدر ممكن من التفاصيل في أوصاف الدوال والمعلَمات. يستخدم النموذج التوليدي هذه المعلومات لتحديد الدالة التي سيتم اختيارها وكيفية تقديم قيم للمَعلمات في طلب الدالة.

الخطوة 3: تحديد بيان الدالة أثناء إعداد النموذج

حدِّد بيان الدالة عند بدء تشغيل النموذج التوليدي من خلال ضبط المَعلمة tools للنموذج:

تعرَّف على كيفية اختيار نموذج Gemini وموقع جغرافي اختياريًا مناسبَين لحالة الاستخدام والتطبيق.

الخطوة 4: إنشاء استدعاء دالة

يمكنك الآن مطالبة النموذج بالدالة المحددة.

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

ما هي الإجراءات الإضافية التي يمكنك تنفيذها؟

تجربة إمكانات أخرى في Gemini API

التعرّف على كيفية التحكّم في إنشاء المحتوى

يمكنك أيضًا تجربة الطلبات وعمليات ضبط النماذج باستخدام Vertex AI Studio

مزيد من المعلومات حول طُرز Gemini

اطّلِع على مزيد من المعلومات عن النماذج المتاحة لحالات الاستخدام المختلفة واطلاعك على الحصص والأسعار.


تقديم ملاحظات حول تجربتك مع Vertex AI in Firebase