يسهّل استدعاء الدوال الحصول على مخرجات البيانات المنظَّمة من النماذج التوليدية يمكنك بعد ذلك استخدام هذه المخرجات لطلب واجهات برمجة تطبيقات أخرى وعرض بيانات الاستجابة ذات الصلة بالنموذج. بعبارة أخرى، يساعد استدعاء الدوال تربط النماذج التوليدية بالأنظمة الخارجية، بحيث يتم يتضمن أحدث المعلومات وأكثرها دقة.
يمكنك تقديم أوصاف للوظائف لنماذج Gemini. وهي الدوال التي تكتبها بلغة تطبيقك (أي أنها ليست وظائف السحابة الإلكترونية). قد يطلب منك النموذج استدعاء دالة ثم إرجاعها النتيجة لمساعدة النموذج في التعامل مع استعلامك.
يمكنك مزيد من المعلومات حول استدعاء الدوال في وثائق Google Cloud.
قبل البدء
إذا لم تكن قد قمت بذلك بالفعل، فاعمل على دليل البدء لحِزم تطوير البرامج (SDK) الخاصة بحزمة Vertex AI for Firebase تأكّد من القيام بكل ما يلي:
يمكنك إعداد مشروع جديد أو حالي في Firebase، بما في ذلك استخدام خطة أسعار Blaze وتفعيل واجهات برمجة التطبيقات المطلوبة
يمكنك ربط تطبيقك بمنصة Firebase، بما في ذلك تسجيل تطبيقك وإضافة تهيئة Firebase لتطبيقك.
إضافة حزمة تطوير البرامج (SDK) وإعداد خدمة Vertex AI والنموذج التوليدي في تطبيقك.
بعد ربط تطبيقك بمنصّة Firebase وإضافة حزمة تطوير البرامج (SDK) وإعداد وخدمة Vertex AI والنموذج التوليدي أصبح بإمكانك طلب واجهة برمجة تطبيقات Gemini
إعداد استدعاء الدالة
في هذا البرنامج التعليمي، ستكون قد تفاعلت مع النموذج مع عملة افتراضية واجهة برمجة تطبيقات Exchange التي تتوافق مع المَعلمات التالية:
| المعلمة | النوع | مطلوب | الوصف |
|---|---|---|---|
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