Agent: adk_example

Documentación para el agente adk_example incluido en este repositorio.

Descripción

El agente adk_example es una plantilla ligera para ejecutar un agente que interactúa con servicios en la nube. Este README describe cómo lanzar el agente y las variables de entorno obligatorias para su correcto funcionamiento y evaluación.

Requisitos

• Tener instalado el ADK (Agent Development Kit) y estar familiarizado con su comando adk run.
• Acceso a las credenciales necesarias para usar el servicio de Bedrock (u otro servicio configurado internamente por el agente).

Variables de entorno obligatorias

Antes de lanzar el agente, exporta las siguientes variables de entorno en tu shell:

• AWS_REGION_NAME — Región de AWS que debe usar el agente (por ejemplo us-east-1).
• AWS_BEARER_TOKEN_BEDROCK — Token de autorización (Bearer token) para acceder al servicio Bedrock.

Ejemplo (zsh):

export AWS_REGION_NAME=us-east-1
export AWS_BEARER_TOKEN_BEDROCK="<tu_bearer_token_aqui>"

Cómo lanzar el agente

Para iniciar el agente usa el siguiente comando desde la raíz del proyecto:

# En desarrollo (usar ADK)
adk run adk_example

# También puedes ejecutar cualquier agente por su nombre:
adk run <nombre_del_agente>

# Lanzar la interfaz web de desarrollo (si está disponible)
adk web

Para ejecutar el agente fuera del ADK (por ejemplo en un entorno de producción o para pruebas fuera del flujo de desarrollo) puedes ejecutar directamente el script del ejemplo así:

uv run python adk_example/runner.py

Este conjunto de comandos permite lanzar el agente en modo desarrollo usando las herramientas del ADK (adk run, adk web) o ejecutar el ejemplo directamente cuando se desea correrlo sin el ADK.

Evaluación del agente

Para ejecutar las pruebas y evaluar el agente, usa:

uv run pytest -v eval

Esto ejecuta los tests definidos en el directorio eval usando pytest a través de uv.

Contacto y contribuciones

Si encuentras errores o quieres mejorar la plantilla, abre un issue o PR en este repositorio con una descripción clara del cambio.