מעבר ל-Firebase AI Logic SDKs מגרסת הטרום-השקה של Vertex AI in Firebase SDKs

Swift

import FirebaseAI

// 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-2.5-flash")

Kotlin

// 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-2.5-flash")

Java

// 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-2.5-flash");

// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(ai);

Web

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-2.5-flash" });

Dart

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-2.5-flash');

Unity

התמיכה ב-Unity לא הייתה זמינה מ-'Vertex AI in Firebase'.

איך מתחילים לעבוד עם Firebase AI Logic SDK ל-Unity

Swift

• Enumerations

  • החלפנו את רוב הסוגים של enum ב-struct עם משתנים סטטיים. השינוי הזה מאפשר גמישות רבה יותר בפיתוח ה-API באופן שתואם לאחור. כשמשתמשים בהצהרות 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

• Enumerations

  • החלפנו את enum classes ואת sealed classes בכיתות רגילות. השינוי הזה מאפשר גמישות רבה יותר בפיתוח ה-API באופן שתהיה תאימות לאחור.

  • השם של הספירה BlockThreshold שונה ל-HarmBlockThreshold.

  • הוסרו ערכים מהספירות הבאות: HarmBlockThreshold,‏ HarmProbability,‏ HarmSeverity,‏ BlockReason ו-FinishReason.

• Blob methods

  • שינינו את השם של כל ה-methods שכללו את Blob כחלק מהשם שלהם, כך שישתמשו ב-InlineData במקום זאת.

• הגדרות בטיחות

  • השדה method שונה כך שניתן להזין בו ערך null.

• משך הזמן

  • הסרנו את כל השימושים במחלקה Duration של Kotlin והחלפנו אותה ב-long. השינוי הזה מאפשר יכולת פעולה הדדית טובה יותר עם Java.

• מטא-נתונים של ציטוטים

  • העברנו את כל השדות שהוגדרו קודם ב-CitationMetadata למחלקה חדשה בשם Citation. אפשר למצוא את הציטוטים ברשימה שנקראת citations ב-CitationMetadata. השינוי הזה מאפשר התאמה טובה יותר בין סוגי הפלטפורמות.

• ספירת טוקנים

  • השדה totalBillableCharacters שונה כך שניתן להזין בו ערך null.

• סך התווים לחיוב

  • המאפיין totalBillableCharacters ב-CountTokensResponse השתנה לאופציונלי כדי לשקף מצבים שבהם לא נשלחים תווים.

• הפעלת מודל

  • העברנו את הפרמטר requestOptions לסוף רשימת הפרמטרים כדי להתאים אותו לפלטפורמות אחרות.

• Live API

  • הערך UNSPECIFIED הוסר מהמחלקת enum‏ ResponseModality. במקום זאת, צריך להשתמש ב-null.

  • השם של LiveGenerationConfig.setResponseModalities שונה ל-LiveGenerationConfig.setResponseModality.

  • הוסר המחלקה LiveContentResponse.Status, ובמקומה שדות הסטטוס מוטמעים כמאפיינים של LiveContentResponse.

  • הוסר המחלקה LiveContentResponse, ובמקומה סופקו מחלקות משנה של LiveServerMessage שתואמות לתשובות מהמודל.

  • הפונקציה LiveModelFutures.connect שונתה כך שתחזיר ListenableFuture<LiveSessionFutures> במקום ListenableFuture<LiveSession>.

Java

• Enumerations

  • החלפנו את enum classes ואת sealed classes בכיתות רגילות. השינוי הזה מאפשר גמישות רבה יותר בפיתוח ה-API באופן שתהיה תאימות לאחור.

  • השם של הספירה BlockThreshold שונה ל-HarmBlockThreshold.

  • הוסרו ערכים מהספירות הבאות: HarmBlockThreshold,‏ HarmProbability,‏ HarmSeverity,‏ BlockReason ו-FinishReason.

• Blob methods

  • שינינו את השם של כל ה-methods שכללו את Blob כחלק מהשם שלהם, כך שישתמשו ב-InlineData במקום זאת.

• הגדרות בטיחות

  • השדה method שונה כך שניתן להזין בו ערך null.

• משך הזמן

  • הסרנו את כל השימושים במחלקה Duration של Kotlin והחלפנו אותה ב-long. השינוי הזה מאפשר יכולת פעולה הדדית טובה יותר עם Java.

• מטא-נתונים של ציטוטים

  • העברנו את כל השדות שהוגדרו קודם ב-CitationMetadata למחלקה חדשה בשם Citation. אפשר למצוא את הציטוטים ברשימה שנקראת citations ב-CitationMetadata. השינוי הזה מאפשר התאמה טובה יותר בין סוגי הפלטפורמות.

• ספירת טוקנים

  • השדה totalBillableCharacters שונה כך שניתן להזין בו ערך null.

• סך התווים לחיוב

  • המאפיין totalBillableCharacters ב-CountTokensResponse השתנה לאופציונלי כדי לשקף מצבים שבהם לא נשלחים תווים.

• הפעלת מודל

  • העברנו את הפרמטר requestOptions לסוף רשימת הפרמטרים כדי להתאים אותו לפלטפורמות אחרות.

• Live API

  • הערך UNSPECIFIED הוסר מהמחלקת enum‏ ResponseModality. במקום זאת, צריך להשתמש ב-null.

  • השם של LiveGenerationConfig.setResponseModalities שונה ל-LiveGenerationConfig.setResponseModality.

  • הוסר המחלקה LiveContentResponse.Status, ובמקומה שדות הסטטוס מוטמעים כמאפיינים של LiveContentResponse.

  • הוסר המחלקה LiveContentResponse, ובמקומה סופקו מחלקות משנה של LiveServerMessage שתואמות לתשובות מהמודל.

  • הפונקציה LiveModelFutures.connect שונתה כך שתחזיר ListenableFuture<LiveSessionFutures> במקום ListenableFuture<LiveSession>.

• בוצע שינוי בשיטות שונות של Java builder כך שעכשיו הן מחזירות את המופע של המחלקה שלהן בצורה נכונה, במקום void.

Web

• Enumerations

  • הוסרו ערכים מהמספורים הבאים: HarmCategory,‏ BlockThreshold,‏ HarmProbability,‏ HarmSeverity,‏ BlockReason ו-FinishReason.

• סיבת החסימה

  • השדה blockReason ב-PromptFeedback השתנה לאופציונלי.

השינויים נדרשים רק אם אתם מתחילים להשתמש ב-Gemini Developer API (במקום ב-Vertex AI Gemini API):

• הגדרות בטיחות

  • הוסרו מקרים של שימוש ב-SafetySetting.method שלא נתמך.

• נתונים מוטבעים

  • הוסרו מקרים של שימוש ב-InlineDataPart.videoMetadata שלא נתמך.

Dart

• Enumerations

  • הוסרו ערכים מהמספורים הבאים: HarmCategory,‏ HarmProbability,‏ BlockReason ו-FinishReason.

• חלק מהנתונים

  • שינינו את השם של DataPart ל-InlineDataPart, ואת הפונקציה static data ל-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 לא הייתה זמינה מ-"Vertex AI in Firebase".

איך מתחילים לעבוד עם Firebase AI Logic SDK ל-Unity