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

Importar un agente declarativo de Microsoft Agent Framework — un agente y un servidor MCP

Un agente declarativo de Microsoft Agent Framework — un agente sobre un modelo de OpenAI, que busca en la documentación a través de un servidor MCP — convertido 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 compilado para Docker Compose.

Importar un agente declarativo de Microsoft Agent Framework lo recorre paso a paso: el comando, lo que pregunta, los archivos que escribe y por qué está ahí 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/el agente declarativo, support-agent.yaml, el .aggrega-config.yaml que convierte la carpeta en un espacio de trabajo, y import-answers.yaml, los valores que ningún agente declarativo 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 OpenAI
draft/los archivos que escribió aggrega import support-agent.yaml --target compose, sin cambios, incluido release.lock, y lo que imprimió: stdout.txt en la salida estándar, import.txt en la salida de error estándar

El agente declarativo está escrito para este ejemplo. El código de la aplicación, que lo carga, no forma parte de él: la importación nunca lo lee, 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-agent-framework

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

Terminal window
cd import-agent-framework

Compilación

La importación redacta los borradores de los archivos Aggrega junto al agente declarativo, 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 descarga, lo verifica, lo guarda en la caché de contenido del espacio de trabajo y lo identifica por su digest en el archivo de constancia que escribe junto a los borradores. Un espacio de trabajo que indica sus propias carpetas de catálogo — en AGGREGA_CATALOG_DIRS, o bajo workspace.catalog_dirs — importa en cambio frente a esas. La importación lee la imagen de 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.yaml --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 aún no contiene una carpeta `import-agent-framework`, llama una vez a la herramienta `scaffold` con `example` establecido en `import-agent-framework` y sin `dir`: escribe el ejemplo en una nueva carpeta `import-agent-framework`, cuya carpeta `source` contiene lo que este ejemplo importa. Después llama a la herramienta `import` con `workspace_root` establecido en `import-agent-framework/source`, `source` establecido en `support-agent.yaml` y `target` establecido en `compose`: lee las respuestas que necesita de `import-answers.yaml`, junto a `support-agent.yaml`, escribe sus borradores en `import-agent-framework/source` y descarga lo que necesitan. Después llama a la herramienta `validate` con `workspace_root` establecido en `import-agent-framework/source` y `release` establecido en `release.yaml`, y a la herramienta `build` con `workspace_root` establecido en `import-agent-framework/source`, `release` establecido en `release.yaml` y `write` establecido en true. Dime qué archivos escribió la compilación; están en `import-agent-framework/source/dist/`.

Probarlo

Con la pila en ejecución tal como la ejecuta la guía paso a paso, una solicitud llega al agente. La ruta de abajo es la del propio programa de la guía, un pequeño servidor HTTP en el puerto 8000; tu propio programa decide la suya. La Release publica el agente en 127.0.0.1:8000, así que la solicitud sale de tu máquina:

Terminal window
curl -sS -X POST http://127.0.0.1:8000/ask -H 'Content-Type: application/json' \
-d '{"question": "In one short sentence: what is Azure Container Apps?"}'
{"error": "the agent failed: ChatClientException: (\"<class 'agent_framework_openai._chat_client.OpenAIChatClient'> service failed to complete the prompt: Error code: 401 - Incorrect API key provided: sk-place************-key. [… omitted: where to find an API key, and the same error repeated as the exception it wraps]"}

La clave de la ejecución era un marcador de posición, así que la respuesta es el rechazo de OpenAI a esa clave. En Kubernetes, reenvía un puerto local al Deployment, que no tiene Service, y envíale la misma solicitud desde otra terminal:

Terminal window
kubectl port-forward deploy/supportagent 8000:8000
Terminal window
curl -sS -X POST http://127.0.0.1:8000/ask -H 'Content-Type: application/json' \
-d '{"question": "In one short sentence: what is Azure Container Apps?"}'

La respuesta es la misma.