O Agent Builder permite ler, testar e — para administradores — criar e editar Funis Inteligentes conversando com uma IA (Claude, Cursor ou outro assistente compatível com MCP) conectada à Nuvia, sem clicar tela por tela no builder.
Módulo: MCP da Nuvia (acessado por um assistente de IA compatível com MCP)
Antes de começar
Você precisa de um assistente de IA conectado ao MCP da Nuvia. Veja Como conectar o MCP da Nuvia. Para a lista de todas as ferramentas disponíveis, veja Referência das ferramentas MCP da Nuvia.
Com o Agent Builder habilitado, as ferramentas aparecem para o assistente de IA com o prefixo builder_. Você não digita esses nomes: conversa em linguagem natural (ex.: “liste meus agentes”, “simule uma conversa com o agente de qualificação”) e o cliente escolhe a ferramenta certa.
Ler e entender seus agentes
Qualquer usuário pode pedir para a IA listar e abrir os agentes, os funis e suas etapas, os times, usuários, campos personalizados, habilidades e integrações da conta. Use isso para revisar como um Funil Inteligente está montado antes de mexer nele.
Testar antes de ativar (simular conversa)
Antes de publicar qualquer mudança, peça para a IA simular uma conversa com o agente. A simulação é um ensaio: o agente responde de verdade, mas nada acontece de fato — não cria conversa, não fala com o lead e não aparece na tela de Conversas. Você pode enviar várias mensagens em sequência (até 10) e informar dados fictícios do lead para testar um cenário.
Criar ou editar um agente
Disponível para o Company Admin. Descreva em linguagem natural o que o agente deve fazer (coletar um dado, mudar de etapa, transferir para o time, encerrar) e a IA traduz para a configuração correta — você nunca mexe em código nem em identificadores.
-
Peça para a IA criar ou editar o agente descrevendo o objetivo de cada etapa
-
Revise a proposta, que aparece descrita em português (não em código)
-
Peça uma simulação para conferir o comportamento
-
Ative o agente pela plataforma quando estiver satisfeito
Editar um agente que já está no ar
Editar não tira o agente do ar: o status é preservado. Se o agente estiver ativo, a alteração passa a valer imediatamente para os leads que estão conversando com ele naquele momento — por isso existe uma trava.
Ao pedir uma edição em um agente ativo, o assistente de IA não altera nada na primeira tentativa: ele devolve o nome do agente, avisa que está ativo e pede sua confirmação. Só depois que você confirmar de forma clara é que a mudança é aplicada. Agentes em rascunho ou inativos não pedem confirmação — o fluxo segue direto.
Toda publicação passa por uma verificação de qualidade, que separa problemas em dois níveis:
-
Bloqueios (impedem a ativação): agente sem etapas; etapa de conversa com instrução vazia ou curta demais; blocos de regras, tom, personalidade ou especialista vazios; transferência declarada que não encaixou.
-
Alertas (deixam publicar, mas revise): sem etapa de sucesso; sem passagem de uma etapa para outra; ação solta sem vínculo; ferramenta citada sem estar ligada.
Reaproveitar um funil (exportar e importar)
O Company Admin pode exportar um funil inteiro — agentes, etapas, follow-ups, campos, tabelas, habilidades e mídia — para um arquivo (válido por 24 horas) e importá-lo para recriar tudo, reconectando os elementos automaticamente. É como “salvar como” um funil que já funciona e recriá-lo.
Configurar o HubSpot pelo MCP
Disponível para o Company Admin. Pela conversa, você consegue ler a configuração atual do HubSpot (funis, responsáveis, propriedades) e definir os mapeamentos:
-
Campos: casar uma propriedade do HubSpot com um campo da Nuvia — o que o agente coleta vai para o contato no HubSpot.
-
Etapas (deal stage): casar cada etapa do funil da Nuvia com um estágio de negócio de um funil de Deals do HubSpot. Quando o lead avança na Nuvia, o negócio anda no HubSpot.
-
Responsáveis (owner): casar um usuário da Nuvia com um responsável do HubSpot.
-
Regras de sincronização: criar contato automaticamente, modelo de nome, origem do dono, entre outras.
Medir o resultado de um agente
Peça a taxa de qualificação de um agente para ver quantas conversas chegaram à etapa de sucesso num período (padrão: 60 dias). Trate como um piso para comparar agentes e identificar qual é referência de resultado, não como um número exato.