CrewAI Inicio rápido: crea tu primer Crew de investigación en 10 minutos

2 min read

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-notes

Esto crea la estructura base, incluyendo:

  • src/latest_ai_notes/config/agents.yaml
  • src/latest_ai_notes/config/tasks.yaml
  • src/latest_ai_notes/crew.py
  • src/latest_ai_notes/main.py

Paso 2: Instalar dependencias

crewai install

Este 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

💡 context es clave: indica que la segunda tarea debe consumir el resultado de la primera.

Paso 5: Ejecutar el crew

crewai run

Si 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