DOCS

Configurar o agente e o conhecimento do MBA

Escreva um prompt útil, defina intenções e variáveis e publique conhecimento reutilizável em vários WhatsApps.

Administrador

Configurar o agente e o conhecimento do MBA

O cadastro do agente reúne prompt, intenções e variáveis de saída. Conhecimento e instruções complementares ficam relacionados a esse cadastro. A mesma configuração pode ser vinculada a mais de um WhatsApp; cada número recebe a versão que você publicar para ele.

Acesse Agentes Meta. Crie o agente ou abra sua visualização para editar e acessar Conhecimento, Comportamento e Operação.

Escreva o prompt para responder antes de encaminhar

Em Prompt do agente, descreva quem ele representa, quais dúvidas pode resolver, quais informações deve solicitar e o que fazer quando não souber a resposta. Dê preferência a regras verificáveis, com exemplos curtos. O prompt complementa os critérios das intenções; ele não substitui a configuração das rotas no fluxo.

Exemplo de orientação:

Você atende clientes da Empresa Exemplo pelo WhatsApp. Responda dúvidas sobre
produtos e horários usando somente o conhecimento cadastrado. Se faltar um
dado para responder, faça uma pergunta curta. Não invente preços ou prazos.
Encaminhe para a rota "proposta" somente quando o cliente pedir que a equipe
prepare uma proposta ou confirme que quer avançar. Perguntas exploratórias
sobre preço continuam com você. Se a pessoa pedir atendimento humano,
use o transbordo. Nunca diga que transferiu antes de a transferência acontecer.

Crie intenções apenas para ações reais

Em Intenções, cada item tem Nome da rota e Quando encaminhar. A intenção vira uma saída do fluxo de retorno. Descreva a condição de transferência como uma ação explícita do cliente, e não como um assunto, uma palavra-chave ou um interesse vago.

Mensagem do clienteDecisão recomendada
“Quanto custa o plano?”Responder ou esclarecer a dúvida com o conhecimento disponível.
“Quero que o comercial prepare uma proposta para minha empresa.”Usar a intenção de proposta, se ela foi cadastrada.
“Quero falar com uma pessoa.”Usar Erro / Transbordo, se nenhuma rota específica se aplicar.

O agente só deve anunciar a transferência depois que ela foi efetivamente iniciada. Escrever “vou transferir” na resposta, por si só, não executa uma rota. Teste esse comportamento com pedidos explícitos e com mensagens ambíguas: as duas situações precisam produzir resultados diferentes.

Defina as variáveis de saída

Em Variáveis de saída, cadastre o Nome e a Descrição de cada dado que o agente pode extrair, por exemplo empresa (“nome da empresa informado pelo cliente”) e objetivo (“motivo declarado para o contato”). Use nomes simples, sem espaços, e descreva o que conta como um valor válido.

Quando o cliente informa um valor, o MBA pode registrá-lo para o fluxo de retorno. A variável fica disponível para mensagens, condições e outras ações do fluxo. Peça ao agente para registrar apenas dados novos e explícitos; ele não precisa chamar a captura em toda mensagem e não deve completar dados por suposição. Veja o uso das variáveis no fluxo.

Adicione conhecimento antes de ativar

Na visualização do agente, abra os grupos conforme a necessidade:

  • Perguntas frequentes: pergunta do cliente e resposta revisada. Comece por dúvidas recorrentes e respostas objetivas.
  • Informações comerciais: dados de negócio usados na resposta.
  • Sites e Arquivos: fontes de conhecimento mantidas pela empresa.
  • Instruções: regras adicionais de comportamento e de quando aplicá-las.
  • Conectores e Ferramentas: integrações avançadas para ações externas. As rotas de intenção e a captura de variáveis da Agilize são preparadas na publicação; não é preciso cadastrar esses conectores manualmente para começar.
  • Limites de uso e Contatos de teste: controle operacional e validação com público restrito.

Você também pode abrir Perguntas frequentes do MBA para cadastrar ou revisar as respostas individualmente.

Importe perguntas frequentes por CSV

Na visualização do agente, use Importar perguntas frequentes. O arquivo deve ter cabeçalho pergunta,resposta ou question,answer, separado por vírgula ou ponto e vírgula. Exemplo:

pergunta;resposta
Qual é o horário de atendimento?;Atendemos de segunda a sexta, das 9h às 18h.
Como solicito uma proposta?;Conte o que precisa e nossa equipe poderá preparar uma proposta.

O limite é 500 KB e 200 perguntas por importação. Revise a prévia antes de importar. O CSV é processado na tela; após a importação, ficam os cadastros das perguntas, e não o arquivo enviado. Se a operação parar no meio, confira quantas perguntas foram importadas antes de repetir.

Publique e revise em cada número

Salve o agente e o conhecimento. Na visualização, clique em Publicar nos números vinculados ou, na edição de um WhatsApp, em Publicar alterações. A publicação inclui prompt, rotas, conhecimento e limites. A Meta pode revisar instruções antes de aplicá-las; confira o estado do número e teste o resultado.

Sempre que mudar uma intenção, abra também o fluxo MBA e use Atualizar saídas na entrada. Revise conexões de rotas removidas antes de publicar. Mantenha uma saída Erro / Transbordo conectada para pedidos humanos e situações que o agente não conseguir resolver.