1. [Ajuda](https://nuvia.ai/docs) 2. [MCP da Nuvia](https://nuvia.ai/docs/colecoes/19724087-mcp-da-nuvia) # Como criar e editar Funis Inteligentes pelo MCP (Agent Builder) Ler, testar, criar, editar e reaproveitar Funis Inteligentes conversando com uma IA conectada ao MCP da Nuvia — o que qualquer usuário faz e o que é exclusivo do Company Admin. Disponível em contas com o Agent Builder MCP habilitado (ligado por padrão). Quem pode fazer ler e simular — qualquer usuário; criar, editar e configurar o HubSpot — apenas Company Admin Atualizado em 3 de novembro de 2026 [MCP da Nuvia](https://nuvia.ai/docs/colecoes/19724087-mcp-da-nuvia) 1. [Como utilizar o MCP da Nuvia](https://nuvia.ai/docs/artigos/15825545-como-utilizar-o-mcp-da-nuvia) 2. [Como conectar o MCP da Nuvia](https://nuvia.ai/docs/artigos/15422389-como-conectar-o-mcp-da-nuvia) 3. [Como criar e editar Funis Inteligentes pelo MCP (Agent Builder)](https://nuvia.ai/docs/artigos/16074655-como-criar-e-editar-funis-inteligentes-pelo-mcp-agent-builder) 4. [Referência das ferramentas MCP da Nuvia](https://nuvia.ai/docs/artigos/16074574-referencia-das-ferramentas-mcp-da-nuvia) 5. [Como usar a Auditoria MCP](https://nuvia.ai/docs/artigos/15422393-como-usar-a-auditoria-mcp) 6. [Como conectar o MCP da Nuvia ao Google Antigravity](https://nuvia.ai/docs/artigos/16530912-como-conectar-o-mcp-da-nuvia-ao-google-antigravity) 7. [Como conectar o MCP da Nuvia no Microsoft Copilot Studio](https://nuvia.ai/docs/artigos/17765183-como-conectar-o-mcp-da-nuvia-no-microsoft-copilot-studio) Nesta página 1. Antes de começar 2. Ler e entender seus agentes 3. Testar antes de ativar (simular conversa) 4. Criar ou editar um agente 5. Reaproveitar um funil (exportar e importar) 6. Configurar o HubSpot pelo MCP 7. Medir o resultado de um agente **Nesta página7 seções** 1. Antes de começar 2. Ler e entender seus agentes 3. Testar antes de ativar (simular conversa) 4. Criar ou editar um agente 5. Reaproveitar um funil (exportar e importar) 6. Configurar o HubSpot pelo MCP 7. Medir o resultado de um agente 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](https://nuvia.ai/docs/artigos/15422389-como-conectar-o-mcp-da-nuvia). Para a lista de todas as ferramentas disponíveis, veja [Referência das ferramentas MCP da Nuvia](https://nuvia.ai/docs/artigos/16074574-referencia-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. Nota Tudo funciona restrito à sua empresa (só os seus dados) e fica registrado na tela **Auditoria MCP**. Se alguém disser “o agente mudou sozinho”, é lá que você confere quem fez o quê. Veja [Como usar a Auditoria MCP](https://nuvia.ai/docs/artigos/15422393-como-usar-a-auditoria-mcp). ## 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. Importante Na simulação o agente **não executa** as habilidades externas (chamadas a sistemas, tabelas, agenda) — ele só indica que dispararia. É ótimo para revisar o texto e o fluxo, mas não é 100% igual ao ambiente ao vivo. Use sempre a simulação antes de ativar um agente. ## 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. 1. Peça para a IA **criar ou editar** o agente descrevendo o objetivo de cada etapa 2. Revise a proposta, que aparece descrita em português (não em código) 3. Peça uma **simulação** para conferir o comportamento 4. Ative o agente pela plataforma quando estiver satisfeito Importante Publicar um agente pelo MCP cria sempre um **rascunho** — nada vai ao ar sozinho. A ativação continua sendo uma ação consciente feita por você, pela plataforma. ### 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. Crítico Confirme a edição de um agente ativo só quando tiver certeza. Não existe desfazer: a nova instrução passa a valer na próxima mensagem que o agente responder. Se a mudança for grande ou arriscada, o caminho seguro é **exportar o funil** (para ter uma cópia), editar e simular antes. 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. Importante A exportação e a importação acontecem **dentro da própria conta**. Levar um funil de uma conta para outra não faz parte do que o administrador do cliente consegue fazer. ## 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. Importante Cada configuração de mapeamento **substitui a lista inteira**. Faça uma alteração por vez e evite duas pessoas mexendo ao mesmo tempo (vale sempre a última). O funil escreve no estágio do negócio (deal stage), não no ciclo de vida (lifecycle). ## 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. ## Perguntas frequentes **Preciso ser administrador para usar o Agent Builder?** Não para tudo. Ler os agentes e simular conversas vale para qualquer usuário (com o Agent Builder habilitado, o que é padrão). Criar, editar, exportar/importar funis e configurar o HubSpot são exclusivos do perfil **Company Admin**. **A IA ativa o agente sozinha depois que eu peço uma mudança?** Não. Toda alteração publicada pelo MCP entra como **rascunho** e passa pela verificação de qualidade. Ativar continua sendo uma ação consciente feita por você, pela plataforma. **A simulação fala com o lead de verdade?** Não. A simulação é um ensaio: o agente responde usando a mesma IA de produção, mas não cria conversa, não contata o lead e não aparece na tela de Conversas. Ela também não executa habilidades externas (sistemas, tabelas, agenda). **Posso levar um funil de uma conta para outra?** A exportação e a importação de funil pelo Company Admin acontecem dentro da própria conta. Recriar um funil em outra empresa não faz parte do que o administrador do cliente consegue fazer pelo MCP. **Que tipos de campo personalizado posso criar pela conversa?** Pela conversa, a criação de campo aceita apenas os tipos **texto**, **data** e **número**. Não é possível criar campos de lista de opções ou múltipla escolha por esse caminho. **A sincronização de etapas com o HubSpot vai nos dois sentidos?** O avanço de etapa vai da Nuvia para o HubSpot (o negócio anda de estágio quando o lead avança). Há também um caminho de volta, opcional por etapa, em que a mudança no HubSpot reflete na conversa da Nuvia. Cada mapeamento definido substitui a lista inteira, então altere um item por vez. [AnteriorComo conectar o MCP da Nuvia](https://nuvia.ai/docs/artigos/15422389-como-conectar-o-mcp-da-nuvia) [PróximoReferência das ferramentas MCP da Nuvia](https://nuvia.ai/docs/artigos/16074574-referencia-das-ferramentas-mcp-da-nuvia) Este artigo ajudou? ## Artigos relacionados - [Como configurar um Funil Inteligente na Nuvia](https://nuvia.ai/docs/artigos/14570332-como-configurar-um-funil-inteligente-na-nuvia) - [Como utilizar o MCP da Nuvia](https://nuvia.ai/docs/artigos/15825545-como-utilizar-o-mcp-da-nuvia) - [Como conectar o MCP da Nuvia ao Google Antigravity](https://nuvia.ai/docs/artigos/16530912-como-conectar-o-mcp-da-nuvia-ao-google-antigravity) [MCP da Nuvia](https://nuvia.ai/docs/colecoes/19724087-mcp-da-nuvia) 1. [Como utilizar o MCP da Nuvia](https://nuvia.ai/docs/artigos/15825545-como-utilizar-o-mcp-da-nuvia) 2. [Como conectar o MCP da Nuvia](https://nuvia.ai/docs/artigos/15422389-como-conectar-o-mcp-da-nuvia) 3. [Como criar e editar Funis Inteligentes pelo MCP (Agent Builder)](https://nuvia.ai/docs/artigos/16074655-como-criar-e-editar-funis-inteligentes-pelo-mcp-agent-builder) 4. [Referência das ferramentas MCP da Nuvia](https://nuvia.ai/docs/artigos/16074574-referencia-das-ferramentas-mcp-da-nuvia) 5. [Como usar a Auditoria MCP](https://nuvia.ai/docs/artigos/15422393-como-usar-a-auditoria-mcp) 6. [Como conectar o MCP da Nuvia ao Google Antigravity](https://nuvia.ai/docs/artigos/16530912-como-conectar-o-mcp-da-nuvia-ao-google-antigravity) 7. [Como conectar o MCP da Nuvia no Microsoft Copilot Studio](https://nuvia.ai/docs/artigos/17765183-como-conectar-o-mcp-da-nuvia-no-microsoft-copilot-studio) ## Ainda precisa de ajuda? Clientes falam com o suporte pelo chat dentro da plataforma. Ainda não é cliente? Fale com o nosso time. [Falar com o suporte na plataforma](https://app.nuvia.ai) [Ainda não sou cliente](https://nuvia.ai/contact) --- Source: https://nuvia.ai/docs/artigos/16074655-como-criar-e-editar-funis-inteligentes-pelo-mcp-agent-builder