Agents - Neotask by Neotask Documentation | Neotask

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

    View full documentation