Pular para o conteúdo principal

Como o agente funciona

O agente NeurAI segue um ciclo de raciocinar → planejar → executar → relatar. Entender esse ciclo ajuda a formular pedidos mais eficientes e interpretar o que o agente está fazendo.

Ciclo de execução​

1. Recebe sua mensagem​

Ao enviar uma mensagem, o agente recebe:

  • Sua mensagem atual
  • O histórico da conversa
  • O contexto do projeto (se configurado)
  • Variáveis da sessão (se houver)

2. Raciocina​

Para tarefas complexas, o agente usa a ferramenta think — um scratchpad de raciocínio interno visível no chat. Ele analisa o problema, considera abordagens e planeja a sequência de ações.

💭 Pensando:
O usuário quer criar uma API REST com autenticação JWT.
Vou precisar: 1) instalar express e jsonwebtoken, 2) criar estrutura de pastas,
3) implementar middleware de auth, 4) criar rotas protegidas.
Começando pela instalação das dependências...

3. Planeja (tarefas complexas)​

Para trabalhos com 3+ etapas, o agente cria um plano de tarefas visível no chat:

📋 Plano de execução:
✅ Instalar dependências
⏳ Criar estrutura de pastas
⬜ Implementar autenticação
⬜ Criar rotas da API
⬜ Escrever testes

O plano é atualizado em tempo real conforme o agente avança.

4. Executa ferramentas​

O agente executa as ferramentas necessárias. Cada ferramenta aparece como um card no chat:

  • Nome da ferramenta e argumentos usados
  • Resultado (expansível)
  • Status: sucesso ✅ ou erro ❌

5. Pede confirmação (se necessário)​

Dependendo do modo de permissão, o agente pode pausar e pedir sua aprovação antes de executar ações destrutivas.

6. Entrega a resposta​

Após executar tudo, o agente entrega o resultado em Markdown — com código formatado, tabelas, links e instruções de próximos passos.

Paralelismo​

Para tarefas independentes (ex: criar múltiplos arquivos), o agente executa em paralelo usando o sistema de steps, tornando a execução mais rápida.

Memória da sessão​

O agente lembra de tudo que aconteceu na sessão:

  • Arquivos que já leu (não relê sem necessidade)
  • Variáveis salvas com set_variable
  • Processos iniciados em background
  • Decisões tomadas ao longo da conversa

Isso garante eficiência — o agente não faz perguntas repetidas nem reli arquivos desnecessariamente.

Saiba mais

O agente também detecta automaticamente qual linguagem e ferramentas seu projeto usa (Node.js, Python, Go, Java, etc.) e adapta os comandos ao seu ambiente.