Quando usar
-
Você quer criar um novo Agente Especialista para um assunto específico
-
Você editou um especialista e ele "não aparece" ou não está sendo acionado
-
Você não sabe a diferença entre um especialista em rascunho e um publicado
-
Você quer testar um Agente Especialista antes de colocá-lo no ar
Pré-requisitos
-
Acesso de administrador ao Hub do projeto
-
Um Supervisor já configurado no projeto (o Agente Especialista precisa estar vinculado a ele para entrar em produção)
Sobre este artigo
Todo Agente Especialista passa por um ciclo de vida: ele é criado como rascunho, é vinculado ao Supervisor, testado no Playground e só então publicado para atender clientes de verdade. Este artigo explica cada uma dessas etapas e os motivos mais comuns de um especialista "sumir" ou não ser acionado.
Passo a passo
Etapa 1 — Criar o Agente Especialista
Na tela de Agentes do Hub, crie um novo especialista com um nome e uma descrição claros (veja "O que são Agentes Especialistas e como o Supervisor decide quem responde" para dicas de como escrever essa descrição). Ao ser criado, ele fica em rascunho — só visível para configuração, ainda não é usado em nenhum atendimento real.
Etapa 2 — Vincular ao Supervisor
Para o especialista poder ser acionado, ele precisa estar na lista de especialistas do Supervisor. Esse vínculo é feito na configuração do próprio Supervisor, adicionando o novo Agente Especialista à lista.
Etapa 3 — Testar no Playground
Antes de publicar, teste o novo especialista no Playground. No seletor do Playground, o grupo Sub-agentes permite testar o especialista isoladamente, e o grupo Supervisores permite testar o fluxo completo (Supervisor decidindo se aciona ou não o novo especialista). Nenhuma mensagem enviada no Playground chega a clientes reais.
Etapa 4 — Publicar
Enquanto estiver em rascunho, o Agente Especialista não pode ser usado em produção — ele precisa ser publicado primeiro. Depois de publicado, hoje você precisa acionar alguém do time pelo Suporte para ativar ele em produção.
Observações
-
"Criei o especialista mas ele não aparece/não é acionado" — na grande maioria dos casos, é uma destas duas situações: (1) ele ainda está em rascunho e não foi publicado, ou (2) ele não está (mais) vinculado ao Supervisor certo. Confira essas duas coisas antes de abrir um chamado de suporte.
-
"Apareceu um erro dizendo que o Supervisor está bloqueado" — isso normalmente é concorrência: outra pessoa (ou outra aba) está editando o mesmo Supervisor ao mesmo tempo. Aguarde alguns segundos e tente novamente.
-
Depois de publicado, use a auditoria de conversas para confirmar que o especialista está sendo acionado como esperado — veja "Ativação gradual (Teste A/B) e auditoria de um Agente Especialista".