CrewAI Inicio rápido: crea tu primer Crew de investigación en 10 minutos
El objetivo de este artículo es simple: si sigues los pasos, generarás tu primer informe de investigación con IA.
Tomamos el camino más corto y evitamos trucos innecesarios.
Paso 1: Crear un proyecto
crewai create crew latest-ai-notes
cd latest-ai-notesEsto crea la estructura base, incluyendo:
src/latest_ai_notes/config/agents.yamlsrc/latest_ai_notes/config/tasks.yamlsrc/latest_ai_notes/crew.pysrc/latest_ai_notes/main.py
Paso 2: Instalar dependencias
crewai installEste comando lee la configuración del proyecto, crea un entorno virtual e instala paquetes automáticamente.
No necesitas encadenar manualmente una lista larga de pip install.
Paso 3: Configurar agentes
Edita agents.yaml:
researcher:
role: >
{topic} Researcher
goal: >
Find useful and current information about {topic}
backstory: >
You are good at collecting reliable information and summarizing key points.
reporter:
role: >
{topic} Reporter
goal: >
Convert research notes into a readable markdown report
backstory: >
You explain technical topics with simple language and clear structure.Paso 4: Configurar tareas
Edita tasks.yaml:
research_task:
description: >
Research {topic}. Focus on trends, tools, and practical examples in 2026.
expected_output: >
10 bullet points with short explanations.
agent: researcher
report_task:
description: >
Expand the research notes into a complete markdown article for beginners.
expected_output: >
A beginner-friendly markdown report with sections and conclusion.
agent: reporter
context:
- research_task
output_file: output/report.md💡
contextes clave: indica que la segunda tarea debe consumir el resultado de la primera.
Paso 5: Ejecutar el crew
crewai runSi todo sale bien, verás la salida en output/report.md.
Un pequeño retraso en la primera ejecución es normal. Las llamadas al modelo son como un gato despertando: tardan un poco en reaccionar.
Problemas comunes
| Problema | Posible causa | Solución |
|---|---|---|
API key missing |
Variable de entorno no definida | Añade tu API key en .env |
Module not found |
Dependencias incompletas | Ejecuta crewai install otra vez |
| Salida inestable | Descripción de tarea demasiado vaga | Haz más estrictos los requisitos en expected_output |
Siguiente paso
Ya completaste tu primer flujo.
Ahora toca la habilidad más importante: dividir roles y tareas.
👉 Agents and Tasks