1. Introducción
Crearás un agente que pueda responder cualquier consulta sobre las noticias y lo implementarás en Cloud Run. Las noticias pueden ser sobre cualquier tema relacionado con una sola ubicación: "Bengaluru". Estas son algunas de las preguntas que puedes hacer:
- ¿Me puedes contar sobre las últimas noticias de Bengaluru?
- Dame algunas noticias recientes relacionadas con el tráfico de Bengaluru.
Puedes implementar agentes en Cloud Run. Crearemos un agente simple que use el modelo y una herramienta local, y, luego, lo implementaremos.
Qué aprenderá
- Cómo configurar un proyecto de Google Cloud para Cloud Run
- Cómo compilar un agente de IA simple con el ADK de Google
- Cómo definir y usar herramientas locales dentro del agente
- Cómo empaquetar el agente con Docker
- Cómo implementar el agente como un servicio en Google Cloud Run
- Cómo interactuar con el agente implementado a través de una IU web
Lo que necesitarás
- Una cuenta de Gmail
- Navegador Chrome
2. Configura el entorno de Google Cloud
Cómo obtener créditos de Cloud
Reclama tu crédito de regalo, ya que lo necesitarás para la implementación. Asegúrate de usar tu cuenta de Gmail.
Crea un proyecto
- En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.
- Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Obtén información sobre cómo verificar si la facturación está habilitada en un proyecto.
- Haz clic en este vínculo para activar Cloud Shell.
- Para configurar la cuenta activa, ejecuta el siguiente comando en Cloud Shell:
gcloud config set account <ACCOUNT>
Ten en cuenta que ACCOUNT es tu cuenta de Gmail que usaste para acceder a Google Cloud.
- Para verificar tu autenticación, ejecuta el siguiente comando en Cloud Shell:
gcloud auth list
- Confirma el ID del proyecto con el siguiente comando:
gcloud config list project
- Configura la variable del ID del proyecto. Reemplaza <YOUR_PROJECT_ID> por el ID del paso anterior:
export PROJECT_ID=<YOUR_PROJECT_ID> && gcloud config set project $PROJECT_ID
export REGION=europe-west1 && gcloud config set run/region $REGION
- Configura la clave de la API de Google:
Genera tu clave de API con https://aistudio.google.com/app/apikey y pégala aquí:
export GOOGLE_API_KEY=PASTE_YOUR_ACTUAL_API_KEY_HERE
export GOOGLE_GENAI_USE_VERTEXAI=FALSE
- Habilita las API necesarias:
gcloud services enable cloudresourcemanager.googleapis.com \
servicenetworking.googleapis.com \
run.googleapis.com \
cloudbuild.googleapis.com \
artifactregistry.googleapis.com \
aiplatform.googleapis.com \
compute.googleapis.com \
storage.googleapis.com
(Esto podría tardar unos minutos).
Clona muestras de código para los talleres del Día de Cloud Run
Para acceder al código de muestra de todos los talleres, clona el repositorio completo:
git clone https://github.com/shrutimantri/first-adk-agent5.git
3. Implementa el agente en Cloud Run
Una vez que tengas todos los archivos listos en el editor de Cloud Shell, ejecuta los siguientes comandos en la terminal de Cloud Shell para implementar el servicio en 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"
(Confirma la implementación escribiendo "Y" cuando se te solicite).
4. Prueba el agente
Cuando la implementación se realice correctamente, Cloud Shell generará la URL del servicio de Cloud Run implementado.
Cuando abras el vínculo, podrás interactuar directamente con tu agente a través de la IU web del ADK:
5. Limpieza
Para evitar cargos futuros, borra el servicio de Cloud Run que creaste.
gcloud run services delete news-assistant-agent --region $REGION $GOOGLE_CLOUD_LOCATION --quiet
6. ¡Felicitaciones!
Compilaste e implementaste correctamente un agente de noticias basado en IA en Google Cloud Run.