> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orkeia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Uso de Agentes Singulares vs Squad de Agentes

> ¿Cuándo debo usar múltiples agentes y agentes singulares en orkeia AI?

# Agentes Singulares vs Squad de Agentes

En Orkeia, los **agentes de IA** pueden operar de dos formas principales:

1. **Agente Singular**
   * Un agente único que ejecuta todas las etapas de la tarea.
   * Centraliza el razonamiento y mantiene la consistencia en el flujo.
2. **Squad de Agentes**
   * Conjunto de agentes especializados que trabajan de forma colaborativa.
   * Cada agente se enfoca en una parte de la tarea, entregando resultados que los demás pueden consumir.

***

## ¿Cuándo usar un Agente Singular?

El uso de un solo agente se recomienda en escenarios en los que:

* La tarea es **simple** y puede resolverse en una o pocas etapas.
* Es importante **ahorrar tokens** y reducir el costo operacional.
* No hay necesidad de roles especializados (por ej.: no necesita un "investigador", "analista" y "redactor" separados).
* El flujo debe ser rápido, con **latencia mínima**.

**Ejemplos prácticos**:

* Responder preguntas directas de clientes en un chat.
* Generar resúmenes rápidos de textos cortos.
* Ejecutar comandos directos, como "convertir este archivo a PDF".

***

## ¿Cuándo usar un Squad de Agentes?

El squad es más indicado cuando:

* La tarea exige **división de roles** (investigación, análisis, decisión, escritura, validación).
* Hay necesidad de **especialización**, en la que cada agente tiene instrucciones y conocimientos distintos.
* El problema es **complejo o abierto**, requiriendo múltiples etapas para llegar a una respuesta robusta.
* El flujo necesita **verificación cruzada**, aumentando la consistencia y calidad.
* Se desea **escalabilidad**: diferentes agentes pueden ejecutarse en paralelo en subtareas.

**Ejemplos prácticos**:

* Creación de informes extensos con recolección de datos, análisis estadístico y escritura final.
* Atención al cliente con agentes que asumen roles diferentes (triage, resolución, seguimiento).
* Proyectos de investigación con agentes especializados en buscar fuentes, validar informaciones y generar síntesis.
* Workflows largos que necesitan **orquestración de etapas**.

***

## Comparativo

| Criterio            | Agente Singular                       | Squad de Agentes                                     |
| ------------------- | ------------------------------------- | ---------------------------------------------------- |
| **Complejidad**     | Baja, tareas directas                 | Alta, tareas abiertas y multifásicas                 |
| **Velocidad**       | Más rápido, baja latencia             | Puede ser más lento, debido a la coordinación        |
| **Costo (tokens)**  | Más económico                         | Mayor costo, múltiples agentes procesando            |
| **Consistencia**    | Flujo lineal, sin múltiples visiones  | Posibilidad de divergencia, pero con chequeo cruzado |
| **Especialización** | Un único perfil                       | Cada agente puede ser especializado                  |
| **Escalabilidad**   | Limitada al razonamiento de un modelo | Escalable con división de subtareas paralelas        |
| **Ejemplo de uso**  | Responder preguntas simples de FAQ    | Producir informes analíticos detallados              |

***

## Buenas prácticas

* **Evalúe la complejidad antes de decidir**: si la tarea puede resolverse por un solo agente, prefiera la simplicidad.
* **Use squads solo cuando sea necesario**: el overhead de coordinación y costo solo compensan en escenarios complejos.
* **Defina roles claros**: cada agente en el squad debe tener responsabilidades bien delimitadas, evitando redundancia.
* **Monitoree costos**: distribuya el uso de tokens entre agentes de forma controlada.
* **Mantenga registros de interacciones**: para squads, el histórico ayuda a depurar fallas de coordinación.

***

## Resumen final

* **Agente Singular** es ideal para **tareas rápidas, directas y económicas**.
* **Squad de Agentes** es la elección correcta para **problemas complejos, que requieren colaboración, especialización y orquestación**.

En Orkeia, ambos formatos son soportados, permitiendo flexibilidad entre **simplicidad** y **colaboración avanzada**.