Codelab: Cloud Run Day 2025 – Workshop 1

1. Introdução

Você vai criar um agente que pode responder a qualquer consulta sobre notícias e implantá-lo no Cloud Run. As notícias podem ser sobre qualquer assunto relacionado a apenas um local, "Bengaluru". Algumas das consultas podem ser:

  • Você pode me contar algumas das últimas notícias de Bangalore?
  • Me conte algumas notícias recentes sobre o trânsito de Bangalore.

É possível implantar agentes no Cloud Run. Vamos criar um agente simples que usa o modelo e uma ferramenta local e depois implantá-lo.

O que você aprenderá

  • Como configurar um projeto do Google Cloud para o Cloud Run.
  • Como criar um agente de IA simples usando o ADK do Google.
  • Como definir e usar ferramentas locais no agente.
  • Como empacotar o agente usando o Docker.
  • Como implantar o agente como um serviço no Google Cloud Run.
  • Como interagir com o agente implantado em uma interface da Web.

O que é preciso

  • Uma conta do Gmail
  • Navegador Chrome

2. Configuração

  1. Siga todas as instruções de configuração neste link.
  2. Navegue até o diretório do primeiro workshop:
cd Cloud-Run-Day-Workshop-2025/workshop1

3. Implantar o agente no Cloud Run

Depois que todos os arquivos estiverem prontos no editor do Cloud Shell, execute os seguintes comandos no terminal do Cloud Shell para implantar o serviço no Cloud Run:

gcloud run deploy news-assistant-agent \
--source . \
--region $REGION \
--project $PROJECT_ID \
--allow-unauthenticated \
--set-env-vars="GOOGLE_GENAI_USE_VERTEXAI=$GOOGLE_GENAI_USE_VERTEXAI,GOOGLE_API_KEY=$GOOGLE_API_KEY"

(Confirme a implantação digitando "Y" quando/se solicitado.)

4. Testar o agente

Após a implantação, o Cloud Shell vai gerar o URL do serviço implantado do Cloud Run.

Captura de tela da saída do URL do serviço do Cloud Run

Ao abrir o link, você pode interagir diretamente com seu agente usando a interface da Web do ADK:

Captura de tela da interface da Web do ADK

5. Limpeza

Para evitar cobranças futuras, exclua o serviço do Cloud Run que você criou.

gcloud run services delete news-assistant-agent --$REGION $GOOGLE_CLOUD_LOCATION  --quiet

6. Parabéns!

Você criou e implantou um agente de notícias de IA no Google Cloud Run.