استخدام 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": "USD",
  "currencyTo": "SEK"
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• إنشاء محادثات متعددة المقاطع (محادثة)
• إنشاء نص من الطلبات النصية فقط
• إنشاء نص من الطلبات المتعدّدة الوسائط (بما في ذلك النصوص والصور وملفات PDF والفيديو والصوت)

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

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

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

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