Pular para o conteúdo

Agentes e orquestração

No Context Code não existe um único agente generalista: para objetivos grandes, um orquestrador propõe um plano, você o distribui entre agentes especialistas e eles trabalham em paralelo enquanto você supervisiona.

Durante um chat normal, o agente principal pode delegar subtarefas a especialistas (por exemplo, um que investiga o código enquanto outro prepara as mudanças). No chat, cada delegação aparece como um cartão próprio:

  • Tudo visível: você pode abrir a transcrição de cada especialista e ver exatamente o que ele fez.
  • Cancelável: cada especialista pode ser interrompido sem derrubar a conversa principal.
  • Você pode continuar falando com o agente principal enquanto os especialistas trabalham: perguntas, correções de rumo, novas instruções.
  • Retomada: um especialista pode ser retomado depois com a memória intacta, sem repetir o trabalho já feito.

As delegações somente de leitura (investigar, buscar, ler) não exigem aprovação; as que escrevem passam pelos modos de aprovação do chat.

Os especialistas aparecem como cartões no chat: transcrição própria, status e botão de parar.

Um chat que delegou muito acumula subagentes na barra lateral. Para deixá-lo limpo:

  • Um avulso: passe o mouse por cima e clique no X, ou clique direito → Excluir subagente.
  • Os que já terminaram: clique direito sobre o chat pai → Excluir subagentes concluídos (N).
  • Todos: clique direito sobre o chat pai → Excluir todos os subagentes (N).

Sempre pede confirmação, e diz exatamente o que vai levar junto: «“X” e todo o seu histórico de conversa serão excluídos. O chat e os demais subagentes não são tocados. Não é possível desfazer.» Ao excluir em lote, os que continuam em execução são conservados e o app avisa.

Para objetivos de vários passos, o fluxo é plan-first:

  1. Descreva o objetivo completo no chat do orquestrador.
  2. O orquestrador propõe um plano dividido em tarefas e o apresenta antes de mexer em nada.
  3. Revise (você pode pedir mudanças) e clique em Iniciar.
  4. As tarefas são executadas — em paralelo quando possível — e cada thread de trabalho abre na sua própria aba, para acompanhar cada agente separadamente.

O histórico de planos anteriores fica disponível para consulta.

O orquestrador propõe; você aprova e clica em Iniciar.

Você pode criar seus próprios agentes com o botão Criar Agente Inteligente (global, disponível em todos os seus projetos):

  • Geral: nome, descrição e cor.
  • System Prompt: as instruções permanentes dele (no mínimo 20 caracteres — que digam algo de verdade).
  • Motor de IA: qual provedor e modelo esse agente usa, independente do chat.
  • Ferramentas: no que ele pode mexer, com presets rápidos — Todas, Somente leitura, Código, Git.

Assim você monta, por exemplo, um revisor de código rigoroso em um modelo potente e um buscador barato em um modelo local, e os combina na mesma equipe.

Cada passo leva seu papel, seu prompt editável, seu motor e de quais outros passos depende.
Ao iniciar, cada especialista abre a própria thread: dá para ver quem terminou e quem continua trabalhando.
A linha do tempo registra tudo: início, subagentes, resultados e cancelamentos.
Cada especialista tem seu próprio subchat: o pai recebe apenas o relatório final.
A equipe de agentes: papéis com sua especialidade, prontos para o orquestrador distribuir.