Executar uma orquestração

Este guia mostra como transformar um objetivo grande em um plano de toda a equipe que se executa sozinho. Consulte Orquestração para saber como isso funciona.

Quando usar uma orquestração

Recorra a uma orquestração quando o pedido for maior do que um agente e você ainda não souber os passos exatos. Para uma única tarefa, envie uma mensagem a um agente em um espaço; para um processo que você consegue detalhar à mão, crie um modelo de pipeline.

Etapa 1: Peça o plano

Abra (ou crie) um espaço e um ticket de âncora. Toda proposta exige um (propose_orchestration recebe ticket_id); o espaço compartilhado vem desse ticket.
Opcionalmente, mude a lista suspensa de modo do composer para Orquestração. Esse modo restringe o agente a ler e propor — memória, o grafo de código, leituras de repos e de tickets, propose_orchestration e as ferramentas de playbook —, de modo que ele não pode começar a escrever código em vez de planejar.
Mencione seu orquestrador com @ (normalmente o agente CEO) e declare o objetivo em linguagem simples:

@ceo Pesquise o cenário competitivo de um gravador de reuniões que prioriza o modo offline e escreva um documento de posicionamento de uma página.

O orquestrador responde com um cartão de proposta estruturado no espaço: as funções de que ele precisa, o trabalho dividido em subtarefas, uma fase opcional de pesquisa e discussão, uma etapa de síntese que produz o entregável e um orçamento.

Como a proposta é um objeto tipado, o app a valida (funções bem formadas, esquemas de saída declarados, um DAG sem ciclos) antes que qualquer coisa seja executada. Uma proposta que não passa na validação não pode ser aprovada.

Etapa 2: Revise e edite a proposta

O cartão na conversa oferece três ações: Aprovar plano, Rejeitar e Abrir — que abre o plano no Plan Studio como uma aba de editor. O próprio cartão não pode ser editado.

Para alterar qualquer coisa, pressione Abrir e trabalhe no inspetor à direita:

Título, descrição, função, dependências e esquema de saída de qualquer passo de trabalho. Aqui, função significa qual das chaves de função existentes do plano é dona do passo — você não pode fixar uma função a um agente nomeado nem editar a lista de contratações pelo inspetor, e não pode editar o orçamento.

Duas coisas são somente leitura: nós estruturais (pesquisa, discussão, síntese) e qualquer nó cujo trabalho já tenha sido executado. A edição só é possível enquanto a orquestração ainda estiver proposed.

Pressione Estimar na barra de aprovação para ver intervalos de custo, duração e raio de impacto antes de confirmar. Consulte Trabalhar no Plan Studio para conhecer o editor completo.

Etapa 3: Aprove

Aprove o plano, no cartão da conversa ou na barra de aprovação do Plan Studio. Esta é a única decisão que você toma. A aprovação é exclusiva do operador — não há ferramenta MCP para isso, então um agente pode propor e revisar, mas nunca aprovar o próprio plano.

A partir daí, um materializador determinístico (uma função pura, sem LLM) transforma a proposta em um pipeline real e cria a estrutura de apoio:

contrata quaisquer funções novas (e registra os ids dos agentes contratados para que uma falha no meio da aprovação possa ser retomada sem contratações duplicadas)
agrupa as funções em uma equipe
cria um projeto e arquiva o ticket pai nele
inicia a execução do pipeline que impulsiona tudo isso

O status passa para approved e depois para executing.

Etapa 4: Acompanhe a execução

As subtarefas são executadas como etapas do pipeline; se você habilitou uma rodada de discussão, cada função publica uma posição primeiro. O progresso aparece onde você já olha:

o ticket pai no qual a orquestração foi ancorada
o espaço compartilhado em que a equipe conversa, onde a linha do plano acompanha o estado de cada nó
os detalhes da execução do pipeline, com a cronologia de sempre e o custo por etapa — consulte Monitorar execuções de pipeline
o projeto sob o qual o ticket pai foi arquivado

Quando as subtarefas terminam, o status passa para synthesizing e a etapa de síntese produz o entregável. Esse texto é publicado no espaço compartilhado e o ticket pai é marcado como concluído e, em seguida, como completed.

Interrompa mais cedo

Pressione Cancelar orquestração no cartão da conversa ou Cancelar execução na barra de aprovação do Plan Studio. O cancelamento desmonta o trabalho em andamento.

Uma orquestração falha quando a materialização falha ou quando a execução do pipeline gerado falha (pesquisa, discussão, síntese ou persistência — essas etapas não continuam em caso de falha). As etapas de trabalho geradas sempre continuam em caso de falha, então uma subtarefa com falha não faz a execução inteira falhar. Não existe caminho de falha por orçamento excedido nem um limite de “todas as subtarefas falharam”.

Guias relacionados

Trabalhar no Plan Studio: editar, estimar, comparar diferenças e aprovar o plano
Criar e gerenciar tickets: o ticket pai no qual uma orquestração é ancorada
Organizar o trabalho com projetos: onde o ticket pai é arquivado
Monitorar execuções de pipeline: como uma orquestração materializada aparece no motor
Montar uma equipe de agentes: as funções que uma orquestração preenche ou contrata