# Agentes

## O Que Sao Agentes?

Agentes sao assistentes de IA isolados que raciocinam sobre problemas, executam tarefas e se comunicam atraves de multiplas plataformas. Cada agente tem seu proprio workspace, historico de sessao, configuracao de modelo e vinculacoes de canal.

## Isolamento de Agentes

Cada agente recebe:

- **Workspace** -- Um diretorio dedicado para arquivos, notas e dados especificos do agente
- **Sessoes** -- Historico de conversas e transcricoes independentes
- **Configuracao** -- Selecao de modelo, permissoes de ferramentas, limites de gasto
- **Identidade** -- Uma persona unica definida no arquivo `AGENTS.md` do agente
- **Perfis de Auth** -- Configuracoes de API key e autenticacao por agente

## Personas de Agentes

O workspace de cada agente contem um arquivo `AGENTS.md` que define personalidade, instrucoes e diretrizes comportamentais. Este prompt de sistema persistente molda como o agente responde -- tom, especialidade de dominio, formatacao, uso de ferramentas e politicas de seguranca.

## Roteamento Multi-Agente

Ao executar multiplos agentes, mensagens de entrada sao roteadas automaticamente com base em **vinculacoes**:

- **Vinculacao de canal** -- Roteia todas as mensagens de uma plataforma (ex.: todo Telegram → agente `pessoal`)
- **Vinculacao de servidor/workspace** -- Roteia um servidor Discord ou workspace Slack especifico para um agente dedicado
- **Vinculacao de tipo de chat** -- Roteia mensagens privadas para um agente e mensagens de grupo para outro
- **Vinculacao de contato/par** -- Roteia mensagens de contatos especificos para agentes especificos

Vinculacoes sao avaliadas em ordem de prioridade. A primeira correspondencia vence. Mensagens sem correspondencia vao para o agente padrao.

## Sub-Agentes e Delegacao

Agentes podem criar sub-agentes para tarefas especializadas:

- **Delegacao de tarefas** -- Decompoe tarefas complexas e delega partes a sub-agentes especializados
- **Execucao isolada** -- Sub-agentes rodam em seu proprio contexto de sessao
- **Conversas ping-pong** -- Agentes podem ter trocas de ida e volta (ate 5 turnos) para colaborar
- **Anuncio de resultados** -- Resultados de sub-agentes podem ser postados de volta no canal original

## Equipes e Orquestracao

Equipes multi-agente permitem workflows coordenados:

- **Execucao paralela** -- Execute multiplos agentes simultaneamente em diferentes aspectos de uma tarefa
- **Pipelines sequenciais** -- Encadeie agentes onde cada um constroi sobre a saida anterior
- **Modo hibrido** -- Combine execucao paralela e sequencial
- **Rastreamento de tarefas** -- Monitore o status do trabalho de cada agente (na fila, executando, concluido, erro, cancelado)

## Perfis de Ferramentas

Controle o que cada agente pode fazer:

| Perfil | Ferramentas Disponiveis |
|--------|------------------------|
| **minimal** | Apenas status da sessao |
| **coding** | I/O de arquivos, execucao, sessoes, memoria, imagens |
| **messaging** | Envio de mensagens, historico de sessao |
| **full** | Todas as ferramentas (padrao) |

Listas personalizadas de permissao/bloqueio podem ser definidas por agente e por provedor de modelo.

## Modo Seguro

O Modo Seguro fornece um sandbox de execucao:

- **Toggle principal** -- Habilite ou desabilite globalmente
- **Controles por agente** -- Desabilite para agentes confiaveis, mantenha ativado para outros
- **Aprovacao de execucao** -- Operacoes sensiveis requerem aprovacao explicita do usuario
- **Sincronizacao de politicas** -- Configuracoes sincronizadas entre todos os clientes conectados em tempo real

## Memoria do Agente

Cada agente tem acesso a um sistema de memoria:

- **MEMORY.md** -- Notas persistentes e informacoes importantes entre sessoes
- **Arquivos de memoria** -- Conhecimento estruturado adicional em `memory/`
- **Busca vetorial** -- Busque na memoria usando consultas em linguagem natural

Veja [Sessoes e Memoria](sessions-memory.md) para detalhes.