Importar un proyecto CrewAI — una crew de dos agentes
Las declaraciones de agentes y tareas de un proyecto CrewAI con la estructura clásica — dos agentes sobre un mismo modelo de OpenAI, una tarea cada uno — convertidas en borradores de archivos Aggrega por aggrega import, con la imagen en la que se ejecuta el programa de la crew indicada una sola vez en un archivo de respuestas, y compiladas para Docker Compose.
Importar un proyecto CrewAI 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 la crew en ejecución. Esta carpeta contiene cada etapa de ese recorrido:
| carpeta o archivo | qué contiene |
|---|---|
source/ | las declaraciones del proyecto, src/support_brief/config/agents.yaml y tasks.yaml, el .aggrega-config.yaml que convierte la carpeta en un espacio de trabajo, y src/support_brief/import-answers.yaml, los valores que ninguna declaración contiene: la imagen de cada agente 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 src/support_brief --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 |
Las declaraciones están escritas para este ejemplo. El programa de la crew no forma parte de él: la importación nunca lee ninguno, y la Release indica la imagen en la que se ejecuta.
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-crewaiDespués imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:
cd import-crewaiCompilación
La importación genera los borradores de los archivos Aggrega junto al proyecto, en source/. Contrasta el proyecto con el 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 informe 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 contra ellas. La importación lee las imágenes de src/support_brief/import-answers.yaml y luego descarga aquello de lo que depende la Release en borrador, de modo que la compilación sigue de inmediato:
cd sourceaggrega import src/support_brief --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 todavía no contiene una carpeta `import-crewai`, llama una vez a la herramienta `scaffold` con `example` establecido en `import-crewai` y sin `dir`: escribe el ejemplo en una nueva carpeta `import-crewai`, cuya carpeta `source` contiene lo que importa este ejemplo. Luego llama a la herramienta `import` con `workspace_root` establecido en `import-crewai/source`, `source` establecido en `src/support_brief` y `target` establecido en `compose`: lee las respuestas que necesita de `import-answers.yaml` dentro de la carpeta `src/support_brief`, escribe sus borradores en `import-crewai/source` y descarga lo que estos necesitan. Luego llama a la herramienta `validate` con `workspace_root` establecido en `import-crewai/source` y `release` establecido en `release.yaml`, y a la herramienta `build` con `workspace_root` establecido en `import-crewai/source`, `release` establecido en `release.yaml` y `write` establecido en true. Dime qué archivos escribió la compilación; están en `import-crewai/source/dist/`.Probarlo
Con el stack en ejecución tal como lo ejecuta la guía, una solicitud llega a la crew. 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 investigador en 127.0.0.1:8000 y el redactor en 127.0.0.1:8001, así que la solicitud va al investigador desde tu máquina:
curl -sS -X POST http://127.0.0.1:8000/kickoff -H 'Content-Type: application/json' \ -d '{"question": "Which support plan covers a weekend outage, and what does it cost?"}'{ "error": "the crew failed: AuthenticationError: Error code: 401 - {'error': {'message': 'Incorrect API key provided: sk-place************-key. [… omitted: where to find an API key, and the error's type and code]"}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/researcher 8000:8000curl -sS -X POST http://127.0.0.1:8000/kickoff -H 'Content-Type: application/json' \ -d '{"question": "Which support plan covers a weekend outage, and what does it cost?"}'La respuesta es la misma.