Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Importar un agente de Google ADK — un agente sobre Gemini

La Agent Config de una aplicación construida sobre el Agent Development Kit de Google — un agente sobre Gemini, con la herramienta Google Search que incluye ADK — convertida en borradores de archivos Aggrega por aggrega import, con la imagen de la aplicación indicada una sola vez en un archivo de respuestas, y compilada para Docker Compose.

Importar un agente de Google ADK lo recorre paso a paso: el comando, lo que pregunta, los archivos que escribe y por qué está cada línea, la compilación y el agente en ejecución. Esta carpeta contiene cada etapa de ese recorrido:

carpeta o archivoqué contiene
source/la configuración del agente, support_agent/root_agent.yaml, el .aggrega-config.yaml que convierte la carpeta en un espacio de trabajo, y support_agent/import-answers.yaml, los valores que ninguna configuración contiene: la imagen de la aplicación y el nombre del Secret de Kubernetes del que una compilación para Kubernetes lee la clave de API de Gemini
draft/los archivos que escribió aggrega import support_agent --target compose, sin cambios, release.lock incluido, y lo que imprimió: stdout.txt en la salida estándar, import.txt en la salida de error estándar

La configuración está escrita para este ejemplo. El código de la aplicación y el archivo de entorno que escribe el andamiaje de ADK no forman parte de ella: la importación no lee ninguno de los dos, y la Release indica la imagen en la que se ejecuta la aplicación.

En un checkout del repositorio de la documentación, check.sh vuelve a ejecutar la importación, compara lo que escribe e imprime con draft/, compara los bloques que cita el recorrido con estos archivos, y valida y compila lo que escribió la importación. Necesita el catálogo de la biblioteca estándar (dónde conseguir uno) descargado junto a este repositorio, o su directorio indicado en AGGREGA_CATALOG_DIRS.

Generar el ejemplo

Puedes ejecutar la importación de este ejemplo con los comandos de abajo, o hacer que tu asistente de IA la ejecute por ti.

Escribe el ejemplo en una carpeta nueva con su nombre:

Terminal window
aggrega scaffold --example import-google-adk

Después imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:

Terminal window
cd import-google-adk

Compilación

La importación redacta los borradores de los archivos Aggrega junto al proyecto, en source/. Evalúa el proyecto frente al catálogo de la biblioteca estándar, que el registro predeterminado del espacio de trabajo publica como una instantánea firmada: la primera importación lo obtiene, lo verifica, lo guarda en la caché de contenido del espacio de trabajo y lo nombra por su digest en el registro que escribe junto a los borradores. Un espacio de trabajo que nombra sus propias carpetas de catálogo — en AGGREGA_CATALOG_DIRS, o bajo workspace.catalog_dirs — importa en cambio frente a ellas. La importación lee la imagen de support_agent/import-answers.yaml y luego descarga aquello de lo que depende la Release redactada, de modo que la compilación sigue de inmediato:

Terminal window
cd source
aggrega import support_agent --target compose
aggrega build --release release.yaml

La imagen que nombra el ejemplo representa una que compilas a partir de tu proyecto; cómo compilarla y ejecutar el stack se explica en el recorrido enlazado arriba.

Con un asistente de IA

Un asistente de IA configurado con las herramientas de Aggrega puede hacer lo mismo: pégale este prompt.

Usa solo las herramientas de Aggrega y no crees ninguna carpeta por tu cuenta. Si la carpeta del espacio de trabajo todavía no contiene una carpeta `import-google-adk`, llama una vez a la herramienta `scaffold` con `example` establecido en `import-google-adk` y sin `dir`: escribe el ejemplo en una nueva carpeta `import-google-adk`, cuya carpeta `source` contiene lo que importa este ejemplo. Luego llama a la herramienta `import` con `workspace_root` establecido en `import-google-adk/source`, `source` establecido en `support_agent` y `target` establecido en `compose`: lee las respuestas que necesita de `import-answers.yaml` dentro de la carpeta `support_agent`, escribe sus borradores en `import-google-adk/source` y descarga lo que estos necesitan. Luego llama a la herramienta `validate` con `workspace_root` establecido en `import-google-adk/source` y `release` establecido en `release.yaml`, y a la herramienta `build` con `workspace_root` establecido en `import-google-adk/source`, `release` establecido en `release.yaml` y `write` establecido en true. Dime qué archivos escribió la compilación; están en `import-google-adk/source/dist/`.

Probarlo

Con el stack en ejecución tal como lo ejecuta la guía, sobre la imagen que construye su Dockerfile, envía un mensaje al agente en el puerto que publica la Release:

Terminal window
curl -sS -X POST http://127.0.0.1:8000/run -H 'Content-Type: application/json' \
-d '{"app_name": "support_agent", "user_id": "u1", "session_id": "s1", "new_message": {"role": "user", "parts": [{"text": "Where is my order 1234? Answer in one short sentence."}]}}'

La clave de Gemini de la ejecución era un marcador de posición, así que la solicitud respondió HTTP 500, Internal Server Error, y el registro del servicio menciona el rechazo de Gemini:

google.genai.errors.ClientError: 400 INVALID_ARGUMENT. {'error': {'code': 400, 'message': 'API key not valid. Please pass a valid API key.', 'status': 'INVALID_ARGUMENT', [… omitted: the error's details]}}

Importado con --target helm, sobre la imagen subida a un registro que lee el clúster, como muestra la guía, el agente responde al mismo mensaje en la misma dirección una vez que se reenvía un puerto local a su Service:

Terminal window
kubectl port-forward -n <namespace> svc/support-agent-default 8000:8000