Começar a usar a API Gemini usando a Vertex AI nos SDKs do Firebase


Este guia mostra como começar a fazer chamadas para o Vertex AI Gemini API diretamente do seu app usando o Vertex AI in Firebase SDK para a plataforma escolhida.

Pré-requisitos

Este guia pressupõe que você esteja familiarizado com o uso do Xcode para desenvolver aplicativos para Plataformas da Apple (como iOS).

  • Verifique se o ambiente de desenvolvimento e o app das plataformas da Apple atendem aos requisitos requisitos a seguir:

    • Xcode 15.0 ou mais recente
    • O app precisa ser direcionado ao iOS 15 ou mais recente ou ao macOS 12 ou mais recente.
  • (Opcional) Confira o app de exemplo.

    Fazer o download do app de exemplo

    É possível testar o SDK rapidamente, ver uma implementação completa de vários recursos casos ou use o aplicativo de exemplo se você não tiver seu próprio aplicativo de plataformas da Apple. Para usar o app de exemplo, você precisará conectá-lo a um projeto do Firebase.

Etapa 1: configurar um projeto do Firebase e conectar o app ao Firebase

Se você tem um projeto do Firebase e um app conectado a ele

  1. No console Firebase, acesse a página Build with Gemini.

  2. Clique no card Vertex AI in Firebase para iniciar um fluxo de trabalho que ajuda você conclua as tarefas a seguir. Se aparecer uma guia no console para Vertex AI, as tarefas serão concluídas.

  3. Siga para a próxima etapa deste guia para adicionar o SDK ao app.

Se você ainda não tiver um projeto do Firebase e um app conectado a ele


Etapa 2: adicionar o SDK

Com o projeto do Firebase configurado e o app conectado ao Firebase (consulte a etapa anterior), agora é possível adicionar o SDK do Vertex AI in Firebase ao seu app.

A biblioteca Vertex AI in Firebase fornece acesso aos Vertex AI Gemini API e está incluído como parte do SDK do Firebase para Plataformas da Apple (firebase-ios-sdk). Para a biblioteca Vertex AI in Firebase, use o Gerenciador de pacotes do Swift para instalar e gerenciar o Firebase dependências. Outros gerenciadores de pacotes, como o CocoaPods, não são compatíveis no momento.

  1. No Xcode, com seu projeto do app aberto, navegue até File > Add Packages.

  2. Quando solicitado, adicione o repositório do SDK do Firebase para as plataformas Apple:

      https://github.com/firebase/firebase-ios-sdk
    
  3. Selecione a versão mais recente do SDK.

  4. Selecione a biblioteca FirebaseVertexAI-Preview.

    Quando terminar, o Xcode vai começar a resolver e fazer o download das dependências em segundo plano automaticamente.

Etapa 3: inicializar o serviço Vertex AI e o modelo generativo

Antes de fazer chamadas de API, você precisa inicializar o Vertex AI. e o modelo generativo.

  1. Importe o módulo FirebaseVertexAI:

    import FirebaseVertexAI
    
  2. Inicialize o serviço Vertex AI e o modelo generativo:

    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")
    

Quando terminar o Guia explicativo, aprenda a escolher um modelo Gemini e, opcionalmente, um o local apropriado para seu caso de uso e app.

Etapa 4: chamar Vertex AI Gemini API

Agora que você conectou seu app ao Firebase, adicionou o SDK e inicializou o serviço Vertex AI e o modelo generativo, está tudo pronto para chamar o Vertex AI Gemini API.

Você pode usar generateContent() para gerar texto de uma solicitação de comando de texto exclusivo:

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)
}

O que mais você pode fazer?

Saiba mais sobre os modelos do Gemini

Saiba mais sobre o modelos disponíveis para diversos casos de uso e as cotas e preços.

Testar outros recursos do Gemini API

Saiba como controlar a geração de conteúdo

Também é possível testar comandos e configurações de modelo usando Vertex AI Studio.


Envie feedback sobre sua experiência com Vertex AI in Firebase