# Agilize Docs para IA - Página atual Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize. Use esta versão quando a pergunta do usuário estiver restrita ao documento atual. Última geração: 2026-10-02T04:00:08.654Z ## Página - Título: Configurar o agente e o conhecimento do MBA - URL humana: https://agilize.app/docs/configuracao/inteligencia-artificial/meta-business-agent/configurar-agente-conhecimento - Leitura completa para IA: https://agilize.app/docs/llms.txt - Descrição: Escreva um prompt útil, defina intenções e variáveis e publique conhecimento reutilizável em vários WhatsApps. ## Seções - Escreva o prompt para responder antes de encaminhar - Crie intenções apenas para ações reais - Defina as variáveis de saída - Adicione conhecimento antes de ativar - Importe perguntas frequentes por CSV - Publique e revise em cada número ## Conteúdo da página # 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 :ScreenEntry{href="https://my.agilize.app/messenger/meta/mba/agent" label="Agentes Meta" path="sidebar lateral > módulo Mensageria > Configurações > Agentes de IA > Meta Business Agent (MBA) > 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: ```text 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 cliente | Decisã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](/docs/configuracao/inteligencia-artificial/meta-business-agent/fluxo-retorno-intencoes-timeout). ## 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 :ScreenEntry{href="https://my.agilize.app/messenger/meta/mba/faq" label="Perguntas frequentes do MBA" path="sidebar lateral > módulo Mensageria > Configurações > Agentes de IA > Meta Business Agent (MBA) > Perguntas frequentes"} 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: ```csv 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](/docs/configuracao/inteligencia-artificial/meta-business-agent/testar-acompanhar-mba). 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.