Pular para o conteúdo
Documentation

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.

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.

AgenteFerramentasUse
generalTodas as CHAMPREPferramentas locais e disponíveis na sessãoPartes autônomas de uma tarefa maior.
exploreFerramentas locais somente leituraPesquisa rápida na base de código que retorna conclusões.
planSomente leituraUm plano de implementação passo a passo.
reviewSomente leitura, mais somente leitura gitRevisão de um diff, ramificação ou solicitação de mesclagem.
platformCHAMPREP Apenas ferramentas; sem arquivos ou comandos locaisWork em todos os seus serviçosCHAMPREP.

/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.

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.

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 /shells ou /procs para 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 30s e 24h, 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 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
/procs

A 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.

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.

Terminal window
champrep ai --worktree
champrep ai --worktree fix-rounding
/worktree fix-rounding
/worktree exit

A á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.

/review
/review main
/review !42
/security-review
  • Sem nenhum argumento, /review revisa suas alterações não confirmadas e preparadas.
  • Com um branch ou ref, ele compara esse branch com o atual HEAD.
  • Com !NUMBER ou 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.