Executar uma orquestração

Este guia mostra-lhe como transformar um único grande objetivo num plano de toda a equipa que se executa sozinho. Consulte Orquestração para saber como funciona.

Quando usar uma orquestração

Recorra a uma orquestração quando o pedido é maior do que um único agente e ainda não conhece os passos exatos. Para uma tarefa isolada, envie uma mensagem a um agente num espaço; para um processo que consegue descrever à mão, crie um modelo de pipeline.

Passo 1: Pedir o plano

Abra (ou crie) um espaço e um ticket de âncora. Todas as propostas exigem um (propose_orchestration recebe ticket_id); o espaço partilhado vem desse ticket.
Opcionalmente, mude o seletor de modo do compositor para Orchestrate. Esse modo restringe o agente a ler e a propor — memória, o grafo de código, leituras de repos e de tickets, propose_orchestration e as ferramentas de playbook —, pelo que não pode começar a escrever código em vez de planear.
Mencione o seu orquestrador com @ (normalmente o agente CEO) e indique o objetivo em linguagem simples:

@ceo Investigue o panorama competitivo de um gravador de reuniões com prioridade 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 precisa, o trabalho dividido em subtarefas, uma fase opcional de investigação e discussão, um passo de síntese que produz o entregável e um orçamento.

Como a proposta é um objeto tipado, a aplicação valida-a (funções bem formadas, esquemas de saída declarados, um DAG sem ciclos) antes de algo ser executado. Uma proposta que não passe na validação não pode ser aprovada.

Passo 2: Rever e editar 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 um separador de editor. O próprio cartão não pode ser editado.

Para alterar o que quer que seja, prima 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 no plano detém o passo — não pode fixar uma função a um agente específico com nome nem editar a lista de contratações a partir do inspetor, e não pode editar o orçamento.

Duas coisas são só de leitura: os nós estruturais (investigação, 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.

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

Passo 3: Aprovar

Aprove o plano, a partir do cartão da conversa ou da barra de aprovação do Plan Studio. Esta é a única decisão que toma. A aprovação é exclusiva do operador — não existe nenhuma ferramenta MCP para isso, pelo que um agente pode propor e rever, mas nunca aprovar o seu próprio plano.

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

contrata todas as funções novas (e regista os identificadores dos agentes contratados, para que uma falha a meio da aprovação possa ser retomada sem contratações duplicadas)
agrupa as funções numa equipa
cria um projeto e arquiva o ticket principal nele
inicia a execução do pipeline que impulsiona tudo isto

O estado passa para approved e depois para executing.

Passo 4: Acompanhar a execução

As subtarefas são executadas como passos de pipeline; se ativou uma ronda de discussão, cada função publica primeiro uma posição. O progresso aparece onde já olha:

o ticket principal em que a orquestração foi ancorada
o espaço partilhado onde a equipa conversa, em que a linha do plano acompanha o estado de cada nó
o detalhe da execução do pipeline, com a sua habitual cascata de tempos e o custo por passo — consulte Monitorizar execuções de pipeline
o projeto em que o ticket principal foi arquivado

Quando as subtarefas terminarem, o estado passa para synthesizing e o passo de síntese produz o entregável. Esse texto é publicado no espaço partilhado e o ticket principal é marcado como concluído e, em seguida, como completed.

Interromper antecipadamente

Prima Cancelar orquestração no cartão da conversa ou Cancelar execução na barra de aprovação do Plan Studio. O cancelamento desmancha o trabalho em curso.

Uma orquestração falha quando a materialização falha, ou quando falha a execução do pipeline gerado (investigação, discussão, síntese ou persistência — esses passos não continuam em caso de falha). Os passos de trabalho gerados continuam sempre em caso de falha, pelo que uma subtarefa com falha não faz falhar a execução. Não existe nenhum caminho de falha por orçamento excedido nem um limiar de «todas as subtarefas falharam».

Guias relacionados

Trabalhar no Plan Studio: editar, estimar, comparar diferenças e aprovar o plano
Criar e gerir tickets: o ticket principal em que uma orquestração é ancorada
Organizar o trabalho com projetos: onde o ticket principal é arquivado
Monitorizar execuções de pipeline: como aparece no motor uma orquestração materializada
Formar uma equipa de agentes: as funções que uma orquestração preenche ou contrata