Начните работу с Gemini API, используя Vertex AI в Firebase SDK.

В этом руководстве показано, как начать вызывать Vertex AI Gemini API непосредственно из вашего приложения с помощью Vertex AI in Firebase SDK для выбранной вами платформы.

Предварительные условия

В этом руководстве предполагается, что вы знакомы с использованием Xcode для разработки приложений для платформ Apple (например, iOS).

• Убедитесь, что ваша среда разработки и приложение платформы Apple соответствуют следующим требованиям:

  • Xcode 15.0 или выше
  • Ваше приложение должно быть ориентировано на iOS 15 или более позднюю версию или macOS 12 или более позднюю версию.

• (Необязательно) Ознакомьтесь с примером приложения.

  Загрузите образец приложения

  Вы можете быстро опробовать SDK, просмотреть полную реализацию различных вариантов использования или использовать образец приложения, если у вас нет собственного приложения для платформы Apple. Чтобы использовать пример приложения, вам необходимо подключить его к проекту Firebase .

Шаг 1. Настройте проект Firebase и подключите свое приложение к Firebase.

Если у вас уже есть проект Firebase и приложение, подключенное к Firebase

1. В консоли Firebase перейдите на страницу Build with Gemini .

2. Нажмите карточку Vertex AI in Firebase , чтобы запустить рабочий процесс, который поможет вам выполнить следующие задачи. (Обратите внимание: если вы видите в консоли вкладку Vertex AI , значит, эти задачи выполнены.)

   • Обновите свой проект, чтобы использовать тарифный план Blaze с оплатой по мере использования .

   • Включите следующие два API для вашего проекта:
     aiplatform.googleapis.com и firebaseml.googleapis.com .

3. Перейдите к следующему шагу в этом руководстве, чтобы добавить SDK в свое приложение.

Если у вас еще нет проекта Firebase и приложения, подключенного к Firebase

Шаг 2. Добавьте SDK

После настройки проекта Firebase и подключения вашего приложения к Firebase (см. предыдущий шаг) вы теперь можете добавить Vertex AI in Firebase SDK в свое приложение.

Библиотека Vertex AI in Firebase обеспечивает доступ к Vertex AI Gemini API и включена как часть Firebase SDK для платформ Apple ( firebase-ios-sdk ). Для библиотеки Vertex AI in Firebase необходимо использовать Swift Package Manager для установки зависимостей Firebase и управления ими. Другие менеджеры пакетов, такие как CocoaPods, в настоящее время не поддерживаются.

1. В Xcode, открыв проект приложения, выберите «Файл» > «Добавить пакеты» .

2. При появлении запроса добавьте репозиторий SDK Firebase Apple для платформ:

     https://github.com/firebase/firebase-ios-sdk
   

3. Выберите последнюю версию SDK.

4. Выберите библиотеку FirebaseVertexAI-Preview .

   По завершении Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.

Шаг 3. Инициализируйте сервис Vertex AI и генеративную модель.

Прежде чем вы сможете выполнять какие-либо вызовы API, вам необходимо инициализировать службу Vertex AI и генеративную модель.

1. Импортируйте модуль FirebaseVertexAI :

   import FirebaseVertexAI
   

2. Инициализируйте сервис Vertex AI и генеративную модель:

   import FirebaseVertexAI
   
   // Initialize the Vertex AI service
   let vertex = VertexAI.vertexAI()
   
   // Initialize the generative model with a model that supports your use case
   // Gemini 1.5 models are versatile and can be used with all API capabilities
   let model = vertex.generativeModel(modelName: "gemini-1.5-flash")
   

Прочитав руководство по началу работы, узнайте, как выбрать модель Gemini и (необязательно) местоположение, подходящее для вашего варианта использования и приложения.

Шаг 4. Вызов Vertex AI Gemini API

Теперь, когда вы подключили свое приложение к Firebase, добавили SDK и инициализировали службу Vertex AI и генеративную модель, вы готовы вызвать Vertex AI Gemini API .

Вы можете использовать generateContent() для генерации текста из текстового запроса на подсказку:

import FirebaseVertexAI

// Initialize the Vertex AI service
let vertex = VertexAI.vertexAI()

// Initialize the generative model with a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
let model = vertex.generativeModel(modelName: "gemini-1.5-flash")

// Provide a prompt that contains text
let prompt = "Write a story about a magic backpack."

// To generate text output, call generateContent with the text input
let response = try await model.generateContent(prompt)
if let text = response.text {
  print(text)
}

Что еще вы можете сделать?

Узнайте больше о моделях Gemini

Шаг 2. Добавьте SDK

После настройки проекта Firebase и подключения вашего приложения к Firebase (см. предыдущий шаг) вы теперь можете добавить Vertex AI in Firebase SDK в свое приложение.

Библиотека Vertex AI in Firebase обеспечивает доступ к Vertex AI Gemini API и включена как часть Firebase SDK для платформ Apple ( firebase-ios-sdk ). Для библиотеки Vertex AI in Firebase необходимо использовать Swift Package Manager для установки зависимостей Firebase и управления ими. Другие менеджеры пакетов, такие как CocoaPods, в настоящее время не поддерживаются.

1. В Xcode, открыв проект приложения, выберите «Файл» > «Добавить пакеты» .

2. При появлении запроса добавьте репозиторий SDK Firebase Apple для платформ:

     https://github.com/firebase/firebase-ios-sdk
   

3. Выберите последнюю версию SDK.

4. Выберите библиотеку FirebaseVertexAI-Preview .

   По завершении Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.

Шаг 3. Инициализируйте сервис Vertex AI и генеративную модель.

Прежде чем вы сможете выполнять какие-либо вызовы API, вам необходимо инициализировать службу Vertex AI и генеративную модель.

1. Импортируйте модуль FirebaseVertexAI :

   import FirebaseVertexAI
   

2. Инициализируйте сервис Vertex AI и генеративную модель:

   import FirebaseVertexAI
   
   // Initialize the Vertex AI service
   let vertex = VertexAI.vertexAI()
   
   // Initialize the generative model with a model that supports your use case
   // Gemini 1.5 models are versatile and can be used with all API capabilities
   let model = vertex.generativeModel(modelName: "gemini-1.5-flash")
   

Прочитав руководство по началу работы, узнайте, как выбрать модель Gemini и (необязательно) местоположение, подходящее для вашего варианта использования и приложения.

Шаг 4. Вызов Vertex AI Gemini API

Теперь, когда вы подключили свое приложение к Firebase, добавили SDK и инициализировали сервис Vertex AI и генеративную модель, вы готовы вызвать Vertex AI Gemini API .

Вы можете использовать generateContent() для генерации текста из текстового запроса на подсказку:

import FirebaseVertexAI

// Initialize the Vertex AI service
let vertex = VertexAI.vertexAI()

// Initialize the generative model with a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
let model = vertex.generativeModel(modelName: "gemini-1.5-flash")

// Provide a prompt that contains text
let prompt = "Write a story about a magic backpack."

// To generate text output, call generateContent with the text input
let response = try await model.generateContent(prompt)
if let text = response.text {
  print(text)
}

Что еще вы можете сделать?

Узнайте больше о моделях Gemini

Шаг 2 : Добавьте SDK

С помощью вашего проекта Firebase и вашего приложения подключено к Firebase (см. Предыдущий шаг), теперь вы можете добавить Vertex AI in Firebase SDK в ваше приложение.

Vertex AI in Firebase обеспечивает доступ к Vertex AI Gemini API и включена как часть SDK Firebase для платформ Apple ( firebase-ios-sdk ). Для Vertex AI in Firebase вы должны использовать Swift Package Manager для установки и управления зависимостями Firebase. Другие менеджеры пакетов, такие как кокопод, в настоящее время не поддерживаются.

1. В Xcode, открыв проект приложения, выберите «Файл» > «Добавить пакеты» .

2. При появлении запроса добавьте репозиторий SDK Firebase Apple для платформ:

     https://github.com/firebase/firebase-ios-sdk
   

3. Выберите последнюю версию SDK.

4. Выберите библиотеку FirebaseVertexAI-Preview .

   По завершении Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.

Шаг 3 : Инициализируйте сервис Vertex AI и генеративную модель

Прежде чем вы сможете сделать какие -либо вызовы API, вам необходимо инициализировать сервис Vertex AI и генеративную модель.

1. Импортируйте модуль FirebaseVertexAI :

   import FirebaseVertexAI
   

2. Инициализируйте сервис Vertex AI и генеративную модель:

   import FirebaseVertexAI
   
   // Initialize the Vertex AI service
   let vertex = VertexAI.vertexAI()
   
   // Initialize the generative model with a model that supports your use case
   // Gemini 1.5 models are versatile and can be used with all API capabilities
   let model = vertex.generativeModel(modelName: "gemini-1.5-flash")
   

Когда вы закончите руководство по началу работы, узнайте, как выбрать модель Близнецов и (необязательно) место , подходящее для вашего варианта использования и приложения.

Шаг 4 : Позвоните в Vertex AI Gemini API

Теперь, когда вы подключили свое приложение к Firebase, добавили SDK и инициализировали сервис Vertex AI и генеративную модель, вы готовы вызвать Vertex AI Gemini API .

Вы можете использовать generateContent() для создания текста из запроса только для текста:

import FirebaseVertexAI

// Initialize the Vertex AI service
let vertex = VertexAI.vertexAI()

// Initialize the generative model with a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
let model = vertex.generativeModel(modelName: "gemini-1.5-flash")

// Provide a prompt that contains text
let prompt = "Write a story about a magic backpack."

// To generate text output, call generateContent with the text input
let response = try await model.generateContent(prompt)
if let text = response.text {
  print(text)
}

Что еще вы можете сделать?

Узнайте больше о моделях Близнецов

Шаг 2 : Добавьте SDK

С помощью вашего проекта Firebase и вашего приложения подключено к Firebase (см. Предыдущий шаг), теперь вы можете добавить Vertex AI in Firebase SDK в ваше приложение.

Vertex AI in Firebase обеспечивает доступ к Vertex AI Gemini API и включена как часть SDK Firebase для платформ Apple ( firebase-ios-sdk ). Для Vertex AI in Firebase вы должны использовать Swift Package Manager для установки и управления зависимостями Firebase. Другие менеджеры пакетов, такие как кокопод, в настоящее время не поддерживаются.

1. В Xcode, открыв проект приложения, выберите «Файл» > «Добавить пакеты» .

2. При появлении запроса добавьте репозиторий SDK Firebase Apple для платформ:

     https://github.com/firebase/firebase-ios-sdk
   

3. Выберите последнюю версию SDK.

4. Выберите библиотеку FirebaseVertexAI-Preview .

   По завершении Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.

Шаг 3 : Инициализируйте сервис Vertex AI и генеративную модель

Прежде чем вы сможете сделать какие -либо вызовы API, вам необходимо инициализировать сервис Vertex AI и генеративную модель.

1. Импортируйте модуль FirebaseVertexAI :

   import FirebaseVertexAI
   

2. Инициализируйте сервис Vertex AI и генеративную модель:

   import FirebaseVertexAI
   
   // Initialize the Vertex AI service
   let vertex = VertexAI.vertexAI()
   
   // Initialize the generative model with a model that supports your use case
   // Gemini 1.5 models are versatile and can be used with all API capabilities
   let model = vertex.generativeModel(modelName: "gemini-1.5-flash")
   

Когда вы закончите руководство по началу работы, узнайте, как выбрать модель Близнецов и (необязательно) место , подходящее для вашего варианта использования и приложения.

Шаг 4 : Позвоните в Vertex AI Gemini API

Теперь, когда вы подключили свое приложение к Firebase, добавили SDK и инициализировали сервис Vertex AI и генеративную модель, вы готовы вызвать Vertex AI Gemini API .

Вы можете использовать generateContent() для создания текста из запроса только для текста:

import FirebaseVertexAI

// Initialize the Vertex AI service
let vertex = VertexAI.vertexAI()

// Initialize the generative model with a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
let model = vertex.generativeModel(modelName: "gemini-1.5-flash")

// Provide a prompt that contains text
let prompt = "Write a story about a magic backpack."

// To generate text output, call generateContent with the text input
let response = try await model.generateContent(prompt)
if let text = response.text {
  print(text)
}

Что еще вы можете сделать?

Узнайте больше о моделях Близнецов