Montar uma equipe de agentes

Este guia mostra como criar uma equipe, definir um líder para ela e direcionar trabalho a ela.

Uma equipe é um grupo nomeado de agentes dentro de um espaço de trabalho, com um agente designado como seu líder. Atribuir um ticket à equipe desperta o líder, que decompõe o trabalho e delega aos membros; quando a execução de um membro termina, o líder é despertado de novo para decidir o que vem a seguir.

Crie, renomeie e monte equipes em Configurações → Espaço de trabalho → Agentes → Teams. Há duas formas de direcionar trabalho a uma equipe: um agente chama assign_ticket com o team_id dessa equipe, ou um nó de pipeline Team dispatch despacha a equipe (sem atribuir um ticket). O seletor de responsáveis do ticket lista você e os agentes individualmente.

Criar uma equipe

Abra Configurações → Espaço de trabalho → Agentes (/settings/workspace/agents).
Clique em Teams no cabeçalho da página.
Clique em Add team.
Informe um nome (por exemplo, “backend” ou “review squad”) e uma descrição opcional e clique em Criar.

A equipe é criada e selecionada, e seu editor abre no painel à direita.

Definir o líder

É deste passo que todo o recurso depende. No editor da equipe:

Em Líder, escolha um agente. O texto de ajuda descreve exatamente isso: “O coordenador que recebe o trabalho atribuído à equipe e delega ao membro mais adequado.”
Opcionalmente, preencha Instruções operacionais — texto livre entregue ao líder junto com cada ticket direcionado.

Promover um agente a líder também o torna um membro, caso ainda não fosse. Uma equipe deixada em Sem líder é inerte: nada é despachado quando se direciona trabalho a ela, e remover o líder atual da lista de membros deixa a equipe sem líder outra vez.

Adicionar membros

No mesmo editor, use o cartão de membros para adicionar agentes do espaço de trabalho e removê-los. Os membros são o quadro de onde o líder escolhe a quem delegar.

As equipes têm escopo de espaço de trabalho: só podem entrar agentes deste espaço de trabalho.

Dar um espaço à equipe

Não existe um espaço de equipe automático. Se você quiser um, crie um espaço comum em Espaços e adicione a ele os agentes da equipe. Um Team carrega nome, descrição, líder, instruções e membros — nenhuma associação a espaço.

As linhas de reporte são outra coisa

Cada agente também tem um campo Reporta-se a, definido em Configurações → Espaço de trabalho → Agentes. Isso constrói a árvore de reporte do espaço de trabalho, que você pode ver com o botão Organograma na página de agentes.

Isso não comanda o roteamento das equipes. O líder escolhe um delegado no quadro de membros da equipe por skills e papel, não pela cadeia de reporte. As concessões de acesso à memória têm como chave o papel do agente, não a cadeia de reporte, e nenhuma superfície de análise agrega por equipe ou hierarquia. As proteções de delegação limitam a profundidade e detectam ciclos, mas nunca exigem que o alvo seja um subordinado.

O que um ticket direcionado faz

Quando um ticket realmente traz uma atribuição de equipe:

O líder da equipe é despachado com o ticket, suas instruções operacionais e o quadro de membros.
O líder delega aos membros e registra sua avaliação com a ferramenta record_team_activity — action (delegado), no_action (não há mais nada a fazer, o que interrompe novos acionamentos) ou failed.
Cada execução de membro concluída desperta o líder novamente, com o limite da proteção de ausência de ação.

O nó Team dispatch de pipeline é o outro ponto de entrada. Ele recebe um id de equipe, um prompt e um modo de despacho:

allParallel — uma tarefa por membro em uma conversa oculta compartilhada, suspendendo até que todas as execuções terminem, com a saída de cada membro coletada sob a chave de saída do nó
manager — despacha apenas o líder, que coordena na conversa