Date: 2026-09-10

​
Agentes especializados

Nesta lição, vais decidir quando deves delegar trabalho a um agente isolado e como definir uma tarefa que produza evidências úteis.

​
O que é um agente

Um agente especializado é um runtime temporário da Nova, com o seu próprio contexto, prompt de sistema focado, permissões de ferramentas, escolha de modelo e acesso opcional a competências ou MCP. Trata uma tarefa delimitada e devolve um resultado à sessão principal. Por predefinição, continua a usar o espaço de trabalho da sessão principal; o isolamento do sistema de ficheiros exige uma worktree Git gerida pedida explicitamente. Os agentes são úteis quando a separação de contexto melhora a precisão ou a eficiência. Não são motivo para delegares cada pesquisa pequena.

​
Funções integradas

A Kore-CLI inclui perfis para trabalho comum de engenharia:
  • Explore — descoberta rápida do repositório, orientada para leitura.
  • Research — pesquisa só de leitura na web e no repositório, com evidências.
  • Verification — revisão de código, análise de segurança defensiva, reprodução de falhas e validação de testes.
  • Planner — arquitetura de implementação e análise de compromissos.
  • Supernova — implementação geral em várias etapas, com capacidades de leitura, escrita, shell e delegação.
Poderão estar disponíveis agentes adicionais específicos de produtos ou da organização numa sessão. A lista oficial aparece em /agents e na descrição das ferramentas ativas da Nova.

​
Quando a delegação ajuda

Usa um agente quando:
  • O acoplamento arquitetural ou a incerteza tornam valiosa uma exploração isolada.
  • Um revisor só de leitura deve avaliar uma implementação de forma independente.
  • A investigação externa precisa de várias fontes e não deve sobrecarregar o contexto principal.
  • Uma tarefa grande tem fluxos de trabalho verdadeiramente independentes e não sobrepostos.
  • Um fluxo de trabalho personalizado exige uma superfície restrita de ferramentas ou MCP.
Mantém na sessão principal as pesquisas focadas, correções de rotina, edições repetitivas e tarefas cujo contexto já está carregado.

​
Inspecionar e mudar de agente

Usa:
/agents use muda o prompt do agente ativo para interações seguintes. É diferente de criares um agente filho temporário para uma tarefa delegada. O comando também suporta a criação, edição e eliminação interativas de agentes definidos pelo utilizador:

​
Localizações das definições de agentes

As definições Markdown de agentes são descobertas com esta prioridade:
  1. Agentes do projeto em .compass/agents/*.md.
  2. Agentes fornecidos pela opção de CLI --agents.
  3. Agentes do utilizador em ~/.compass/agents/*.md.
  4. Agentes integrados.
Uma definição com prioridade mais elevada pode substituir outro agente com o mesmo nome.

​
Formato do ficheiro de agente

Um agente é um ficheiro Markdown com frontmatter YAML e um corpo de prompt:
O frontmatter suportado inclui name, description, tools, disallowedTools, model, permissionMode, questionRouting, skills, standalone e mcpServers. Ao omitires tools, um agente definido pelo utilizador herda o conjunto de ferramentas da conversa principal. Prefere um conjunto restrito explícito quando a função deve ser só de leitura.

​
Validação de capacidades

Quando a Nova cria um agente filho, o pedido declara todas as capacidades exigidas pela tarefa, como leitura do repositório, utilização da shell, escrita de ficheiros, acesso à web, encaminhamento de perguntas ao utilizador ou delegação adicional. O runtime rejeita um agente cujas ferramentas permitidas não consigam satisfazer as capacidades pedidas. Uma boa tarefa delegada inclui:
  • Um objetivo preciso.
  • Caminhos, excertos, registos ou outro contexto relevante.
  • Alvos de evidência.
  • Capacidades necessárias.
  • Um formato de devolução delimitado.
  • Critérios de aceitação para a sessão principal.

​
Trabalho em segundo plano e paralelo

Um agente filho pode ser executado em segundo plano enquanto a sessão principal continua. A Nova consulta então o processo e recolhe o resultado antes de depender dele. A criação paralela deve limitar-se a fluxos de trabalho independentes. Dois agentes a editar o mesmo subsistema criam custo de coordenação e pressupostos conflitantes. A sessão principal deve indicar quais as conclusões aceites, rejeitadas ou incertas, resolver conflitos e sintetizar uma decisão.

​
Isolamento com worktree

A criação de um agente de raiz pode pedir uma worktree Git gerida. Isto é útil quando a implementação tem de ficar isolada de um repositório que já tem alterações. Os agentes aninhados herdam o mesmo espaço de trabalho em vez de criarem mais worktrees. A criação e a finalização da worktree são sensíveis a aprovação. O isolamento não elimina a necessidade de inspecionar e preservar alterações do utilizador.

​
Recapitulação

Delega apenas trabalho que beneficia de um contexto isolado, revisão independente ou investigação extensa. Define o objetivo, as evidências, as capacidades e o formato de devolução antes de criares um agente.

​
Prática segura

Pede a um agente de verificação, só de leitura, que reveja um diff pequeno. Exige conclusões com caminhos e linhas e confirma na sessão principal que cada conclusão é sustentada pelas evidências. Anterior: NOVA.md e regras do projeto | Seguinte: Competências