Como criar um agente subindo um documento de discovery
Nível: Intermediário Tempo de leitura: 12 min
Por que existe essa opção
A Wevi tem duas formas de criar um agente com IA: conversando com o bot de onboarding ou subindo um documento.
A primeira é ótima para quem está começando do zero. A IA conduz a entrevista, faz as perguntas certas e monta o agente com base nas suas respostas.
Mas para agências e times que já fizeram o discovery do cliente, repetir tudo de novo no formato de chat é desperdício. Você já tem o briefing, o tom de voz, as jornadas, as regras. É só passar para a IA ler.
É exatamente isso que o modo Subir documento faz. Você anexa um PDF, Markdown ou TXT com o discovery preenchido, e a IA gera em um minuto: nome, descrição, system prompt completo, mensagens iniciais, eventos de conversão e ações de webhook.
Quando usar cada modo
Use Conversar com o bot quando:
- Está criando o primeiro agente do cliente e ainda não tem nada documentado.
- O discovery está na sua cabeça, sem registro escrito.
- Você quer testar a Wevi rápido, sem preparação.
Use Subir documento quando:
- Você ou a agência já fez reunião de discovery e tem o material organizado.
- O cliente entregou um briefing, um onepager ou um deck de posicionamento.
- Você precisa criar vários agentes parecidos e quer padronizar a entrada.
- O cliente tem tom de voz e regras de marca bem definidos, e você quer que a IA capture isso fielmente.
O blueprint de discovery
Para que a IA gere um agente bom, ela precisa de um documento bem estruturado. A Wevi disponibiliza um blueprint de discovery gratuito, um modelo em Markdown com 11 seções que cobrem tudo que importa.
Você baixa o blueprint no próprio modal de upload (botão "Baixar blueprint"), preenche com o cliente, salva como PDF ou Markdown e sobe de volta na Wevi. É a forma mais simples de garantir que a IA tenha o que precisa.
As 11 seções do blueprint
Cada seção mapeia diretamente para um campo do agente. Quanto mais clara a informação, melhor o resultado.
1. Identidade. Nome da empresa, setor, site, nome do agente. Vira o nome e a descrição.
2. Missão. Em uma ou duas frases, o que o agente existe para fazer. Vira o topo do system prompt.
3. Canal. WhatsApp, chat do site, Instagram. O canal influencia o tom (mensagens mais curtas no WhatsApp) e o formato.
4. Público. Quem fala com o agente. Perfil, dores, objetivos. Quanto mais específico, mais natural a conversa.
5. Tom de voz. Três a cinco adjetivos do tom, regras sobre tratamento (você ou senhor), emoji, gírias. Capturar o tom certo é o que separa um agente que parece a marca de um agente genérico.
6. Conhecimento. Produtos, serviços, preços, FAQs, diferenciais. Tudo que o agente precisa saber para responder com confiança.
7. Fora de escopo. O que o agente NÃO deve responder, quando transferir para humano, o que nunca pode prometer. Tão importante quanto o que ele deve fazer.
8. Jornadas. As três a cinco conversas mais comuns desse agente, descritas em etapas. A IA usa isso para entender o fluxo natural.
9. Conversões. Momentos da conversa que valem ser rastreados como evento. Vira os conversion events do agente, usados em analytics e automações.
10. Integrações. Sistemas externos que o agente precisa acionar durante a conversa (CRM, agenda, webhook). Vira as ações de webhook do agente.
11. Exemplos de diálogo. Bônus, mas poderoso. Duas ou três trocas modelo mostrando como uma conversa ideal soa. A IA usa isso para calibrar o tom com precisão.
Passo a passo
1. Baixe o blueprint
No painel da Wevi, vá em Agentes e clique em Criar com IA. No popup que aparece, clique no card Subir documento.
Antes da área de upload, tem um link discreto: "Não tem um documento? Baixe nosso blueprint de discovery." Clique para baixar o arquivo .md modelo.
2. Preencha com o cliente
Abra o arquivo no editor que preferir: VS Code, Obsidian, Notion (cole o conteúdo), Google Docs (cole o conteúdo). Markdown é texto puro, abre em qualquer lugar.
Substitua os exemplos pela realidade do cliente. Não precisa preencher cada campo exaustivamente. Precisa preencher com clareza. Uma seção bem feita vale mais que cinco superficiais.
3. Exporte se quiser
Se preferir entregar para o cliente um PDF visualmente arrumado, exporte. A Wevi aceita PDF, Markdown ou TXT.
4. Suba o documento
Volte ao modal Subir documento, arraste o arquivo na área de upload ou clique para escolher. Tamanho máximo 10 MB.
Clique em Gerar agente. A IA leva aproximadamente 1 minuto para ler tudo e montar a configuração.
5. Revise antes de salvar
Você cai no formulário de criação do agente com tudo pré-preenchido. Revise:
- Nome e descrição.
- System prompt (caprichado, com seções claras).
- Mensagens iniciais sugeridas.
- Eventos de conversão (se o documento mencionou).
- Ações de webhook (se o documento descreveu integrações). Aparecem com a badge Será criada ao salvar.
Se quiser remover alguma ação que a IA propôs, basta clicar no ícone de lixeira ao lado dela.
6. Selecione conectores se aplicável
Se sua organização já tem conectores configurados (Google Calendar, HubSpot, etc), você pode marcá-los já na criação.
7. Salve
Clique em Salvar. As ações marcadas como pendentes viram registros de verdade no banco, prontas para receber a URL do webhook quando você for configurar.
Dicas para um discovery que rende um bom agente
Seja específico no tom de voz. "Amigável" não é descrição, é elogio genérico. "Acolhedor, técnico-acessível, sereno, confiante, sofisticado, trata por você nunca por senhora, emoji só folha e coração com moderação" é descrição. A IA replica o que ela enxerga.
Inclua exemplos de diálogo. Mesmo que sejam dois ou três, eles ancoram o tom melhor que qualquer adjetivo. Use a seção Exemplos de diálogo (a 11ª) sempre que possível.
Descreva o que não fazer. Regras de "não" são tão importantes quanto regras de "sim". Se o agente nunca pode prometer prazo de entrega, escreva isso. Se ele nunca pode dar diagnóstico médico, escreva isso. A IA respeita esses limites no system prompt.
Mapeie ao menos uma jornada do começo ao fim. Descrever uma jornada completa ("cliente pergunta X, agente responde Y, pergunta Z, encaminha para W") ensina a IA a entender o fluxo natural da conversa.
Nomes de eventos em snake_case curto. Para os eventos de conversão, prefira nomes como agendamento_realizado, lead_qualificado, pedido_qualificado. Evite frases inteiras.
Detalhe as integrações que existem de verdade. Se você quer que o agente dispare webhook para HubSpot quando o lead qualificar, escreva isso explicitamente, incluindo quando deve disparar e quais dados precisa coletar antes. A IA não inventa endpoints, vai listar a ação mas deixar a URL em branco para você preencher depois.
E depois?
Depois de salvar, o agente está pronto. Você pode:
- Conectar ao WhatsApp ou ao chat do site.
- Subir arquivos de base de conhecimento (o documento de discovery em si não vira RAG automaticamente, se quiser que vire, sobe na aba Base de Conhecimento).
- Testar a conversa no playground.
- Editar qualquer campo que a IA preencheu, o controle final é seu.
Se o resultado ficou abaixo do esperado, normalmente o motivo é discovery raso. Volte ao documento, aprofunde as seções que ficaram vagas (tom de voz, exemplos de diálogo, jornadas) e gere de novo. Você não paga limite de tentativas.