# Equipes e Orquestracao Multi-Agente

## O Que Sao Equipes?

Equipes sao o sistema de orquestracao multi-agente do Neotask que decompoe objetivos complexos em funcoes e tarefas. Quando voce cria uma equipe, uma fase de planejamento com IA analisa seu objetivo e constroi a estrutura de equipe ideal automaticamente. Um agente lider entao coordena todos os subagentes e monitora o progresso ate a conclusao.

Equipes estao disponiveis nos **planos Business e Enterprise**, com o numero de agentes sem limite em todos os planos. Este e o nucleo do que torna os planos superiores poderosos: orquestracao paralela massiva coordenada pela plataforma.

## Como Funciona

1. **Descreva seu objetivo.** Forneca uma meta de alto nivel (ex.: "Construir uma landing page para minha startup").
2. **Analise com IA.** O sistema analisa a complexidade, identifica as funcoes necessarias e determina a decomposicao de tarefas.
3. **Atribuicao de agentes.** Agentes sao criados e atribuidos por funcao (ate 5 funcoes por equipe).
4. **Decomposicao de tarefas.** Seu objetivo e dividido em tarefas discretas (ate 8 tarefas por projeto).
5. **Orquestracao.** Um agente orquestrador lider coordena tudo entre todos os subagentes.
6. **Atualizacoes em tempo real.** Atualizacoes de status sao transmitidas conforme cada tarefa e concluida.

## Modos de Orquestracao

| Modo | Descricao |
|------|-----------|
| **Paralelo** | Todos os agentes trabalham simultaneamente em tarefas independentes. Melhor para objetivos onde as tarefas nao tem dependencias entre si. |
| **Sequencial** | Tarefas sao completadas em ordem estrita. A saida de cada tarefa alimenta a proxima. Melhor para objetivos onde cada etapa se baseia na anterior. |
| **Hibrido** | Uma mistura de execucao paralela e sequencial: tarefas se expandem em paralelo e depois mesclam resultados em pontos de sincronizacao. Melhor para objetivos complexos com uma combinacao de trabalho independente e dependente. |

## Criando uma Equipe

Para criar uma equipe no Neotask:

1. **Nome e descricao.** De a sua equipe um nome descritivo e um resumo de seu proposito.
2. **Selecionar agentes.** Escolha quais agentes incluir na equipe.
3. **Escolher modo de orquestracao.** Selecione Paralelo, Sequencial ou Hibrido com base nas necessidades do seu fluxo de trabalho.
4. **Definir o objetivo.** Escreva o prompt ou objetivo que a equipe trabalhara para alcancar.
5. **Iniciar execucao.** Lance a equipe e monitore o progresso em tempo real.

## Tipos de Tarefa e Roteamento de Modelos

O Neotask usa roteamento inteligente por tipo de tarefa para atribuir automaticamente o melhor modelo para cada tarefa:

| Tipo de Tarefa | Modelo | Nivel |
|----------------|--------|-------|
| Arquitetura | Claude Sonnet 4 | Pesado |
| Codificacao complexa | GPT-5.1 | Pesado |
| Codificacao padrao | Claude Haiku 4.5 | Medio |
| Pesquisa | Gemini 3 Flash (contexto 1M) | Medio |
| Documentacao | DeepSeek V3.2 | Medio |
| Extracao de dados | Gemini 2.5 Flash Lite | Leve |
| Tarefas simples | GPT-4.1 Nano | Leve |

Este roteamento acontece automaticamente com base na natureza de cada tarefa decomposta. Voce nao precisa selecionar modelos manualmente.

## Roteamento Consciente de Orcamento

Quando restricoes de orcamento estao ativas, o Neotask rebaixa inteligentemente a selecao de modelo para permanecer dentro dos seus limites:

- Tarefas de **nivel Pesado** sao rebaixadas para modelos de **nivel Medio**.
- Tarefas de **nivel Medio** sao rebaixadas para modelos de **nivel Leve**.

O sistema tambem aplica ordem de fallback de provedores quando um modelo especifico esta indisponivel ou acima do orcamento:

**Cadeia de fallback:** Claude Sonnet 4 -> GPT-5.1 -> Gemini 3 Pro

Isso garante que suas execucoes de equipe sempre sejam completadas, mesmo sob restricoes de orcamento apertadas, mudando graciosamente para modelos mais economicos.

## Isolamento de Sessao

Cada agente em uma equipe opera dentro de sua propria sessao isolada:

- **Sem contaminacao cruzada.** Agentes nao podem acessar ou interferir nos dados de sessao uns dos outros.
- **Compartilhamento de contexto de meta.** O agente lider compartilha o contexto de meta relevante com cada subagente, mas nada alem disso.
- **Relatorio de conclusao.** Relatorios de conclusao em tempo real fluem de cada subagente para o agente lider, mantendo a orquestracao no caminho certo.

Este isolamento garante que os agentes trabalhem de forma independente e confiavel, sem efeitos colaterais de outros agentes na mesma equipe.

## Execucoes de Equipe

O Neotask rastreia cada execucao de equipe como uma execucao. Na visualizacao de execucoes de equipe, voce pode:

- **Ver historico de execucoes.** Veja execucoes passadas com seu status, duracao e resultados.
- **Iniciar e parar execucoes.** Lance novas execucoes ou interrompa execucoes em andamento.
- **Monitorar progresso individual do agente.** Acompanhe no que cada agente esta trabalhando e quao avancado esta.
- **Cascata de tarefas.** A conclusao de uma tarefa aciona automaticamente quaisquer tarefas dependentes, mantendo o fluxo de trabalho em movimento sem intervencao manual.

## Escalando com Enterprise

Planos Enterprise sao projetados para equipes que precisam executar fluxos de trabalho multi-agente complexos em escala:

- **Agentes simultaneos sem limite.** Implante centenas de agentes trabalhando em paralelo em diferentes equipes e objetivos.
- **Precos baseados em uso.** Voce paga a assinatura da plataforma pela infraestrutura de orquestracao, e as taxas de uso sao cobradas com base no consumo real de tokens em todos os seus agentes. Isso significa que voce paga apenas pela computacao que seus agentes realmente usam.
- **Orcamentos por agente.** Defina limites de gasto individuais em cada agente para manter o controle de custos mesmo em escala.
- **Roteamento inteligente.** A selecao automatica de modelo garante que cada tarefa use o modelo mais economico capaz de trata-la.