Agent Platform Gemini API

אם אתם משתמשים חדשים ב-Gemini API, ‏ Gemini Developer API הוא ספק ה-API המומלץ למפתחים ל-Android. עם זאת, אם יש לכם דרישות ספציפיות לגבי מיקום הנתונים או שאתם כבר משתמשים בסביבה העסקית של Google Cloud, אתם יכולים להשתמש ב-Agent Platform Gemini API (לשעבר Vertex AI) עם Firebase AI Logic כדי לגשת למודלים של Gemini Pro ו-Flash.

תחילת העבודה

לפני שאתם מתחילים לעבוד עם Agent Platform Gemini API ישירות מהאפליקציה, אתם יכולים להתנסות בהנחיות ב-Agent Studio.

הגדרת פרויקט ב-Firebase וקישור האפליקציה ל-Firebase

כשתהיו מוכנים לשלוח קריאה ל-API מהאפליקציה, פעלו לפי ההוראות בשלב 1 במדריך לתחילת העבודה עם Firebase AI Logic כדי להגדיר את Firebase ולהפעיל את ממשקי ה-API והשירותים הנדרשים.

הוספת יחסי התלות של Gradle

מוסיפים את יחסי התלות הבאים של Gradle למודול האפליקציה:

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:35.1.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")
}

dependencies {
  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:35.1.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")
}

הגדרת ספק אימות לצורכי ניפוי באגים של App Check לפיתוח מקומי

החל מתחילת יולי 2026, כחלק מתהליך ההגדרה המודרך של AI Logic במסוף Firebase, המערכת תאכוף באופן אוטומטי את Firebase App Check כדי להגן על Gemini API. לפיתוח מקומי, צריך להגדיר את ספק אימות לצורכי ניפוי באגים של App Check כדי לעקוף את האימות תוך שמירה על האכיפה של App Check.

1. בגרסת ה-build לניפוי באגים, מגדירים את App Check כך שישתמש ב-factory של ספק אימות לצורכי ניפוי באגים:

   Kotlin

   Firebase.initialize(context = this)
   Firebase.appCheck.installAppCheckProviderFactory(
       DebugAppCheckProviderFactory.getInstance(),
   )
   

   Java

   FirebaseApp.initializeApp(/*context=*/ this);
   FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance();
   firebaseAppCheck.installAppCheckProviderFactory(
           DebugAppCheckProviderFactory.getInstance());
   

2. איך מקבלים טוקן לניפוי באגים:

   1. מפעילים את האפליקציה באמולטור או במכשיר הבדיקה.

   2. מחפשים את אסימון ניפוי הבאגים של App Check ביומנים. לדוגמה:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
      in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
      

   3. מעתיקים את הטוקן (לדוגמה, 123a4567-b89c-12d3-e456-789012345678).

3. רושמים את אסימון ניפוי הבאגים ב-App Check:

   1. במסוף Firebase, עוברים אל Security (אבטחה) > App Check > הכרטיסייה Apps (אפליקציות).

   2. מוצאים את האפליקציה, לוחצים על סמל האפשרויות הנוספות (more_vert) ובוחרים באפשרות ניהול אסימוני ניפוי באגים.

   3. פועלים לפי ההוראות במסך כדי לרשום את אסימון ניפוי הבאגים.

פרטים על ספק האימות לצורכי ניפוי באגים (כולל איך לקבל אסימון חדש לניפוי באגים) זמינים במסמכים הרשמיים של App Check.

הפעלת המודל הגנרטיבי

כדי להתחיל, יוצרים מופע של GenerativeModel ומציינים את שם המודל:

val model = Firebase.ai(backend = GenerativeBackend.agentPlatform())
    .generativeModel("gemini-3.5-flash")
AgentPlatformGeminiApi.kt

GenerativeModel firebaseAI = FirebaseAI.getInstance(GenerativeBackend.agentPlatform())
        .generativeModel("gemini-3.5-flash");

GenerativeModelFutures model = GenerativeModelFutures.from(firebaseAI);
AgentPlatformGeminiApiJava.java

במסמכי התיעוד של Firebase מפורט מידע נוסף על המודלים הזמינים של Gemini. אפשר גם לקרוא מידע נוסף על הגדרת הפרמטרים של המודל.

יצירת טקסט

כדי ליצור תשובת טקסט, צריך להפעיל את generateContent() עם ההנחיה.

suspend fun generateText(model: GenerativeModel) {
    // Note: generateContent() is a suspend function, which integrates well
    // with existing Kotlin code.
    val response = model.generateContent("Write a story about a magic backpack.")
    // ...
}
AgentPlatformGeminiApi.kt

Content prompt = new Content.Builder()
        .addText("Write a story about a magic backpack.")
        .build();

ListenableFuture<GenerateContentResponse> response = model.generateContent(prompt);
Futures.addCallback(response, new FutureCallback<GenerateContentResponse>() {
    @Override
    public void onSuccess(GenerateContentResponse result) {
        String resultText = result.getText();
        // ...
    }

    @Override
    public void onFailure(Throwable t) {
        t.printStackTrace();
    }
}, executor);
AgentPlatformGeminiApiJava.java

בדומה ל-Gemini Developer API, אתם יכולים להעביר תמונות, אודיו, וידאו וקבצים עם הנחיית הטקסט. פרטים נוספים זמינים במאמר איך משתמשים ב-Gemini Developer API באפליקציה.

מידע נוסף על Firebase AI Logic SDK זמין במסמכי התיעוד של Firebase.