# Instrucciones para el agente: CrewAI: coordina agentes y tareas en flujos de Python

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/crewAIInc/crewAI (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/crewai

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: instala la CLI con uv

Comprueba que tienes uv y Python ≥3.10 y <3.14. Después de `uv tool update-shell`, abre una terminal nueva antes de usar `crewai`.

```shell
uv tool install crewai
uv tool update-shell
uv tool list
```

### Paso 2: genera un equipo

La sintaxis del README usa un nombre de proyecto como parámetro:

```shell
crewai create crew <project_name>
```

Sustituye el parámetro por tu nombre. Configura los agentes JSONC y `crew.jsonc` que se generan, y el proveedor indicado por esa plantilla. Antes de ejecutar, configura el acceso al proveedor que usa la plantilla; si conserva `SerperDevTool`, configura también `SERPER_API_KEY`. Desde la carpeta creada ejecuta, en este orden:

```shell
crewai install
crewai run
```

El [ejemplo secuencial oficial](https://github.com/crewAIInc/crewAI#2-setting-up-your-crew) usa `latest-ai-development`, carpeta `latest_ai_development`, y escribe `output/report.md`. Si eliges ese ejemplo, copia sus dos agentes y `crew.jsonc` completos y comprueba ese informe.

## Comprobación

El equipo debe terminar sus tareas y producir el entregable esperado. Inspecciona qué contexto recibe el segundo agente y qué herramientas se ejecutaron.

## Si algo falla

Si esperabas archivos YAML y encuentras JSONC, estás usando la plantilla actual. La opción documentada `--classic` genera la estructura anterior; elige una y sigue sus instrucciones.
