O Firebase Genkit tem integrações integradas que ajudam você a implantar seus fluxos no Firebase Cloud Functions e no Google Cloud Run, mas também é possível implantar seus fluxos em qualquer plataforma que possa disponibilizar um app Express.js, seja um serviço em nuvem ou auto-hospedado.
Nesta página, você verá um exemplo de como implantar o fluxo de amostra padrão.
Instale as ferramentas necessárias:
- Verifique se você está usando o nó 20 ou versão mais recente (execute
node --version
para verificar).
- Verifique se você está usando o nó 20 ou versão mais recente (execute
Crie um diretório para o projeto de amostra do Genkit:
export GENKIT_PROJECT_HOME=~/tmp/genkit-express-project
mkdir -p $GENKIT_PROJECT_HOME
cd $GENKIT_PROJECT_HOME
Se você for usar um ambiente de desenvolvimento integrado, abra-o nesse diretório.
Inicialize um projeto nodejs:
npm init -y
Inicialize um projeto Genkit:
genkit init
Selecione
Node.js
como a opção da plataforma de implantação. Modelos para o Firebase Cloud Functions e o Google Cloud Run também estão disponíveis.Selecione o modelo:
Gemini (IA do Google)
A maneira mais simples de começar é com a API Google AI Gemini. Verifique se ele está disponível na sua região.
Gere uma chave de API para a API Genmini usando o Google AI Studio. Em seguida, defina a variável de ambiente
GOOGLE_API_KEY
como sua chave:export GOOGLE_API_KEY=<your API key>
Gemini (Vertex AI)
Se a API Gemini do Google não estiver disponível na sua região, use a API Vertex AI, que também oferece o Gemini e outros modelos. Você precisará ter um projeto do Google Cloud com faturamento ativado, habilitar a API AI Platform e definir algumas variáveis de ambiente adicionais:
gcloud services enable aiplatform.googleapis.com
export GCLOUD_PROJECT=<your project ID>
export GCLOUD_LOCATION=us-central1
Consulte os preços da Vertex AI em https://cloud.google.com/vertex-ai/generative-ai/pricing.
Escolha respostas padrão para o restante das perguntas. Isso inicializa a pasta do projeto com um exemplo de código.
Crie e execute o exemplo de código:
npm run build
genkit flow:run menuSuggestionFlow "\"banana\"" -s
Opcional: inicie a interface do desenvolvedor:
genkit start
Em seguida, navegue até http://localhost:4000/flows e execute o fluxo usando a interface do desenvolvedor.
Quando terminar, pressione Ctrl+C no console para sair da interface.
Teste o endpoint Express:
npm run start
Depois, em outra janela:
curl -X POST "http://127.0.0.1:3400/menuSuggestionFlow?stream=true" -H "Content-Type: application/json" -d '{"data": "banana"}'
Se tudo estiver funcionando como esperado, implante o fluxo no provedor de sua escolha. Os detalhes dependem do provedor, mas geralmente é necessário definir as seguintes configurações:
Configuração Valor Ambiente de execução Node.js 20 ou versão mais recente Comando de build npm run build
Iniciar comando npm run start
Variáveis de ambiente GOOGLE_API_KEY=<your-api-key>
(ou qualquer secret necessário)