يسهّل عليك استدعاء الدوال الحصول على مخرجات البيانات المنظَّمة من النماذج التوليدية. يمكنك بعد ذلك استخدام هذه المخرجات لاستدعاء واجهات برمجة تطبيقات أخرى وعرض بيانات الاستجابة ذات الصلة إلى النموذج. بعبارة أخرى، يساعدك استدعاء الدوال في ربط النماذج التوليدية بالأنظمة الخارجية بحيث يشتمل المحتوى الذي يتم إنشاؤه على أحدث المعلومات وأكثرها دقة.
يمكنك تقديم أوصاف للوظائف لنماذج Gemini. هذه هي الدوال التي تكتبها بلغة تطبيقك (أي أنها ليست دوال Cloud). قد يطلب منك النموذج استدعاء دالة وإرسال النتيجة لمساعدة النموذج في التعامل مع استعلامك.
يمكنك الاطّلاع على مزيد من المعلومات حول استدعاء الدوال ضمن مستندات Google Cloud.
قبل البدء
ننصحك بالرجوع إلى دليل البدء حول حِزم تطوير البرامج (SDK) الخاصة بـ Vertex AI for Firebase إذا لم يسبق لك إجراء ذلك. تأكّد من القيام بكل ما يلي:
يمكنك إعداد مشروع جديد أو حالي في Firebase، بما في ذلك استخدام خطة أسعار Blaze وتفعيل واجهات برمجة التطبيقات المطلوبة.
يمكنك ربط تطبيقك بمنصة Firebase، بما في ذلك تسجيل تطبيقك وإضافة إعدادات Firebase إلى تطبيقك.
أضِف حزمة تطوير البرامج (SDK) وابدأ إعداد خدمة Vertex AI والنموذج التوليدي في تطبيقك.
ستتمكّن من طلب واجهة برمجة تطبيقات Gemini API بعد ربط تطبيقك بمنصة Firebase وإضافة حزمة تطوير البرامج (SDK) وإعداد خدمة Vertex AI والنموذج التوليدي.
إعداد استدعاء الدالة
بالنسبة إلى هذا البرنامج التعليمي، سيكون بإمكان النموذج التفاعل مع واجهة برمجة تطبيقات افتراضية لتبادل العملات والتي تتيح استخدام المَعلمات التالية:
| المَعلمة | Type | مطلوب | الوصف |
|---|---|---|---|
currencyFrom |
سلسلة | نعم | العملة المطلوب التحويل منها |
currencyTo |
سلسلة | نعم | العملة المطلوب تحويلها إليها |
مثال على طلب البيانات من واجهة برمجة التطبيقات
{
"currencyFrom": "USD",
"currencyTo": "SEK"
}
مثال على ردّ من واجهة برمجة التطبيقات
{
"base": "USD",
"rates": {"SEK": 10.99}
}
الخطوة 1: إنشاء الدالة التي تنشئ طلب واجهة برمجة التطبيقات
إذا لم تكن قد قمت بذلك بالفعل، فابدأ بإنشاء الدالة التي تقوم بإنشاء طلب واجهة برمجة التطبيقات.
ولأغراض التوضيح في هذا البرنامج التعليمي، فبدلاً من إرسال طلب حقيقي من واجهة برمجة التطبيقات، سيتم عرض القيم ذات الترميز الثابت بالتنسيق نفسه الذي تعرضه واجهة برمجة التطبيقات الفعلية.
الخطوة 2: إنشاء بيان دالة
أنشِئ بيان الدالة الذي ستنقله إلى النموذج التوليدي (الخطوة التالية في هذا البرنامج التعليمي).
وعليك تضمين أكبر قدر ممكن من التفاصيل في أوصاف الدوال والمعلَمات. يستخدم النموذج التوليدي هذه المعلومات لتحديد الدالة التي يجب اختيارها وكيفية توفير قيم للمعلَمات في استدعاء الدالة.
الخطوة 3: تحديد بيان الدالة أثناء إعداد النموذج
حدِّد تعريف الدالة عند إعداد النموذج التوليدي من خلال
ضبط معلَمة tools للنموذج:
تعرَّف على كيفية اختيار نموذج Gemini واختيار موقع جغرافي مناسب لحالة الاستخدام والتطبيق.
الخطوة 4: إنشاء استدعاء دالة
يمكنك الآن مطالبة النموذج بالدالة المحددة.
الطريقة الموصى بها لاستخدام استدعاء الدوال هي واجهة الدردشة، لأنّ استدعاءات الدوال تناسب بشكل جيد بنية المحادثة المتعددة الأدوار.
ما هي الإجراءات الإضافية التي يمكنك تنفيذها؟
تجربة إمكانات أخرى لواجهة Gemini API
- إنشاء محادثات متعددة الأدوار (محادثة)
- أنشِئ نصًا من الطلبات النصية فقط.
- يمكنك إنشاء نص باستخدام الطلبات المتعدّدة الوسائط (بما في ذلك النصوص والصور وملفات PDF والفيديوهات والصوت).
التعرّف على طريقة التحكّم في إنشاء المحتوى
- فهم تصميم الطلب، بما في ذلك أفضل الممارسات والاستراتيجيات وأمثلة الطلبات.
- ضبط معلَمات النموذج، مثل درجة الحرارة والرموز المميّزة للمخرجات القصوى
- استخدِم إعدادات الأمان لضبط احتمالية تلقّي ردود يمكن اعتبارها ضارة.
مزيد من المعلومات حول نماذج Gemini
تعرَّف على مزيد من المعلومات حول النماذج المتاحة لحالات الاستخدام المختلفة وأسعارها وأسعارها.تقديم ملاحظات حول تجربتك مع Vertex AI for Firebase