SuperAgentes
Registrar agentes externos por URL e liberá-los para os workspaces da organização.
Um SuperAgente é um agente que já existe fora da AUMO. A organização registra o endereço do serviço, e a plataforma passa a oferecê-lo aos workspaces como se fosse um Agente próprio.
Ele não tem prompt, modelo nem coleções para você configurar: tudo isso pertence a quem mantém o serviço do outro lado.
Quando usar
Um SuperAgente cabe quando o agente já foi construído em outro lugar e você quer apenas disponibilizá-lo dentro da plataforma: um atendimento que roda em outro sistema, uma pesquisa especializada, uma automação comercial.
Se o agente ainda vai ser construído, o caminho é criar um Agente dentro de um workspace.
Registrar na organização
Em Organização › SuperAgentes, disponível para Superadmin e Admin:
- Clique em + SuperAgente.
- Informe o Nome do SuperAgente, como ele aparecerá para as pessoas.
- Informe a URL do endpoint e a Chave de acesso.
- Clique em Validar acesso.
A tela de cadastro é pensada para SuperAgentes contratados da Aumo: a URL e a chave de acesso são enviadas pela Aumo depois da contratação, e o painel ao lado traz o caminho para falar com a Aumo.
Na barra estreita à esquerda, clique em Organização.
A plataforma registra a URL como endpoint e define responses como a API suportada. O serviço do outro lado precisa responder no contrato da Responses API.
Liberar para um workspace
Depois de criado, o SuperAgente entra no catálogo da organização e ainda não aparece em nenhum workspace.
A liberação acontece em Organização › Workspaces: abra o workspace desejado e use a seção de SuperAgentes para associar os que aquele time pode usar.
No workspace
Workspace › SuperAgentes lista o que a organização liberou para aquele time. Não há o que criar ali, porque a tela só mostra o que está disponível.
Uma lista vazia significa que nenhum SuperAgente foi registrado na organização, ou que este workspace não foi associado a nenhum. Nos dois casos o caminho é falar com quem tem papel de Admin ou Superadmin.
No Chat
Agentes e SuperAgentes aparecem no mesmo seletor, com nome e descrição, sem distinção visual.
A distinção importa quando algo dá errado. Um Agente com resposta ruim se ajusta no prompt ou nas Coleções. Um SuperAgente com resposta ruim exige falar com quem mantém o serviço externo.
Manutenção
Editar um SuperAgente altera nome e endpoint. Trocar a URL redireciona todas as conversas futuras para o novo endereço, em todos os workspaces em que ele estiver associado.
Remover um SuperAgente o tira do catálogo e das associações. As conversas antigas continuam no histórico, mas não é possível seguir conversando.
Consumo
O consumo de um SuperAgente aparece na Observabilidade do workspace como qualquer outra chamada, mas o modelo por trás dele é decidido do lado externo.
Isso significa que as Quotas por provedor podem não capturar esse consumo da mesma forma que capturam o de um Agente comum.
Próximos passos
- Entenda a diferença conceitual em Agentes e SuperAgentes.
- Veja o que mais a organização distribui aos times em Workspaces.