الانتقال مباشرةً إلى تعليمات نقل البيانات
لماذا يجب نقل البيانات لاستخدام حِزم تطوير البرامج (SDK) من Firebase AI Logic؟
ربما جرّبت مجموعة بديلة من حِزم تطوير البرامج (SDK) لبرامج الويب أو الأجهزة الجوّالة التي أتاحت لك الوصول إلى Gemini Developer API.
لم يتم دمج حِزم تطوير البرامج (SDK) الخاصة بالعملاء في منظومة Firebase المتكاملة والفعّالة التي تقدّم خدمات مهمة لتطبيقات الويب والأجهزة الجوّالة. وقد تم إيقافها نهائيًا لصالح حِزم تطوير البرامج (SDK) لعملاء Firebase AI Logic، والتي تتيح لك الوصول إلى Gemini Developer API.
ميزات الأمان لتطبيقات الويب والأجهزة الجوّالة
بالنسبة إلى تطبيقات الويب والأجهزة الجوّالة، يُعدّ الأمان أمرًا بالغ الأهمية ويتطلّب مراعاة اعتبارات خاصة لأنّ الرمز البرمجي، بما في ذلك الطلبات المرسَلة إلى Gemini API، يتم تشغيله في بيئة غير محمية. يمكنك استخدام Firebase App Check لحماية واجهات برمجة التطبيقات من إساءة الاستخدام من قِبل العملاء غير المصرّح لهم.
عند استخدام Firebase App Check مع Firebase AI Logic، لا تتم إضافة مفتاح واجهة برمجة التطبيقات Gemini لـ Gemini Developer API مباشرةً إلى قاعدة الرموز البرمجية لتطبيق الويب أو التطبيق المتوافق مع الأجهزة الجوّالة. بدلاً من ذلك، يظل مفتاح واجهة برمجة التطبيقات Gemini على الخادم، ولا يتم الكشف عنه للجهات المسيئة.
منظومة متكاملة مصمَّمة لتطبيقات الويب والأجهزة الجوّالة
Firebase هي منصّة Google لتطوير تطبيقات الويب والأجهزة الجوّالة. يعني استخدام Firebase AI Logic أنّ تطبيقاتك في منظومة متكاملة تركّز على احتياجات التطبيقات والمطوّرين المتكاملين. على سبيل المثال:
يمكنك ضبط إعدادات وقت التشغيل ديناميكيًا أو تبديل القيم في تطبيقك (مثل اسم النموذج وإصداره) بدون إصدار نسخة جديدة من التطبيق باستخدام Firebase Remote Config.
استخدِم Cloud Storage for Firebase لتضمين ملفات كبيرة في طلباتك المتعددة الوسائط (إذا كنت تستخدم Agent Platform Gemini API (formerly Vertex AI)). تساعدك حِزم تطوير البرامج (SDK) لبرنامج Cloud Storage في التعامل مع عمليات تحميل الملفات وتنزيلها (حتى في ظروف الشبكة السيئة) وتوفير المزيد من الأمان لبيانات المستخدمين النهائيين. يمكنك الاطّلاع على مزيد من المعلومات في دليل الحلول حول استخدام Cloud Storage for Firebase.
إدارة البيانات المنظَّمة باستخدام حِزم تطوير البرامج (SDK) لقواعد البيانات المصمَّمة للتطبيقات المتوافقة مع الأجهزة الجوّالة والويب (مثل Cloud Firestore)
نقل البيانات إلى حِزم تطوير البرامج (SDK) من Firebase AI Logic
نظرة عامة على خطوات نقل البيانات إلى حِزم تطوير البرامج (SDK) في Firebase AI Logic:
الخطوة 1: إعداد مشروع جديد أو حالي على Firebase وربط تطبيقك بـ Firebase
الخطوة 2: أضِف حزم تطوير البرامج (SDK) الخاصة بـ Firebase AI Logic إلى تطبيقك.
الخطوة 3: عدِّل عمليات الاستيراد والتهيئة في تطبيقك.
الخطوة 4: عدِّل الرمز البرمجي استنادًا إلى الميزات التي تستخدمها.
الخطوة 1: إعداد مشروع Firebase وربط تطبيقك
سجِّل الدخول إلى وحدة تحكّم Firebase، ثم اختَر مشروعك على Firebase.
في وحدة تحكّم Firebase، انتقِل إلى خدمات الذكاء الاصطناعي > AI Logic.
انقر على البدء لإطلاق سير عمل موجَّه يساعدك في إعداد واجهات برمجة التطبيقات المطلوبة والموارد لمشروعك.
انقر على Gemini Developer API. يمكنك دائمًا إعداد واستخدام موفّر واجهة برمجة التطبيقات الآخر لاحقًا، إذا أردت.
ستفعّل وحدة التحكّم واجهات برمجة التطبيقات المطلوبة وتنشئ مفتاح واجهة برمجة تطبيقات Gemini جديدًا ومخصّصًا في مشروعك.
يُرجى عدم إضافة مفتاح واجهة برمجة التطبيقات الجديد في Gemini إلى قاعدة الرموز البرمجية لتطبيقك. مزيد من المعلوماتإذا طُلب منك ذلك في سير عمل وحدة التحكّم، اتّبِع التعليمات الظاهرة على الشاشة لتسجيل تطبيقك وربطه بمنصّة Firebase.
يُرجى مواصلة قراءة دليل نقل البيانات هذا لتحديث المكتبة وعملية الإعداد في تطبيقك.
الخطوة 2: إضافة حزمة تطوير البرامج (SDK) لـ Firebase AI Logic إلى تطبيقك
بعد إعداد مشروع Firebase وربط تطبيقك بمنصة Firebase (راجِع الخطوة السابقة)، يمكنك الآن إضافة حزمة تطوير البرامج (SDK) الخاصة بـ Firebase AI Logic إلى تطبيقك.
Swift
استخدِم Swift Package Manager لتثبيت تبعيات Firebase وإدارتها. تعرَّف على خيارات التثبيت الأخرى، إذا لزم الأمر.
تتيح مكتبة Firebase AI Logic الوصول إلى واجهات برمجة التطبيقات للتفاعل مع نماذج Gemini. يتم تضمين المكتبة كجزء من حزمة تطوير البرامج (SDK) لمنصّة Firebase على أنظمة Apple الأساسية (firebase-ios-sdk).
إذا كنت تستخدم Firebase حاليًا، تأكَّد من أنّ حزمة Firebase هي الإصدار 12.5.0 أو إصدار أحدث.
في Xcode، افتح مشروع تطبيقك، ثم انتقِل إلى ملف > إضافة موارد الاعتمادية للحزمة (File > Add Package Dependencies).
عندما يُطلب منك ذلك، أضِف مستودع حزمة تطوير البرامج (SDK) لمنصات Apple في Firebase:
https://github.com/firebase/firebase-ios-sdkاختَر أحدث إصدار من حزمة تطوير البرامج (SDK).
اختَر مكتبة
FirebaseAILogicومكتبةFirebaseAppCheck.
بعد الانتهاء، سيبدأ Xcode تلقائيًا في حلّ التبعيات وتنزيلها في الخلفية.
Kotlin
تتيح حزمة تطوير البرامج (SDK) لـ Firebase AI Logic على Android (الإصدار firebase-ai)
الوصول إلى واجهات برمجة التطبيقات للتفاعل مع نماذج Gemini.
في ملف Gradle للوحدة (على مستوى التطبيق)
(مثل <project>/<app-module>/build.gradle.kts)،
أضِف الاعتماديات لمكتبتَي Firebase AI Logic وApp Check
لنظام التشغيل Android. ننصح باستخدام
Firebase Android BoM
للتحكّم في إصدارات المكتبة.
dependencies { // ... other androidx dependencies // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:35.2.0")) // Add the dependencies for the Firebase AI Logic and App Check libraries // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-ai") implementation("com.google.firebase:firebase-appcheck-debug") }
باستخدام Firebase Android BoM، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase Android.
Java
تتيح حزمة تطوير البرامج (SDK) لـ Firebase AI Logic على Android (الإصدار firebase-ai)
الوصول إلى واجهات برمجة التطبيقات للتفاعل مع نماذج Gemini.
في ملف Gradle للوحدة (على مستوى التطبيق)
(مثل <project>/<app-module>/build.gradle.kts)،
أضِف الاعتماديات لمكتبتَي Firebase AI Logic وApp Check
لنظام التشغيل Android. ننصح باستخدام
Firebase Android BoM
للتحكّم في إصدارات المكتبة.
بالنسبة إلى Java، عليك إضافة مكتبتَين إضافيتَين.
dependencies { // ... other androidx dependencies // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:35.2.0")) // Add the dependencies for the Firebase AI Logic and App Check libraries // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-ai") implementation("com.google.firebase:firebase-appcheck-debug") // Required for one-shot operations (to use `ListenableFuture` from Guava Android) implementation("com.google.guava:guava:31.0.1-android") // Required for streaming operations (to use `Publisher` from Reactive Streams) implementation("org.reactivestreams:reactive-streams:1.0.4") }
باستخدام Firebase Android BoM، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase لنظام التشغيل Android.
Web
تتيح مكتبة Firebase AI Logic الوصول إلى واجهات برمجة التطبيقات للتفاعل مع نماذج Gemini. يتم تضمين المكتبة كجزء من حزمة تطوير البرامج (SDK) لبرنامج Firebase JavaScript للويب.
ثبِّت حزمة تطوير البرامج (SDK) لبرنامج Firebase JS للويب باستخدام npm:
npm install firebaseإعداد Firebase في تطبيقك:
import { initializeApp } from "firebase/app"; import { initializeAppCheck, DebugProvider } from "firebase/app-check"; // TODO(developer) Replace the following with your app's Firebase configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize FirebaseApp const firebaseApp = initializeApp(firebaseConfig);
Dart
يتيح المكوّن الإضافي Firebase AI Logic لـ Flutter (firebase_ai)
الوصول إلى واجهات برمجة التطبيقات للتفاعل مع نماذج Gemini.
من دليل مشروع Flutter، شغِّل الأمر التالي لتثبيت المكوّنَين الإضافيَين Firebase AI Logic وApp Check:
flutter pub add firebase_ai firebase_app_checkفي ملف
lib/main.dart، استورِد المكوّنَين الإضافيَّين Firebase AI Logic وApp Check:import 'package:firebase_core/firebase_core.dart'; import 'package:firebase_ai/firebase_ai.dart'; import 'package:firebase_app_check/firebase_app_check.dart'; import 'firebase_options.dart';في ملف
lib/main.dartأيضًا، تأكَّد من إعداد Firebase باستخدام عنصرDefaultFirebaseOptionsالذي تم تصديره من خلال ملف الإعداد:await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );أعِد إنشاء تطبيق Flutter:
flutter run
Unity
لم يكن الدعم متاحًا لـ Unity من حِزم تطوير البرامج (SDK) لعملاء Google AI.
تعرَّف على كيفية بدء استخدام حزمة تطوير البرامج (SDK) الخاصة بخدمة "Firebase AI Logic" لمشاريع Unity.
إزالة حزمة SDK القديمة من تطبيقك
بعد الانتهاء من نقل تطبيقك (راجِع الأقسام المتبقية في هذا الدليل)، احرص على حذف المكتبة القديمة.
Swift
أزِل المكتبة القديمة:
في Xcode، افتح مشروع تطبيقك، ثم انتقِل إلى لوحة Packages Dependencies (موارد الاعتمادية للحزم).
اختَر حزمة
generative-ai-swiftمن قائمة تبعيات الحزمة.انقر على الزر
-في أسفل القائمة، ثم انقر على إزالة للتأكيد.
Kotlin
dependencies {
implementation("com.google.ai.client.generativeai:generativeai:VERSION")
}
Java
dependencies {
implementation("com.google.ai.client.generativeai:generativeai:VERSION")
}
Web
// BEFORE
import { initializeApp } from "firebase/app";
import { GoogleGenerativeAI } from "@google/generative-ai";
Dart
احذف الحزمة القديمة:
flutter pub remove google_generative_ai
Unity
لم يكن دعم Unity متاحًا من حِزم تطوير البرامج (SDK) لعملاء Google AI.
تعرَّف على كيفية بدء استخدام حزمة تطوير البرامج (SDK) الخاصة بخدمة "Firebase AI Logic" لمشاريع Unity.
الخطوة 3: تعديل عمليات الاستيراد والتهيئة في تطبيقك
عدِّل عمليات الاستيراد وطريقة إعداد خدمة الخلفية Gemini Developer API وإنشاء مثيل GenerativeModel.
Swift
// BEFOREimport GoogleGenerativeAI let model = GenerativeModel(name: "MODEL_NAME", apiKey: APIKey.default)// AFTER import FirebaseAILogic // Initialize the Gemini Developer API backend service let ai = FirebaseAI.firebaseAI(backend: .googleAI()) // Create a `GenerativeModel` instance with a model that supports your use case let model = ai.generativeModel(modelName: "gemini-4-hydrogen")
Kotlin
// BEFOREimport com.google.ai.client.generativeai.Chat import com.google.ai.client.generativeai.type.Content import com.google.ai.client.generativeai.java.GenerativeModuleFutures...val generativeModel = GenerativeModel(modelName = "MODEL_NAME", // Access your API key as a Build Configuration variable apiKey = BuildConfig.apiKey )// AFTER import com.google.firebase.Firebase import com.google.firebase.ai.ai import com.google.firebase.ai.type.GenerativeBackend ... // Initialize the Gemini Developer API backend service. // Create a `GenerativeModel` instance with a model that supports your use case. val model = Firebase.ai(backend = GenerativeBackend.googleAI()) .generativeModel("gemini-4-hydrogen")
Java
// BEFOREimport com.google.ai.client.generativeai.Chat; import com.google.ai.client.generativeai.type.Content; import com.google.ai.client.generativeai.java.GenerativeModuleFutures;...GenerativeModel gm = new GenerativeModel("MODEL_NAME", // Access your API key as a Build Configuration variable BuildConfig.apiKey ); GenerativeModelFutures model = GenerativeModelFutures.from(gm);// AFTER import com.google.firebase.ai.FirebaseAI; import com.google.firebase.ai.GenerativeModel; import com.google.firebase.ai.java.GenerativeModelFutures; import com.google.firebase.ai.type.GenerativeBackend; ... // Initialize the Gemini Developer API backend service. // Create a `GenerativeModel` instance with a model that supports your use case. GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI()) .generativeModel("gemini-4-hydrogen"); // Use the GenerativeModelFutures Java compatibility layer which offers // support for ListenableFuture and Publisher APIs GenerativeModelFutures model = GenerativeModelFutures.from(ai);
Web
// BEFOREimport { GoogleGenerativeAI } from "@google/generative-ai"; // Fetch your API_KEY and access your API const API_KEY = "..."; const genAI = new GoogleGenerativeAI(API_KEY);...const model = genAI.getGenerativeModel({ model: "MODEL_NAME"});// AFTER import { initializeApp } from "firebase/app"; import { getAI, getGenerativeModel, GoogleAIBackend } from "firebase/ai"; // TODO(developer): Replace the following with your app's Firebase configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize FirebaseApp const firebaseApp = initializeApp(firebaseConfig); // Initialize the Gemini Developer API backend service. const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() }); // Create a `GenerativeModel` instance with a model that supports your use case. const model = getGenerativeModel(ai, { model: "gemini-4-hydrogen" });
Dart
// BEFOREimport 'package:google_generative_ai/google_generative_ai.dart'; final apiKey = Platform.environment['API_KEY']; if (apiKey == null) { print('No \$API_KEY environment variable'); exit(1); } final model = GenerativeModel(model: 'MODEL_NAME', apiKey: apiKey);// AFTER import 'package:firebase_ai/firebase_ai.dart'; import 'package:firebase_core/firebase_core.dart'; import 'firebase_options.dart'; // Initialize FirebaseApp await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, ); // Initialize the Gemini Developer API backend service // Create a `GenerativeModel` instance with a model that supports your use case final model = FirebaseAI.googleAI().generativeModel(model: 'gemini-4-hydrogen');
Unity
لم يكن دعم Unity متاحًا من حِزم تطوير البرامج (SDK) لعملاء Google AI.
تعرَّف على كيفية بدء استخدام حزمة تطوير البرامج (SDK) الخاصة بخدمة "Firebase AI Logic" لمشاريع Unity.
يُرجى العِلم أنّه بناءً على الميزة التي تستخدمها، قد لا يتم دائمًا
إنشاء مثيل GenerativeModel. لبث الإدخال والإخراج باستخدام Gemini Live API،
يجب إنشاء مثيل LiveModel.
الخطوة 4: تعديل الرمز استنادًا إلى الميزات التي تستخدمها
توضّح هذه الخطوة التغييرات التي قد تكون مطلوبة حسب الميزات التي تستخدمها.
لا تتيح حِزم تطوير البرامج (SDK) لعملاء Firebase AI Logic تنفيذ الرموز البرمجية. إذا كنت تستخدم هذه الميزة، تأكَّد من توفيرها في تطبيقك.
يُرجى مراجعة القوائم التالية لمعرفة أي تغييرات قد تحتاج إلى إجرائها في الرمز البرمجي لاستيعاب عملية نقل البيانات إلى حِزم تطوير البرامج (SDK) لعميل Firebase AI Logic.
مطلوبة لجميع اللغات والمنصات
استدعاء الدوال
إذا نفّذت هذه الميزة، عليك إجراء تعديلات على طريقة تحديد المخطط. ننصحك بمراجعة دليل استدعاء الدوال المعدَّل لمعرفة كيفية كتابة تعريفات الدوال.إنشاء مخرجات منظَّمة (مثل JSON) باستخدام
responseSchema
إذا نفّذت هذه الميزة، عليك إجراء تعديلات على طريقة تحديد المخطط. ننصحك بمراجعة دليل الإخراج المنظَّم الجديد للتعرّف على كيفية كتابة مخططات JSON.Timeout
- تم تغيير المهلة التلقائية للطلبات إلى 180 ثانية.
مطلوبة استنادًا إلى المنصة أو اللغة
Swift
التعدادات
تم استبدال معظم أنواع
enumبـstructباستخدام متغيّرات ثابتة. يتيح هذا التغيير مرونة أكبر لتطوير واجهة برمجة التطبيقات بطريقة متوافقة مع الأنظمة القديمة. عند استخدام عباراتswitch، يجب الآن تضمين حالةdefault:لتغطية القيم غير المعروفة أو التي لم تتم معالجتها، بما في ذلك القيم الجديدة التي تتم إضافتها إلى حزمة تطوير البرامج (SDK) في المستقبل.تمت إعادة تسمية التعداد
BlockThresholdإلىHarmBlockThreshold، وأصبح هذا النوع الآنstruct.تمت إزالة الحالتَين
unknownوunspecifiedمن التعدادات التالية (التي أصبحت الآنstruct):HarmCategoryوHarmBlockThresholdوHarmProbabilityوBlockReasonوFinishReason.تم استبدال التعداد
ModelContent.Partببروتوكول باسمPartللسماح بإضافة أنواع جديدة بطريقة متوافقة مع الأنظمة القديمة. يتم شرح هذا التغيير بمزيد من التفصيل في قسم أجزاء المحتوى.
أجزاء المحتوى
تمت إزالة بروتوكول
ThrowingPartsRepresentableوتبسيط أدوات الإعداد لـModelContentلتجنُّب أخطاء برنامج التجميع العرضية. ستستمر الصور التي لا يتم ترميزها بشكل صحيح في عرض الأخطاء عند استخدامها فيgenerateContent.تم استبدال حالات
ModelContent.Partبأنواعstructالتالية المتوافقة مع بروتوكولPart:- من
.textإلىTextPart - من
.dataإلىInlineDataPart - من
.fileDataإلىFileDataPart - من
.functionCallإلىFunctionCallPart - من
.functionResponseإلىFunctionResponsePart
- من
فئة الضرر
- تم تغيير
HarmCategoryبحيث لا يكون مدمجًا في النوعSafetySetting. إذا كنت تشير إليه باسمSafetySetting.HarmCategory، يمكن استبداله بـHarmCategory.
- تم تغيير
ملاحظات حول السلامة
- تمت إزالة النوع
SafetyFeedbackلأنّه لم يتم استخدامه في أي من الردود.
- تمت إزالة النوع
البيانات الوصفية للاقتباسات
- تمت إعادة تسمية السمة
citationSourcesإلىcitationsفيCitationMetadata.
- تمت إعادة تسمية السمة
إجمالي عدد الأحرف التي يتم تحصيل رسوم مقابلها
- تم تغيير السمة
totalBillableCharactersفيCountTokensResponseلتصبح اختيارية، وذلك لتعكس الحالات التي لا يتم فيها إرسال أي أحرف.
- تم تغيير السمة
ردّ المرشّح
- تمت إعادة تسمية
CandidateResponseإلىCandidateلتتطابق مع المنصات الأخرى.
- تمت إعادة تسمية
إعدادات الإنشاء
- تم تغيير المواقع العلنية لـ "
GenerationConfig" إلى "internal". وتبقى جميعها قابلة للضبط في دالة الإعداد.
- تم تغيير المواقع العلنية لـ "
Kotlin
التعدادات
تم استبدال صفوف "
enum" وصفوف "sealed" بصفوف عادية. يتيح هذا التغيير مرونة أكبر لتطوير واجهة برمجة التطبيقات بطريقة متوافقة مع الأنظمة القديمة.تمت إعادة تسمية التعداد
BlockThresholdإلىHarmBlockThreshold.تمت إزالة القيم من التعدادات التالية:
HarmBlockThresholdوHarmProbabilityوHarmSeverityوBlockReasonوFinishReason.
طرق Blob
- تمت إعادة تسمية جميع الطرق التي تتضمّن
Blobكجزء من اسمها لاستخدامInlineDataبدلاً من ذلك.
- تمت إعادة تسمية جميع الطرق التي تتضمّن
إعدادات الأمان
- تم تغيير الحقل
methodليصبح قابلاً للإلغاء.
- تم تغيير الحقل
فئة المدة
- تمت إزالة جميع استخدامات فئة
Durationفي Kotlin واستبدالها بـlong. يوفّر هذا التغيير إمكانية تشغيل تفاعلي أفضل مع Java.
- تمت إزالة جميع استخدامات فئة
البيانات الوصفية للاقتباسات
- تم تجميع كل الحقول التي تم الإعلان عنها سابقًا في
CitationMetadataفي فئة جديدة باسمCitation. يمكن العثور على الاقتباسات في القائمة التي تحمل الاسمcitationsفيCitationMetadata. يتيح هذا التغيير توافقًا أفضل للأنواع على مستوى المنصات.
- تم تجميع كل الحقول التي تم الإعلان عنها سابقًا في
احتساب الرموز المميّزة
- تم تغيير الحقل
totalBillableCharactersليصبح قابلاً للإلغاء.
- تم تغيير الحقل
إجمالي عدد الأحرف التي يتم تحصيل رسوم مقابلها
- تم تغيير السمة
totalBillableCharactersفيCountTokensResponseلتصبح اختيارية، وذلك لتعكس الحالات التي لا يتم فيها إرسال أي أحرف.
- تم تغيير السمة
إنشاء مثيل من نموذج
- تم نقل المَعلمة
requestOptionsإلى نهاية قائمة المَعلمات لتتوافق مع المنصات الأخرى.
- تم نقل المَعلمة
Java
التعدادات
تم استبدال صفوف "
enum" وصفوف "sealed" بصفوف عادية. يتيح هذا التغيير مرونة أكبر لتطوير واجهة برمجة التطبيقات بطريقة متوافقة مع الأنظمة القديمة.تمت إعادة تسمية التعداد
BlockThresholdإلىHarmBlockThreshold.تمت إزالة القيم من التعدادات التالية:
HarmBlockThresholdوHarmProbabilityوHarmSeverityوBlockReasonوFinishReason.
طرق Blob
- تمت إعادة تسمية جميع الطرق التي تتضمّن
Blobكجزء من اسمها لاستخدامInlineDataبدلاً من ذلك.
- تمت إعادة تسمية جميع الطرق التي تتضمّن
إعدادات الأمان
- تم تغيير الحقل
methodليصبح قابلاً للإلغاء.
- تم تغيير الحقل
فئة المدة
- تمت إزالة جميع استخدامات فئة
Durationفي Kotlin واستبدالها بـlong. يوفّر هذا التغيير إمكانية تشغيل تفاعلي أفضل مع Java.
- تمت إزالة جميع استخدامات فئة
البيانات الوصفية للاقتباسات
- تم تجميع كل الحقول التي تم الإعلان عنها سابقًا في
CitationMetadataفي فئة جديدة باسمCitation. يمكن العثور على الاقتباسات في القائمة التي تحمل الاسمcitationsفيCitationMetadata. يتيح هذا التغيير توافقًا أفضل للأنواع على مستوى المنصات.
- تم تجميع كل الحقول التي تم الإعلان عنها سابقًا في
احتساب الرموز المميّزة
- تم تغيير الحقل
totalBillableCharactersليصبح قابلاً للإلغاء.
- تم تغيير الحقل
إجمالي عدد الأحرف التي يتم تحصيل رسوم مقابلها
- تم تغيير السمة
totalBillableCharactersفيCountTokensResponseلتصبح اختيارية، وذلك لتعكس الحالات التي لا يتم فيها إرسال أي أحرف.
- تم تغيير السمة
إنشاء مثيل من نموذج
- تم نقل المَعلمة
requestOptionsإلى نهاية قائمة المَعلمات لتتوافق مع المنصات الأخرى.
- تم نقل المَعلمة
Web
يُرجى العِلم أنّ حزمة تطوير البرامج (SDK) لبرنامج Google AI في JavaScript قد شهدت العديد من التغييرات منذ أن تفرّعت منها حزم تطوير البرامج (SDK) لبرنامج Firebase AI Logic. في ما يلي قائمة ببعض التغييرات المحتملة التي قد تحتاج إلى أخذها في الاعتبار عند نقل بياناتك إلى حِزم تطوير البرامج (SDK) لعملاء Firebase AI Logic.
التعدادات
- تمت إزالة القيم من التعدادات التالية:
HarmCategoryوBlockThresholdوHarmProbabilityوHarmSeverityوBlockReasonوFinishReason.
- تمت إزالة القيم من التعدادات التالية:
سبب الحظر
- تم تغيير "
blockReason" في "PromptFeedback" ليصبح اختياريًا.
- تم تغيير "
تحديد المصدر في البحث
- تمت إزالة جميع استخدامات هذه الميزة، لأنّها غير متاحة بعد في حِزم تطوير البرامج (SDK) الخاصة بـ Firebase AI Logic.
الأخطاء
- تمت إزالة جميع استخدامات
GoogleGenerativeAIError، ويمكنك الانتقال إلىAIError.
- تمت إزالة جميع استخدامات
Dart
التعدادات
- تمت إزالة القيم من التعدادات التالية:
HarmCategoryوHarmProbabilityوBlockReasonوFinishReason.
- تمت إزالة القيم من التعدادات التالية:
جزء البيانات
- تمت إعادة تسمية
DataPartإلىInlineDataPart، والدالةstaticdataإلىinlineDataلتتوافق مع المنصات الأخرى.
- تمت إعادة تسمية
خيارات الطلب
- تمت إزالة "
RequestOptions" لأنّ "timeout" لم يكن يعمل. ستتم إعادة إضافته في المستقبل القريب، ولكن سيتم نقله إلى النوعGenerativeModelليتطابق مع المنصات الأخرى.
- تمت إزالة "
إيقاف التسلسلات
- تم تغيير المَعلمة
stopSequencesفيGenerationConfigلتصبح اختيارية وتكون قيمتها التلقائيةnullبدلاً من مصفوفة فارغة.
- تم تغيير المَعلمة
الاقتباسات
- تمت إعادة تسمية السمة
citationSourcesإلىcitationsفيCitationMetadata. تمت إعادة تسمية النوعCitationSourceإلىCitationليتطابق مع المنصات الأخرى.
- تمت إعادة تسمية السمة
الأنواع والأساليب والسمات العامة غير الضرورية
- تمت إزالة الأنواع والطرق والسمات التالية التي تم الكشف عنها عن غير قصد:
defaultTimeoutوCountTokensResponseFieldsوparseCountTokensResponseوparseEmbedContentResponseوparseGenerateContentResponseوparseContentوBatchEmbedContentsResponseوContentEmbeddingوEmbedContentRequestوEmbedContentResponse.
- تمت إزالة الأنواع والطرق والسمات التالية التي تم الكشف عنها عن غير قصد:
احتساب الرموز المميّزة
- تمت إزالة الحقول الإضافية من دالة
countTokensالتي لم تعد ضرورية. مطلوبcontentsفقط.
- تمت إزالة الحقول الإضافية من دالة
إنشاء مثيل من نموذج
- تم نقل المَعلمة
systemInstructionإلى نهاية قائمة المَعلمات لتتوافق مع المنصات الأخرى.
- تم نقل المَعلمة
وظيفة التضمين
- تمت إزالة وظيفة التضمين غير المتوافقة (
embedContentوbatchEmbedContents) من النموذج.
- تمت إزالة وظيفة التضمين غير المتوافقة (
Unity
لم يكن دعم Unity متاحًا من حِزم تطوير البرامج (SDK) لعملاء Google AI.
تعرَّف على كيفية بدء استخدام حزمة تطوير البرامج (SDK) الخاصة بخدمة "Firebase AI Logic" لمشاريع Unity.
تقديم ملاحظات حول تجربتك مع "Firebase AI Logic"