Migre para a versão de disponibilidade geral da Vertex AI no Firebase


O Vertex AI in Firebase foi lançado em disponibilidade geral (GA) em 21 de outubro de 2024.

Se você usou a versão de acesso antecipado da biblioteca Vertex AI in Firebase (firebase/vertexai-preview), faça as seguintes mudanças para fazer upgrade e usar a versão GA da biblioteca (firebase/vertexai).

Confira uma lista geral das mudanças necessárias para a migração:

Ative a nova API necessária no seu projeto do Firebase (obrigatória para todos)

É necessário ativar a API Vertex AI in Firebase no seu projeto do Firebase e adicioná-la à lista de permissões da chave da API do Firebase. Essa é uma nova API necessária para usar a versão GA de Vertex AI in Firebase.

  1. No console do Firebase, acesse a página Criar com o Gemini.

  2. No card Vertex AI in Firebase, clique em Começar para iniciar um fluxo de trabalho que ajuda a ativar essa API e adicioná-la à lista de permissões da chave de API do Firebase.

  3. Você pode pular o restante do fluxo de trabalho no console.

Atualização para a versão GA da biblioteca (obrigatória para todos)

Siga estas instruções para atualizar a base de código do app e usar a versão GA da biblioteca:

  1. Instale a versão mais recente do SDK do Firebase para JavaScript na Web usando o npm:

    npm i firebase@latest

    OU

    yarn add firebase@latest

  2. Onde quer que você tenha importado a biblioteca, atualize as instruções de importação para usar firebase/vertexai:

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

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

Outras mudanças (obrigatórias dependendo dos recursos usados)

Várias mudanças foram implementadas nas versões GA dos SDKs. Analise as listas a seguir para conferir se há mudanças que você precisa fazer no código para usar a versão GA do SDK no seu app.

  • Chamada de função
    Se você implementou esse recurso antes do GA, será necessário fazer atualizações na maneira como define seu esquema. Recomendamos que você revise o guia atualizado de chamadas de função para saber como escrever as declarações de função.

  • Como gerar saída estruturada (como JSON) usando responseSchema
    Se você implementou esse recurso antes do lançamento oficial, será necessário fazer atualizações na maneira como o esquema é definido. Recomendamos que você revise o novo guia de saída estruturada para saber como escrever esquemas JSON.

  • Tempo limite

    • O tempo limite padrão para solicitações foi alterado para 180 segundos.

  • Enumerações

    • Valores removidos das seguintes enumerações: HarmCategory, BlockThreshold, HarmProbability, HarmSeverity, BlockReason e FinishReason.

  • Motivo do bloqueio

    • O blockReason em PromptFeedback foi alterado para ser opcional.

Possíveis erros relacionados à migração

Ao migrar para a versão GA do Vertex AI in Firebase, você pode encontrar erros se não tiver concluído todas as mudanças necessárias, conforme descrito neste guia de migração.

Erro 403: Requests to this API firebasevertexai.googleapis.com ... are blocked.

Se você receber um erro 403 com a mensagem Requests to this API firebasevertexai.googleapis.com ... are blocked., geralmente significa que a chave de API no arquivo/objeto de configuração do Firebase não tem uma API necessária na lista de permissões para o produto que você está tentando usar.

Verifique se a chave de API usada pelo app tem todas as APIs necessárias incluídas na lista de permissões "Restrições de API". Para Vertex AI in Firebase, a chave de API precisa ter pelo menos a API Vertex AI in Firebase na lista de permissões. Essa API precisa ter sido adicionada automaticamente à lista de permissões da chave de API quando você ativou a nova API pelo console Firebase.

É possível conferir todas as chaves de API no painel APIs e serviços > Credenciais no console Google Cloud.