В этом руководстве показано, как начать вызывать API Vertex AI Gemini непосредственно из вашего приложения с помощью SDK Vertex AI для Firebase.
При желании вы можете вызвать API Vertex AI Gemini на стороне сервера, используя серверные SDK Vertex AI или расширения Firebase для API Gemini .
При желании вы можете попробовать альтернативную версию API Gemini «Google AI», которая обеспечивает бесплатный доступ (в пределах ограничений и там, где это возможно) с использованием Google AI Studio и Google AI SDK .
Если вы решите использовать инструменты и сервисы Google AI, а также Firebase, мы рекомендуем следующее:
- Не используйте Google AI Studio и Google AI SDK с проектом Firebase , который используется вашим рабочим приложением .
- Ознакомившись с тем, как работает API Gemini, перейдите на Vertex AI для Firebase SDK , который имеет множество дополнительных функций, важных для мобильных и веб-приложений, например защиту API от злоупотреблений с помощью Firebase App Check .
Предварительные условия
В этом руководстве предполагается, что вы знакомы с разработкой приложений с помощью Flutter.
Убедитесь, что ваша среда разработки и веб-приложение соответствуют следующим требованиям:
- Дартс 3.2.0+
(Необязательно) Ознакомьтесь с примером приложения.
Вы можете быстро опробовать SDK, увидеть полную реализацию различных вариантов использования или использовать образец приложения, если у вас нет собственного веб-приложения. Чтобы использовать пример приложения, вам необходимо подключить его к проекту Firebase .
Шаг 1. Настройте проект Firebase и подключите свое приложение к Firebase.
Если у вас уже есть проект Firebase и приложение, подключенное к Firebase
В консоли Firebase перейдите на страницу «Создать с помощью Gemini» и щелкните вторую карточку, чтобы запустить рабочий процесс, который поможет вам выполнить следующие задачи. Если вы видите в консоли вкладку Vertex AI, значит, эти задачи выполнены.
Обновите свой проект, чтобы использовать тарифный план Blaze с оплатой по мере использования .
Включите следующие два API для вашего проекта:
aiplatform.googleapis.com
иfirebaseml.googleapis.com
.
Перейдите к следующему шагу в этом руководстве, чтобы добавить SDK в свое приложение.
Если у вас еще нет проекта Firebase и приложения, подключенного к Firebase
Войдите в консоль Firebase .
Нажмите «Создать проект» , а затем используйте любой из следующих вариантов:
Вариант 1. Создайте совершенно новый проект Firebase (и его базовый проект Google Cloud автоматически), введя новое имя проекта на первом этапе рабочего процесса «Создание проекта».
Вариант 2. «Добавьте Firebase» в существующий проект Google Cloud, выбрав имя проекта Google Cloud в раскрывающемся меню на первом этапе рабочего процесса «Создать проект».
Обратите внимание: при появлении запроса вам не нужно настраивать Google Analytics для использования Vertex AI для Firebase SDK.
В консоли Firebase перейдите на страницу «Сборка с помощью Gemini» и щелкните вторую карточку, чтобы запустить рабочий процесс, который поможет вам выполнить следующие задачи. Если вы видите в консоли вкладку Vertex AI, значит, эти задачи выполнены.
Обновите свой проект, чтобы использовать тарифный план Blaze с оплатой по мере использования .
Включите следующие два API для вашего проекта:
aiplatform.googleapis.com
иfirebaseml.googleapis.com
.
Установите необходимые инструменты командной строки:
Если вы еще этого не сделали, установите Firebase CLI .
Войдите в Firebase, используя свою учетную запись Google, выполнив следующую команду:
firebase login
Установите интерфейс командной строки FlutterFire, выполнив следующую команду из любого каталога:
dart pub global activate flutterfire_cli
Настройте свои приложения для использования Firebase:
Используйте интерфейс командной строки FlutterFire, чтобы настроить приложения Flutter для подключения к Firebase.
В каталоге проекта Flutter выполните следующую команду, чтобы запустить рабочий процесс настройки приложения:
flutterfire configure
Рабочий процесс
flutterfire configure
выполняет следующее:Попросит вас выбрать платформы (iOS, Android, Интернет), поддерживаемые вашим приложением Flutter. Для каждой выбранной платформы интерфейс командной строки FlutterFire создает новое приложение Firebase в вашем проекте Firebase.
Вы можете выбрать либо использовать существующий проект Firebase, либо создать новый проект Firebase. Если у вас уже есть приложения, зарегистрированные в существующем проекте Firebase, интерфейс командной строки FlutterFire попытается сопоставить их на основе текущей конфигурации вашего проекта Flutter.
Создает файл конфигурации Firebase (
firebase_options.dart
) и добавляет его в каталогlib/
вашего приложения Flutter.
На следующих шагах этого руководства вы добавите Vertex AI для Firebase SDK в свое приложение и выполните необходимую инициализацию, необходимую для использования SDK и Gemini API.
Шаг 2. Добавьте SDK
Настроив проект Firebase и подключив приложение к Firebase (см. предыдущий шаг), вы можете добавить в свое приложение Vertex AI for Firebase SDK.
Плагин Vertex AI for Firebase для Flutter ( firebase_vertexai
) обеспечивает доступ к API Vertex AI Gemini.
В каталоге проекта Flutter выполните следующую команду, чтобы установить основной плагин:
flutter pub add firebase_core
В файл
lib/main.dart
импортируйте основной плагин Firebase и файл конфигурации, созданный ранее:import 'package:firebase_core/firebase_core.dart'; import 'firebase_options.dart';
Также в файле
lib/main.dart
инициализируйте Firebase, используя объектDefaultFirebaseOptions
, экспортированный файлом конфигурации:await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );
Перестройте приложение Flutter:
flutter run
В каталоге проекта Flutter выполните следующую команду:
flutter pub add firebase_vertexai
После завершения перестройте проект Flutter:
flutter run
Шаг 3. Инициализируйте сервис Vertex AI и генеративную модель.
Прежде чем вы сможете выполнять какие-либо вызовы API, вам необходимо инициализировать службу Vertex AI и генеративную модель.
import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';
// Initialize FirebaseApp
await Firebase.initializeApp();
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
final model =
FirebaseVertexAI.instance.generativeModel(model: 'gemini-1.5-flash');
Прочитав руководство по началу работы, узнайте, как выбрать модель Gemini и (необязательно) местоположение, подходящее для вашего варианта использования и приложения.
Шаг 4. Вызов API Vertex AI Gemini.
Теперь, когда вы подключили свое приложение к Firebase, добавили SDK и инициализировали службу Vertex AI и генеративную модель, вы готовы вызвать API Vertex AI Gemini.
Вы можете использовать generateContent()
для генерации текста из текстового запроса на подсказку:
import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';
await Firebase.initializeApp();
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
final model =
FirebaseVertexAI.instance.generativeModel(model: 'gemini-1.5-flash');
// Provide a prompt that contains text
final prompt = [Content.text('Write a story about a magic backpack.')];
// To generate text output, call generateContent with the text input
final response = await model.generateContent(prompt);
print(response.text);
Что еще можно сделать?
Узнайте больше о моделях Gemini
Узнайте о моделях, доступных для различных вариантов использования , а также об их квотах и ценах .Попробуйте другие возможности Gemini API
- Узнайте больше о создании текста из текстовых подсказок , в том числе о потоковой передаче ответа.
- Генерируйте текст из мультимодальных подсказок (включая текст, изображения, PDF-файлы, видео и аудио).
- Стройте многоходовые беседы (чат) .
- Используйте вызов функций для подключения генеративных моделей к внешним системам и информации.
Узнайте, как контролировать создание контента
- Понимание структуры подсказок , включая лучшие практики, стратегии и примеры подсказок.
- Настройте параметры модели, такие как токены температуры и максимальной мощности.
- Используйте настройки безопасности , чтобы настроить вероятность получения ответов, которые могут быть расценены как вредные.
Оставьте отзыв о своем опыте использования Vertex AI для Firebase.