Firebase Genkit com Cloud Run

É possível implantar fluxos do Firebase Genkit como serviços da Web usando o Cloud Run. Esta página, como exemplo, orienta você no processo de implantação do fluxo de amostra padrão.

1. Instale as ferramentas necessárias:

   1. Verifique se você está usando o Node.js versão 20 ou mais recente (execute node --version para verificar).

   2. Instale o Google Cloud CLI:

2. Crie um novo projeto do Google Cloud usando o console do Cloud ou escolha um atual. O projeto precisa estar vinculado a uma conta de faturamento.

   Depois de criar ou escolher um projeto, configure a CLI do Google Cloud para usar ele:

   gcloud init

3. Crie um diretório para o projeto de amostra do Genkit:

   mkdir -p ~/tmp/genkit-cloud-project
   cd ~/tmp/genkit-cloud-project

   Se você for usar um ambiente de desenvolvimento integrado, abra-o nesse diretório.

4. Inicialize um projeto Node.js no diretório do projeto:

   npm init -y

5. Inicialize o Genkit no seu projeto Node.js:

   genkit init

   Selecione o provedor do modelo que você quer usar. Aceite os padrões da comandos restantes. A ferramenta genkit criará alguns arquivos de origem de amostra para começar a desenvolver seus próprios fluxos de IA. Para o restante deste curso, . No entanto, você só vai implantar o fluxo de amostra.

6. Disponibilize as credenciais da API para a função implantada. Siga uma destas etapas a seguir, dependendo do provedor de modelos escolhido:

   Gemini (IA do Google)

   1. Garanta que a IA do Google disponíveis na sua região.

   2. Gere uma chave de API para à API Gemini usando o Google AI Studio.

   3. Disponibilize a chave de API no ambiente do Cloud Run:

      1. No console do Cloud, ative a API Secret Manager.
      2. Na página Secret Manager, crie um novo secret com sua chave de API.
      3. Depois de criar o secret, na mesma página, conceda acesso da conta de serviço ao secret com o papel de Acessador de secrets do Secret Manager. Você pode procurar o nome da conta de serviço padrão do Compute na página do IAM.

      Em uma etapa posterior, quando implantar o serviço, será preciso fazer referência ao nome do secret.

   4. Opcional: se você quiser executar seu fluxo localmente, como no próximo defina a variável de ambiente GOOGLE_GENAI_API_KEY como sua chave:

      export GOOGLE_GENAI_API_KEY=<your API key>

   Gemini (Vertex AI)

   1. No console do Cloud, Ative a API Vertex AI para seu projeto.

   2. Na página IAM, verifique se a Conta de serviço padrão do Compute tem o papel de Usuário da Vertex AI.

   3. Opcional: se você quiser executar seu fluxo localmente, como no próximo defina algumas variáveis de ambiente adicionais e use o Ferramenta gcloud para configurar Application Default Credentials:

      export GCLOUD_PROJECT=<your project ID>
      export GCLOUD_LOCATION=us-central1
      gcloud auth application-default login

   O único secret que você precisa configurar para este tutorial é para o provedor de modelo, mas em geral, você precisa fazer algo semelhante para cada serviço que seu fluxo usa.

7. Opcional: teste o fluxo na interface do desenvolvedor:

   1. Inicie a interface:

      genkit start

   2. Na interface do desenvolvedor (http://localhost:4000/), execute o fluxo:

      1. Clique em menuSuggestionFlow.

      2. Na guia Inserir JSON, forneça um assunto para o modelo:

         "banana"
         

      3. Clique em Executar.

8. Se tudo estiver funcionando como esperado até agora, você poderá criar e implantar o fluxo:

   Gemini (IA do Google)

   npm run build
   gcloud run deploy --update-secrets=GOOGLE_GENAI_API_KEY=<your-secret-name>:latest

   Gemini (Vertex AI)

   npm run build
   gcloud run deploy

   Escolha N quando for perguntado se você quer permitir invocações não autenticadas. Se você responder N, o serviço será configurado para exigir credenciais do IAM. Consulte Autenticação nos documentos do Cloud Run para saber como fornecer essas credenciais.

Depois que a implantação terminar, a ferramenta imprimirá o URL de serviço. É possível testar isso com curl:

curl -X POST https://<service-url>/menuSuggestionFlow \
-H "Authorization: Bearer $(gcloud auth print-identity-token)" \
-H "Content-Type: application/json" -d '{"data": "banana"}'