Skip to main content
Squads permitem que múltiplos agentes especializados atendam um mesmo canal de forma coordenada. Antes de criar um squad, garanta que os agentes que farão parte do grupo já estejam criados e configurados com seus respectivos modelos LLM e bases de conhecimento.

​
Passo 1: Criar um squad

1

Acesse a seção Squads

No menu lateral, clique em Squads. A lista de squads existentes é exibida.
2

Inicie um novo squad

Clique em + Novo squad no canto superior direito da tela.
3

Defina o nome

No campo Nome, escreva uma identificação clara — por exemplo, “Suporte Técnico” ou “Vendas Inbound”. O nome aparece nos relatórios e no painel de squads. Limite de 100 caracteres.
4

Adicione uma descrição (opcional)

O campo Descrição é opcional, mas recomendado para times maiores. Use-o para registrar o propósito do squad e os tipos de conversa que ele deve receber.
5

Escolha o modo de operação

Selecione Hierárquico ou Horizontal clicando no card correspondente. A escolha determina qual papel de liderança você precisará definir nos próximos passos e não pode ser alterada depois que o squad for criado.
6

Clique em Criar squad

Confirme a criação. O squad é salvo em estado inativo — você ainda precisa adicionar agentes antes de vinculá-lo a um canal.
7

Revise o resumo

A tela de detalhes do squad é aberta automaticamente. Confirme o nome, a descrição e o modo antes de prosseguir para a adição de agentes.

​
Passo 2: Adicionar agentes ao squad

Na tela de detalhes do squad, clique em Adicionar agente para incluir membros:
  • O limite é de 20 agentes ativos por squad. Agentes desativados não contam para esse limite.
  • Cada agente mantém sua própria configuração de LLM, personalidade e integrações — o squad não sobrescreve essas configurações.
Ao adicionar um agente, selecione o papel adequado conforme o modo do squad:
  • Modo Hierárquico: defina um agente como manager e os demais como member.
  • Modo Horizontal: defina um agente como principal e os demais como member ou specialist.

​
Promovendo um agente a Manager ou Principal

Após adicionar um agente ao squad, você pode alterar o papel dele diretamente na lista de membros do squad:
  • Clique no menu de opções ao lado do nome do agente.
  • Selecione Alterar papel.
  • Escolha o novo papel no seletor exibido.
  • Confirme a alteração.
Cada squad aceita apenas um manager (modo hierárquico) ou um principal (modo horizontal). Promover um segundo agente ao papel de liderança substitui o anterior automaticamente.

​
Copiando o Squad ID

O Squad ID é o identificador único do squad, necessário para vinculações programáticas via API ou para referência em integrações:
  • Na tela de detalhes do squad, localize o campo ID do squad no painel de informações.
  • Clique no ícone de cópia ao lado do ID para copiá-lo para a área de transferência.
Guarde o Squad ID em um local seguro se você planeja usar a API da Timely.ai para criar ou atualizar vínculos de canal programaticamente. O ID não muda mesmo se o nome do squad for alterado.

​
Gerenciando squads ao longo do tempo

  • Adicionar agentes: use o botão Adicionar agente a qualquer momento. O limite de 20 agentes ativos se aplica sempre.
  • Remover agentes: clique no menu de opções do agente e selecione Remover do squad. Squads com conversas ativas (hasActiveConversations) não podem ser excluídos — transfira ou encerre as conversas abertas antes.
  • Editar nome e descrição: clique em Editar squad no painel de detalhes para atualizar essas informações.
  • Excluir o squad: disponível no menu de opções da lista de squads. A ação é irreversível — os canais vinculados ao squad param de receber novas conversas imediatamente.