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 archivo | qué 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:
aggrega scaffold --example import-agent-frameworkDespués imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:
cd import-agent-frameworkCompilació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:
cd sourceaggrega import support-agent.yaml --target composeaggrega build --release release.yamlLa 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:
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:
kubectl port-forward deploy/supportagent 8000:8000curl -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.