Formar uma equipa de agentes

Este guia mostra-lhe como criar uma equipa, dar-lhe um líder e encaminhar trabalho para ela.

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

Crie, renomeie e componha equipas em Definições → Espaço de trabalho → Agentes → Equipas. Encaminhe trabalho para uma equipa de uma de duas formas: um agente chama assign_ticket com o team_id dessa equipa, ou um nó de pipeline Team dispatch despacha a equipa (sem atribuir um ticket). O seletor de responsáveis de um ticket inclui-o a si e a agentes individuais.

Criar uma equipa

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

A equipa é criada e fica selecionada, e o respetivo editor abre no painel da direita.

Definir o líder

Este é o passo de que depende toda a funcionalidade. No editor da equipa:

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

Promover um agente a líder também o torna membro, se ainda não o fosse. Uma equipa deixada em Sem líder é inerte: nada é despachado quando lhe é encaminhado trabalho, e remover o líder atual da lista de membros deixa a equipa novamente sem líder.

Adicionar membros

No mesmo editor, use o cartão de membros para adicionar agentes do espaço de trabalho e para os remover. Os membros são a lista por onde o líder delega.

As equipas estão limitadas ao espaço de trabalho: só agentes deste espaço de trabalho podem fazer parte delas.

Dar um espaço à equipa

Não existe nenhum espaço de equipa automático. Se quiser um, crie um espaço comum a partir de Espaços e adicione-lhe os agentes da equipa. Um Team contém um nome, uma descrição, um líder, instruções e membros — mas nenhuma associação a um espaço.

As linhas de reporte são uma coisa à parte

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

Isto não determina o encaminhamento para as equipas. Um líder escolhe um delegado a partir da lista de membros da equipa, com base nas skills e no papel, e não seguindo a cadeia de reporte. As concessões de acesso à memória dependem do papel de um agente, e não da cadeia de reporte, e nenhuma superfície de análise agrega por equipa ou por hierarquia. As proteções de delegação limitam a profundidade e detetam ciclos, mas nunca exigem que o destino seja um subordinado.

O que faz um ticket encaminhado

Quando um ticket tem de facto uma equipa atribuída:

O líder da equipa é despachado com o ticket, as suas instruções operacionais e a lista de membros.
O líder delega nos membros e regista a sua avaliação com a ferramenta record_team_activity — action (delegou), no_action (nada mais a fazer, o que impede que o líder volte a ser despertado) ou failed.
Cada execução de membro que termina volta a despertar o líder, dentro do limite da proteção de não-ação.

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

allParallel — uma tarefa por membro numa conversa oculta partilhada, ficando suspenso até todas as execuções terminarem, com o resultado de cada membro reunido sob a chave de saída do nó
manager — despacha apenas o líder, que coordena na conversa