Criar/Editar Base de Conhecimento
Aprenda a configurar uma Base de Conhecimento para definir como a IA responde, quais informações ela usa e como adicionar conteúdos como textos, arquivos e links.
O que é esta configuração
Use esta configuração para montar a Base de Conhecimento, que é o conjunto de informações e regras que a IA usa para responder.
O preenchimento é feito em formato de passo a passo, com cartões que abrem e fecham.
Também existe o vídeo “Guia de criação” e botões como Salvar e Testar para conferir o resultado.
Onde encontrar
Caminho no menu: Listar Base de Conhecimento > Nova base
Link interno: /admin/baseConhecimento/novo
Notas de plano: Algumas opções aparecem apenas quando disponíveis no plano, como Definições de Áudio da IA e Páginas para base de conhecimento.
Resumo rápido
- Preencha Nome da Base de Conhecimento e Nome do assistente virtual.
- Escolha o Modelo da IA (opção recomendada ou opção avançada).
- Defina Personalidade e a Missão da IA.
- Complete Nome da empresa, Site e Instagram.
- Escreva as Informações do seu negócio e as Regras de atendimento (ou use Ajustar com IA / Assistente de criação).
- Clique em Salvar e, se estiver editando, use Testar para ver como ficou.
Resultado esperado: A Base de Conhecimento fica salva e pronta para a IA usar nas conversas, com o jeito de responder e as informações que foram definidas.
Campos principais (os que mais mudam o resultado)
Nome da Base de Conhecimento
edit_notetextoDescrição: Digite um nome fácil de reconhecer. Esse nome aparece como identificação da base.
Regras/validações: Use um nome curto e claro.
Placeholder exibido: "Ex: WhatsApp Trio Produtora".
Exemplos: - WhatsApp Trio Produtora
- Atendimento Loja Centro
Nome do assistente virtual
edit_notetextoDescrição: Defina o nome que representa a IA nas mensagens (ex.: um nome de pessoa).
Regras/validações: Placeholder exibido: "Ex: Isabella".
Exemplos: - Isabella
- Luna
Exibir o nome da assistente no início de cada mensagem
edit_notecheckboxDescrição: Marque para mostrar o nome do assistente no começo das mensagens.
Regras/validações: Não há formato. É apenas ligar/desligar.
Exemplos: - Marcado: mensagens começam com o nome
- Desmarcado: mensagens sem o nome
Modelo da IA
edit_noteseleçãoDescrição: Escolha como a IA funciona.
Opções visíveis:
- Assistente de criação interno ( Recomendado )
- Assistente externo GPT ( Avançado )
Regras/validações: Ao escolher Assistente externo GPT ( Avançado ), aparecem os campos Assistant ID e OpenAI API Key e várias opções ficam desativadas.
Exemplos: - Assistente de criação interno ( Recomendado )
- Assistente externo GPT ( Avançado )
Assistant ID
edit_notetextoDescrição: Preencha este campo quando a opção Assistente externo GPT ( Avançado ) estiver selecionada.
Este campo identifica o assistente externo.
Regras/validações: Placeholder exibido: "Ex: asst_123456".
O botão Testar assistente só fica habilitado quando Assistant ID e OpenAI API Key estão preenchidos.
Exemplos: - asst_123456
- asst_ABCDEF123
OpenAI API Key
edit_notesenhaDescrição: Preencha este campo quando a opção Assistente externo GPT ( Avançado ) estiver selecionada.
Use a chave para permitir o teste pelo botão Testar assistente.
Regras/validações: Placeholder exibido: "sk-...".
O botão Testar assistente só fica habilitado quando Assistant ID e OpenAI API Key estão preenchidos.
Exemplos: - sk-xxxxxxxxxxxxxxxx
- sk-aaaaaaaaaaaaaaaa
Personalidade
edit_noteseleçãoDescrição: Escolha o estilo de comportamento (por exemplo: mais formal, mais empático, mais direto).
Regras/validações: Precisa selecionar uma opção.
Exemplos de opções visíveis incluem:
- Profissional, formal, sério e cortês
- Empático, acolhedor, compreensivo e simpático
- Eficiente, direto, objetivo e focado
Exemplos: - Empático, acolhedor, compreensivo e simpático
- Profissional, formal, sério e cortês
Missão da IA
edit_noteseleçãoDescrição: Selecione uma missão pronta em Selecionar missão. Ao escolher, o texto aparece em um campo editável.
Use Alterar Missão para escolher outra opção.
Regras/validações: Precisa existir uma missão selecionada e o texto da missão precisa estar preenchido.
Exemplos: - Atendimento ao Cliente
- Vendas e Recomendações de Produtos
Nome da empresa
edit_notetextoDescrição: Digite o nome da empresa para ajudar a IA a entender o negócio.
Regras/validações: Placeholder exibido: "Ex: Trio Produtora".
Exemplos: - Trio Produtora
- Padaria Pão Quente
Site
edit_notetextoDescrição: Digite o endereço do site.
O sistema tenta ajudar ajustando o começo do link quando falta (por exemplo, colocando http://).
Regras/validações: Placeholder exibido: "Ex: www.trioprodutora.com".
O link precisa ficar em um formato válido (com domínio final, como .com).
Exemplos: - www.trioprodutora.com
- https://www.site.com
Descrição: Digite o usuário do Instagram para identificar o perfil da empresa.
Atenção: a validação aceita apenas letras, números, ponto e underline.
Regras/validações: Regex visível no comportamento: ^[a-zA-Z0-9._]{1,30}$.
Evite espaços.
O placeholder mostrado é "Ex: @TrioProdutora", mas a validação não aceita caractere fora do padrão.
Exemplos: - trioprodutora
- trio.produtora
Informações do seu negócio
edit_notetexto longoDescrição: Escreva as informações que a IA precisa saber para responder melhor.
Dica do próprio texto: inclua produtos/serviços, endereço, telefone, e-mail, missão, visão, valores e diferenciais.
Também dá para usar Ajustar com IA e depois Ver comparativo antes de Aplicar alterações.
Regras/validações: Placeholder exibido: "Insira as informações que você acha necessárias para que a IA tenha mais conhecimento sobre sua empresa e seu modelo de negócio".
Exemplos: - Horário de atendimento, endereço e principais serviços.
- Como funciona entrega/troca/pagamento e quais produtos existem.
Como configurar (passo a passo)
Começar uma nova base ou abrir uma existente
Clique em Nova base (ou Nova Base de Conhecimento) para criar.
Para editar, abra uma base existente e use Salvar depois das mudanças.
Definir o comportamento básico da IA
Preencha Nome da Base de Conhecimento e Nome do assistente virtual.
Escolha a Personalidade.
Defina a Missão da IA e ajuste o texto da missão se precisar.
Escolher o Modelo da IA (quando necessário)
Em Modelo da IA, selecione uma opção.
Se selecionar Assistente externo GPT ( Avançado ), preencha Assistant ID e OpenAI API Key e use Testar assistente.
Preencher os dados da empresa
Digite Nome da empresa, Site e Instagram.
Se estiver criando uma base nova, aparece uma mensagem dizendo: “Vamos acessar seu Instagram e site para obter alguns dados...”.
Adicionar as informações do negócio
Preencha Informações do seu negócio.
Se quiser ajuda:
- Digite um pedido no campo de ajuste (ex.: “resuma em 3 parágrafos”).
- Clique em Ajustar com IA.
- Use Ver comparativo e clique em Aplicar alterações se fizer sentido.
Alternativa: clique em Assistente de criação e finalize com Editar manualmente quando quiser.
Definir regras de atendimento
Preencha Regras de atendimento.
Também existe Ajustar com IA, Ver comparativo e Aplicar alterações, além do Assistente de criação.
Salvar e testar
Clique em Salvar.
Se estiver editando (ou usando modo avançado), use Testar para ver como a IA responde.
Opcional: adicionar conteúdos extras
Se aparecer para a conta:
- Use Escolher Arquivo para enviar arquivos.
- Use Adicionar novo site para cadastrar links.
Acompanhe o Número máximo de caracteres na barra de progresso.
Regras e limites importantes
- Para avançar no passo a passo, existem campos obrigatórios (quando faltam, aparece o aviso “Favor preencher os campos obrigatórios”).
- No modo Assistente externo GPT ( Avançado ), é obrigatório preencher Assistant ID e OpenAI API Key (e várias opções ficam desativadas).
- Em Site, quando falta http:// ou https://, o sistema pode adicionar automaticamente. Se o host estiver no formato www.algumacoisa sem domínio final, pode adicionar .com. Depois disso, o formato ainda precisa ser válido.
- Em Instagram, o valor precisa seguir ^[a-zA-Z0-9._]{1,30}$ (sem espaços e sem caracteres fora do padrão).
- Em Definições de Áudio da IA, a dica é clara: “Deixe em branco para desativar o envio de audio pela IA” em Quando responder por áudio.
- No upload, o limite exibido é: “O tamanho do arquivo não pode exceder 100MB”.
- Ao editar um arquivo, pode aparecer o aviso: “O conteúdo do arquivo excede o limite de 100.000 caracteres...” e o sistema pode bloquear Usar como Base de Conhecimento (por exemplo quando for PDF ou conteúdo vazio).
Problemas comuns e como resolver
Causa provável: Algum campo obrigatório do passo atual (ou do próximo passo) ficou em branco.
Como corrigir: Volte e preencha os campos que estão marcados com erro.
Nos passos iniciais, atenção especial para Nome da Base de Conhecimento, Nome do assistente virtual, Personalidade e Missão da IA.
Em Dados da empresa, confira Nome da empresa, Site e Instagram.
Como confirmar: Clique em Próximo Passo (ou Salvar) e confirme que a mensagem não aparece mais.
Causa provável: Faltou preencher Assistant ID e/ou OpenAI API Key.
Como corrigir: Em Modelo da IA, mantenha Assistente externo GPT ( Avançado ) selecionado.
Preencha Assistant ID e OpenAI API Key.
Clique em Testar assistente.
Como confirmar: Confira se o botão Testar assistente fica habilitado e se a configuração permite seguir/salvar.
Causa provável: O valor contém caracteres fora do padrão (por exemplo, espaços ou símbolos).
Como corrigir: Digite somente o usuário, usando apenas letras, números, ponto e underline.
Remova espaços e qualquer símbolo que não seja permitido.
Como confirmar: Tente avançar/salvar e verifique se o campo deixa de ficar marcado como erro.
Causa provável: O arquivo escolhido ultrapassa o limite.
Como corrigir: Escolha um arquivo menor.
Se o conteúdo for grande, divida em partes menores e envie como arquivos separados.
Como confirmar: Clique em Escolher Arquivo e confirme que o upload avança sem mostrar o aviso.
Causa provável: O arquivo não pode ser usado como base (por exemplo, PDF ou conteúdo vazio) ou excedeu o limite indicado.
Como corrigir: Abra Editar Arquivo e confira se aparece um aviso.
Se for possível, use um arquivo de texto/planilha e mantenha o conteúdo dentro do limite informado.
Como confirmar: No modal Editar Arquivo, confira se o controle Usar como Base de Conhecimento fica disponível e salva normalmente.
Guia rápido do que existe em cada parte
- Comportamento da IA: Defina o básico: Nome da Base de Conhecimento, Nome do assistente virtual, Modelo da IA, estilo de respostas e como iniciar a conversa.
Também configure Personalidade e Missão da IA. - Definições de Áudio da IA (quando disponível): Controle quando a IA responde com áudio e escolha Modelo de voz.
Use Teste a voz da sua IA para ouvir um exemplo. - Dados da empresa: Preencha Nome da empresa, Site e Instagram.
Em criação nova, aparece uma mensagem explicando que o sistema pode acessar site/Instagram para ajudar. - Informações do seu negócio + Regras de atendimento: Escreva os textos principais.
Use:
- Ajustar com IA para pedir melhorias
- Ver comparativo antes de aplicar
- Assistente de criação para responder perguntas e montar o texto automaticamente - Conteúdos extras e controles: Opcionalmente, envie arquivos em Envio de arquivos e cadastre links em Páginas para base de conhecimento.
Confira a barra de Número máximo de caracteres para não estourar o limite.
No final, use Voltar, Testar e Salvar.