Agent Platform Gemini API

Если вы ещё не работали с Gemini API, рекомендуем использовать Gemini Developer API от Gemini. Однако если у вас есть особые требования к местоположению данных или вы уже используете экосистему Google Cloud, то можете использовать Gemini API платформы агентов (ранее Vertex AI) с Firebase AI Logic для доступа к моделям Gemini Pro и Flash.

.

Начало работы

Прежде чем взаимодействовать с Agent Platform Gemini API напрямую из приложения, вы можете поэкспериментировать с запросами в Agent Studio.

Как настроить проект 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.0.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:35.0.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 года в рамках пошаговой настройки логики ИИ в консоли Firebase будет автоматически включаться Проверка приложений Firebase для защиты Gemini API. Для локальной разработки вам нужно настроить поставщика данных для отладки App Check, чтобы пропускать подтверждение, но при этом сохранять принудительное применение App Check.

1. В отладочной сборке настройте App Check на использование фабрики поставщика отладки:

   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 выберите Безопасность > Проверка приложений > вкладка Приложения.

   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

Подробнее о доступных моделях Gemini можно узнать из документации Firebase. Вы также можете узнать больше о том, как настраивать параметры модели.

Как сгенерировать текст

Чтобы сгенерировать текстовый ответ, вызовите функцию 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.