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:

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 para detalhes.