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


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

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

В этом руководстве предполагается, что вы знакомы с использованием JavaScript для разработки веб-приложений. Это руководство не зависит от платформы.

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

    • (Необязательно) Node.js
    • Современный веб-браузер
  • (Необязательно) Ознакомьтесь с примером приложения.

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

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

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

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

  1. В консоли Firebase перейдите на страницу «Создать с помощью Gemini» и щелкните вторую карточку, чтобы запустить рабочий процесс, который поможет вам выполнить следующие задачи. Если вы видите в консоли вкладку Vertex AI, значит, эти задачи выполнены.

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

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


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

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

Библиотека Vertex AI для Firebase обеспечивает доступ к API Vertex AI Gemini и включена в состав Firebase JavaScript SDK для Интернета.

  1. Установите Firebase JS SDK для Интернета с помощью npm:

    npm install firebase
    
  2. Инициализируйте Firebase в своем приложении:

    import { initializeApp } from "firebase/app";
    
    // 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);
    

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

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

import { initializeApp } from "firebase/app";
import { getVertexAI, getGenerativeModel } from "firebase/vertexai-preview";

// 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 Vertex AI service
const vertexAI = getVertexAI(firebaseApp);

// 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
const model = getGenerativeModel(vertexAI, { model: "gemini-1.5-flash" });

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

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

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

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

import { initializeApp } from "firebase/app";
import { getVertexAI, getGenerativeModel } from "firebase/vertexai-preview";

// 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 Vertex AI service
const vertexAI = getVertexAI(firebaseApp);

// 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
const model = getGenerativeModel(vertexAI, { model: "gemini-1.5-flash" });

// Wrap in an async function so you can use await
async function run() {
  // Provide a prompt that contains text
  const prompt = "Write a story about a magic backpack."

  // To generate text output, call generateContent with the text input
  const result = await model.generateContent(prompt);

  const response = result.response;
  const text = response.text();
  console.log(text);
}

run();
l10n

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

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

Узнайте о моделях, доступных для различных вариантов использования , а также об их квотах и ​​ценах .

Попробуйте другие возможности Gemini API

Узнайте, как контролировать создание контента

Вы также можете поэкспериментировать с подсказками и конфигурациями модели с помощью Vertex AI Studio .


Оставьте отзыв о своем опыте использования Vertex AI для Firebase.