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

> Quando devo usar multiplos agentes e agentes singulares no orkeia AI?

# Agentes Singulares vs Squad de Agentes

No Orkeia, os **agentes de IA** podem operar de duas formas principais:

1. **Agente Singular**
   * Um agente único que executa todas as etapas da tarefa.
   * Centraliza o raciocínio e mantém consistência no fluxo.
2. **Squad de Agentes**
   * Conjunto de agentes especializados que trabalham de forma colaborativa.
   * Cada agente foca em uma parte da tarefa, entregando resultados que os outros podem consumir.

***

## Quando usar um Agente Singular?

O uso de um único agente é recomendado em cenários em que:

* A tarefa é **simples** e pode ser resolvida em uma ou poucas etapas.
* É importante **economizar tokens** e reduzir custo operacional.
* Não há necessidade de papéis especializados (ex.: não precisa de um “pesquisador”, “analista” e “redator” separados).
* O fluxo deve ser rápido, com **latência mínima**.

**Exemplos práticos**:

* Responder perguntas diretas de clientes em um chat.
* Gerar resumos rápidos de textos curtos.
* Executar comandos diretos, como “converter este arquivo para PDF”.

***

## Quando usar um Squad de Agentes?

O squad é mais indicado quando:

* A tarefa exige **divisão de papéis** (pesquisa, análise, decisão, escrita, validação).
* Há necessidade de **especialização**, em que cada agente tem instruções e conhecimento distintos.
* O problema é **complexo ou aberto**, exigindo múltiplas etapas para chegar a uma resposta robusta.
* O fluxo precisa de **verificação cruzada**, aumentando consistência e qualidade.
* Deseja-se **escalabilidade**: diferentes agentes podem rodar em paralelo em subtarefas.

**Exemplos práticos**:

* Criação de relatórios extensos com coleta de dados, análise estatística e escrita final.
* Atendimento ao cliente com agentes que assumem papéis diferentes (triagem, resolução, acompanhamento).
* Projetos de pesquisa com agentes especializados em buscar fontes, validar informações e gerar síntese.
* Workflows longos que precisam de **orquestração de etapas**.

***

## Comparativo

| Critério           | Agente Singular                     | Squad de Agentes                                       |
| ------------------ | ----------------------------------- | ------------------------------------------------------ |
| **Complexidade**   | Baixa, tarefas diretas              | Alta, tarefas abertas e multifásicas                   |
| **Velocidade**     | Mais rápido, baixa latência         | Pode ser mais lento, devido à coordenação              |
| **Custo (tokens)** | Mais econômico                      | Maior custo, múltiplos agentes processando             |
| **Consistência**   | Fluxo linear, sem múltiplas visões  | Possibilidade de divergência, mas com checagem cruzada |
| **Especialização** | Um único perfil                     | Cada agente pode ser especializado                     |
| **Escalabilidade** | Limitada ao raciocínio de um modelo | Escalável com divisão de subtarefas paralelas          |
| **Exemplo de uso** | Responder perguntas simples de FAQ  | Produzir relatórios analíticos detalhados              |

***

## Boas práticas

* **Avalie a complexidade antes de decidir**: se a tarefa pode ser resolvida por um único agente, prefira a simplicidade.
* **Use squads apenas quando necessário**: o overhead de coordenação e custo só compensa em cenários complexos.
* **Defina papéis claros**: cada agente no squad deve ter responsabilidade bem delimitada, evitando redundância.
* **Monitore custos**: distribua o uso de tokens entre agentes de forma controlada.
* **Mantenha logs de interações**: para squads, o histórico ajuda a depurar falhas de coordenação.

***

## Resumo final

* **Agente Singular** é ideal para **tarefas rápidas, diretas e econômicas**.
* **Squad de Agentes** é a escolha certa para **problemas complexos, que exigem colaboração, especialização e orquestração**.

No Orkeia, ambos os formatos são suportados, permitindo flexibilidade entre **simplicidade** e **colaboração avançada**.