¡Bienvenidos al repositorio oficial del Hackathon de Sistemas de Agentes, organizado por Diverger y Google Cloud!
Este repositorio contiene los proyectos base, recursos y guías que necesitarás para empezar a construir tu agente inteligente durante el evento. Nuestro objetivo es que aprendas, experimentes y, sobre todo, ¡te diviertas!
Sigue estos pasos para tener tu entorno listo para la acción.
Hemos preparado un Entorno Virtual donde podrás obtener los recursos necesarios para hacer el lab: Podrás encontrarlo el día del hackathon aqui: https://explore.qwiklabs.com/ registrándote con tu cuenta de registro del hackathon. Durante el día del evento os enseñaremos como utilizar este entorno, etc.
Asegúrate de tener instalado el siguiente software en tu entorno virtual o máquina:
-
Python (versión 3.9 o superior)
-
(Opcional) JDK (si prefieres trabajar con Java)
-
(Opcional) Google Cloud CLI
-
Instala ADK: https://google.github.io/adk-docs/get-started/installation/
Abre tu terminal y clona este repositorio en tu máquina local:
git clone https://github.com/DivergerThinking/hackathon-ADK-Google
cd hackathon-ADK-GoogleTenemos 3 retos temáticos para inspirarte. Hemos preparado proyectos base para que no empieces desde cero.
🧠 Agente de Deep Research
Un sistema que colabora para investigar a fondo cualquier temática, analizando documentos o papers.python/academic-research
🗣️ Agente por Interlocución de Voz
Un agente para gestionar reservas, cobros o soporte, que pueda interactuar en tiempo real.
python/custom-streaming
✨ Reto de Temática Libre ¡Tu idea, tus reglas! Usa las herramientas para construir el agente que siempre has imaginado. Cualquiera de los anteriores
- Navega a la carpeta del proyecto que elegiste. Por ejemplo:
cd python/academic-research - Crea un entorno virtual. Es una buena práctica para aislar las dependencias de tu proyecto.
python -m venv venv source venv/bin/activate # En Windows: venv\Scripts\activate
- Instala las dependencias.
pip install -r requirements.txt
- ¡Instala el proyecto! Revisa el
README.mdespecífico dentro de la carpeta del proyecto para ver las instrucciones sobre cómo instalarlo y ejecutarlo.
- ¿Qué hace? Este agente utiliza el ADK (Agent Development Kit) de Google para simular un asistente de investigación. Puede tomar un tema, buscar "papers" (documentos) y determinar si son relevantes o interesantes según ciertos criterios.
- Ideal para: El reto "Agente de Deep Research". Puedes extenderlo para que busque en otras fuentes, resuma los hallazgos o genere un informe.
- Fuente original: Google ADK Samples - Academic Research
- ¿Qué hace? Este es un ejemplo de streaming bidireccional (BI-DI) con el ADK. Permite que el agente reciba y envíe información en tiempo real, en lugar de esperar a que el usuario termine de hablar.
- Ideal para: El reto "Agente por Interlocución de Voz". Es la base perfecta para cualquier aplicación que necesite una conversación fluida y natural, como un asistente de voz, un bot de soporte en vivo o un sistema de reservas interactivo.
- Multi-idioma: ¡Tenemos ejemplos en Python y Java!
- Python: ADK Custom Streaming Docs
- Java: ADK Streaming Quickstart Java
Nota para desarrolladores Java: ¡Sois más que bienvenidos! Aunque los ejemplos principales están en Python, el ADK es compatible con Java. Anímate a usar la base de
custom-streamingen Java. Si tienes dudas, ¡pregunta a los mentores! Tienes ejemplos de Agentes en Java aqui: https://github.com/google/adk-samples/tree/main/java/agents
¿Eres nuevo con ADK y necesitas practicar antes del hackathon? Échale un vistazo a los siguientes recursos:
https://codelabs.developers.google.com/your-first-agent-with-adk?hl=es-419#0 https://codelabs.developers.google.com/devsite/codelabs/build-agents-with-adk-foundation?hl=es-419#0 https://www.cloudskillsboost.google/course_templates/1275
- Hemos preparado un Entorno Virtual donde podrás obtener los recursos necesarios para hacer el lab: Podrás encontrarlo el día del hackathon aqui: https://explore.qwiklabs.com/ registrándote con tu cuenta de registro del hackathon. Durante el día del evento os enseñaremos como utilizar este entorno, etc.
Durante el hackathon, daremos 3 "píldoras técnicas" sobre conceptos. Aquí tienes la documentación para ir abriendo boca:
-
Como funciona BI-DI Agentes en tiempo real:
- Los agentes pueden utilizar ADK para interactuar con video y voz en real-time y con llamadas de baja latencia.
- Documentación: ADK BI-DI Agents
-
Uso del Framework de Memoria de Google:
- Para que un agente sea útil, debe recordar interacciones pasadas. Veremos cómo gestionar la memoria a corto y largo plazo.
- Documentación: Managing Agent Memory
-
Publicar Agentes en GCP o AgentSpaces:
- Lleva tu agente del local a la nube. Te enseñaremos cómo desplegarlo en Google Cloud Platform o en el futuro AgentSpaces.
- Documentación: Deploying an Agent
- Formato: Cada equipo dispondrá de 5 minutos para un "Elevator Pitch" y una demo de su proyecto.
- Jurado: El jurado evaluará las propuestas basándose en:
- Innovación y Originalidad: ¿La idea es creativa y resuelve un problema interesante?
- Ejecución Técnica: ¿El agente funciona? ¿Qué tan complejo y bien implementado está?
- Uso del ADK y Ecosistema Google: ¿Se aprovechan las herramientas y conceptos vistos (Tools, Memoria, Streaming)?
- Presentación: Claridad y capacidad de "vender" vuestro proyecto.
Durante todo el evento, tendrás a tu disposición un equipo de mentores de Diverger y Google. No dudes en levantar la mano o buscarnos si tienes dudas, te atascas con el código o simplemente quieres rebotar una idea.
¡Estamos aquí para aprender y pasar un buen rato!
