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.

Ao planejar, o orquestrador recebe um inventário do projeto: os servidores MCP conectados, as skills habilitadas e se existe grafo de conhecimento. Com grafo, ele o consulta antes de dividir o trabalho; se o objetivo envolve a arquitetura, ele a desenha com um diagrama.

Cada passo do plano pode levar as skills e os MCP de que precisa. O especialista os recebe no início da sua instrução, então carrega a skill certa e usa as ferramentas certas sem precisar descobri-las sozinho. O mesmo vale quando o orquestrador delega uma subtarefa avulsa.

Se um especialista falhar, o cartão dele mostra Retomar com…: escolha outro perfil ou modelo e ele continua com toda a transcrição.

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.

Se você pedir no chat, o orquestrador monta uma equipe para o projeto (salva em .context/agents/ do workspace) e também a administra: pode listar as equipes, ver o prompt de um agente, corrigir a descrição, o prompt, as ferramentas ou a autonomia, e apagar um agente ou uma equipe inteira. É só pedir: «remova o agente de testes», «apague a equipe antiga», «dê ao revisor acesso só de leitura». Cada mudança passa pela aprovação do chat, como qualquer escrita de arquivos.

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.