Subagentes, tarefas em segundo plano e loops
O agente pode dividir uma solicitação grande em partes, executá-las em paralelo e manter o trabalho em andamento em segundo plano enquanto o usuário continua. Tudo o que está descrito aqui é executado dentro da sua sessão de terminal e é interrompido quando a sessão termina.
Subagentes
Seção intitulada “Subagentes”Um subagente é um agente separado com seu próprio contexto, instruções e lista de ferramentas. O Eve inicia subagentes quando uma tarefa se beneficia do paralelismo, por exemplo, para pesquisar vários módulos de uma grande base de código, executar benchmarks ou executar refatorações independentes simultaneamente. Apenas a resposta final do subagente retorna à conversa principal, mantendo a janela de contexto principal compacta.
- Os subagentes são executados em paralelo, até 32 por vez, por padrão. O Eve pode iniciar lotes de tarefas paralelas em um único turno para obter o máximo rendimento.
- Um subagente pode iniciar seus próprios subagentes, em até dois níveis de profundidade.
- Os subagentes nunca recebem mais permissões do que a sua sessão. Suas solicitações de permissão aparecem no seu terminal, identificadas com o nome do subagente, uma de cada vez.
- Fluxos de trabalho de várias horas e suspensões complexas de turnos são suportados até 2.000 ciclos de turnos.
- Cada turno de subagente é considerado um turno normal de agente e conta para os seus limites.
Agentes integrados
Seção intitulada “Agentes integrados”| Agente | Ferramentas | Use |
|---|---|---|
general | Todas as CHAMPREPferramentas locais e disponíveis na sessão | Partes autônomas de uma tarefa maior. |
explore | Ferramentas locais somente leitura | Pesquisa rápida na base de código que retorna conclusões. |
plan | Somente leitura | Um plano de implementação passo a passo. |
review | Somente leitura, mais somente leitura git | Revisão de um diff, ramificação ou solicitação de mesclagem. |
platform | CHAMPREP Apenas ferramentas; sem arquivos ou comandos locais | Work em todos os seus serviçosCHAMPREP. |
Execute um agente por conta própria
Seção intitulada “Execute um agente por conta própria”/agents/agents run explore where is the invoice total calculated?@explore where is the invoice total calculated?@agent-name prompt inicia o agente como uma tarefa em segundo plano e relata sua resposta quando ele for concluído. Crie seus próprios agentes com /agents create NAME; consulte Agentes personalizados.
Lista de tarefas
Seção intitulada “Lista de tarefas”Para solicitações em várias etapas, o Eve mantém uma lista de tarefas em tempo real com itens pendentes, em andamento e concluídos. Pressione Ctrl+T para exibi-lo ou ocultá-lo, ou executar /todos.
Shells e processos em segundo plano
Seção intitulada “Shells e processos em segundo plano”O Eve pode iniciar comandos de longa duração, como um servidor de desenvolvimento, um monitor de arquivos, um compilador ou conjuntos de testes extensos, em um shell em segundo plano e continuar trabalhando. Ele monitora as saídas de forma assíncrona e pode aguardar por padrões como
server listening ou FAIL antes de continuar.
- É possível executar até 64 shells em segundo plano simultaneamente.
- A atividade em segundo plano é monitorada em tempo real na linha de status (por exemplo,
🐚 2 shells) e ative o resumo de status (⚡ 2 shell(s), 3 agent(s) active). - Utilize
/shellsou/procspara abrir o inspetor de shells dedicado, exibindo PIDs, linhas de comando, códigos de saída e saídas em tempo real.
Execute um prompt repetidamente na sessão atual:
/loop 5m check whether the deploy finished and summarise any errors/loop --max 10 30m run the test suite and fix new failures/loop keep improving test coverage for src/billing/loop stop- Com um intervalo entre
30se24h, o prompt é executado de acordo com essa programação. - Sem um intervalo definido, o ciclo ocorre no ritmo do próprio agente: o agente decide quando será executado novamente, entre um minuto e uma hora depois.
- Um loop é interrompido após 50 execuções por padrão; altere isso com
--max N. Ele também interrompe com/loop stop [id]ou ao encerrar a sessão.
Cada execução é um turno normal: ela utiliza seus limites e solicita permissão como qualquer outro turno.
/tasks e /shells
Seção intitulada “/tasks e /shells”/tasks lista tudo o que está em execução em segundo plano — subagentes, shells em segundo plano e loops — com o tempo decorrido.
/shells (ou /procs) concentra-se especificamente em processos de shell ativos e concluídos.
/tasks/tasks tail ID/tasks attach ID/tasks stop ID/tasks stop all
/shells/procsA linha de status mostra quantas tarefas e shells estão ativos. /exit avisa-o antes de sair enquanto processos ou tarefas em segundo plano ainda estiverem em execução.
Tarefas em segundo plano, subagentes e o número de subagentes paralelos são recursos do plano. Consulte Planos e limites.
Árvores de trabalho
Seção intitulada “Árvores de trabalho”Uma árvore de trabalho do Git fornece à sessão seu próprio checkout, de modo que sessões paralelas ou subagentes nunca editam os mesmos arquivos.
champrep ai --worktreechamprep ai --worktree fix-rounding/worktree fix-rounding/worktree exitA árvore de trabalho é criada em .champrep/worktrees/NAME em um novo ramo
ai/NAME. Ao sair, uma árvore de trabalho sem alterações é removida; aquela com alterações é mantida e relatada para que você possa confirmá-las ou descartá-las. Um agente personalizado também pode definir isolation: worktree para trabalhar sempre em sua própria árvore de trabalho.
Avaliações
Seção intitulada “Avaliações”/review/review main/review !42/security-review- Sem nenhum argumento,
/reviewrevisa suas alterações não confirmadas e preparadas. - Com um branch ou ref, ele compara esse branch com o atual
HEAD. - Com
!NUMBERou uma URL de solicitação de mesclagem, ele analisa uma solicitação de mesclagem de códigoCHAMPREP por meio de suas ferramentasCHAMPREP.
/security-review procura por vulnerabilidades exploráveis, como injeção, lacunas de autorização, segredos comprometidos e traversal de caminho. Ambos os comandos executam o agente somente leitura review agente e relata os resultados por gravidade, com indicação do arquivo e da linha.