Como funciona a Nova
Nesta lição, vais perceber como a Nova transforma um pedido num conjunto controlado de ações, usando contexto e resultados de ferramentas para decidir o passo seguinte.O ciclo do agente
A Nova combina um modelo de linguagem com um ambiente de execução de ferramentas controlado. O modelo não manipula diretamente o sistema operativo. Decide que ferramenta registada deve chamar, fornece argumentos estruturados, recebe o resultado e continua a raciocinar a partir dessa evidência. Uma interação típica segue esta sequência:- A Nova recebe o teu pedido, bem como contexto de sistema, organização, projeto e sessão.
- Decide se o pedido requer explicação, análise do repositório, ação direta, planeamento ou delegação.
- Chama ferramentas focadas, como pesquisa de ficheiros e código, leitura e edição de ficheiros, análise de Git ou execução de comandos.
- O ambiente de execução valida o pedido e aplica a política de aprovação antes de trabalho sensível.
- O resultado da ferramenta regressa ao modelo.
- A Nova repete o ciclo até cumprir os critérios de sucesso observáveis ou encontrar um bloqueio real.
Construção do contexto
O contexto efetivo do modelo é reunido a partir de várias camadas:- As instruções internas de comportamento e segurança da Nova.
- Regras da organização e políticas de divulgação de dados, quando configuradas.
- Instruções específicas do agente.
- Ficheiros
NOVA.mdhierárquicos e módulos.compass/rules/*.md. - Memória guardada relevante e continuidade da sessão.
- A conversa atual.
- Definições de ferramentas e resultados recentes das ferramentas.
- Conteúdo explícito de ficheiros, imagens ou documentos fornecido por ti.
Limites das ferramentas
As ferramentas expõem operações estritamente definidas. As categorias mais importantes incluem:- Leitura do repositório — encontrar ficheiros, pesquisar código, analisar dependências e ler secções específicas.
- Escrita no repositório — criar, editar, mover ou eliminar ficheiros.
- Execução — executar comandos, testes e builds de curta duração; iniciar processos de longa duração apenas através de execução em segundo plano.
- Git — analisar o estado e o histórico, preparar ficheiros, fazer commit e enviar alterações.
- Fluxo de trabalho — criar planos, fazer perguntas estruturadas e delegar a agentes especializados.
- Integrações externas — chamar sistemas disponibilizados por MCP, como serviços de conhecimento, e-mail, calendário ou documentos.
Aprovação e autonomia
A Nova separa o raciocínio da permissão. Uma operação pode ser tecnicamente adequada e ainda assim exigir aprovação humana. O gestor de aprovações classifica operações como criação, modificação e eliminação de ficheiros, execução de shell, commit e push de Git, execução de bases de dados e ações em worktrees. As opçõesmanual e auto determinam quando operações elegíveis são aprovadas automaticamente, enquanto as ações de maior impacto continuam protegidas pela política.
Nas sessões interativas, usa /approve para definir manual ou auto. A política de aprovação é independente da estratégia de execução: a Nova pode executar trabalho claro diretamente ou entrar no fluxo de planeamento sujeito a aprovação para implementações complexas.
Ambiente de planeamento
Para trabalho de implementação complexo, a Nova pode criar um plano estruturado antes de editar. O modo de plano não é apenas uma lista: o ambiente de execução regista o estado do plano, pede aprovação, acompanha a conclusão das tarefas e permite retomar a primeira tarefa incompleta. Para trabalho claro e de baixo risco, a execução direta é mais rápida. A escolha depende da incerteza, do acoplamento arquitetural, do risco de migração e da reversibilidade — não do tamanho aparente do pedido.Agentes especializados
A Nova pode iniciar agentes isolados para trabalho delimitado. Cada agente tem um perfil de capacidades declarado, como exploração de repositórios, investigação na Web, verificação, planeamento ou implementação. A sessão principal fornece o objetivo e o resultado esperado, depois aceita, rejeita ou qualifica as conclusões devolvidas antes de as usar. O isolamento evita que cada pormenor exploratório sobrecarregue a conversa principal e permite executar em paralelo fluxos de trabalho realmente independentes.Fornecedores e modelos
A Nova não está ligada a um único ponto de acesso de modelos. A implementação Kore-CLI suporta modelos geridos pela Compass, fornecedores compatíveis com Anthropic, fluxos OpenAI chat e responses, OpenAI OAuth quando disponível e pontos de acesso personalizados registados. A escolha do fornecedor altera o acesso ao modelo, mas o ambiente de ferramentas e o fluxo de projeto da Nova continuam a ser a camada de execução envolvente.Sessões e observabilidade
A Nova mantém informação de sessão em armazenamento gerido pela Compass. Pode listar ou retomar sessões de projeto arquivadas, compactar conversas extensas, apresentar a utilização de contexto e tokens, emitir eventos de sistema estruturados e disponibilizar um painel local. Estas funcionalidades tornam o trabalho de longa duração inspecionável, em vez de efémero.Recapitulação
- A Nova usa um ciclo de pedido, decisão, ferramenta, resultado e verificação.
- O contexto é composto por várias camadas e é recuperado de forma direcionada.
- As fronteiras das ferramentas e as aprovações limitam as ações que podem afetar o teu projeto.