Criar/Editar Base de Conhecimento
Configura o comportamento da IA e preenche as informações que ela usa para responder: nome, estilo, dados da empresa e instruções. Também permite adicionar conteúdos opcionais como voz/áudio, arquivos, sites/páginas e funções.
Para que serve
Use esta configuração para montar uma Base de Conhecimento (o “centro de inteligência” da IA).
Preencha o que a IA precisa saber e como ela deve agir no atendimento.
A configuração funciona por etapas (tipo assistente), com botões como Próximo Passo, Concluir, Salvar e Testar.
Onde encontrar
Caminho no menu: Listar Base de Conhecimento > Nova base
Link interno: /admin/baseConhecimento/novo
Notas de plano: Algumas opções aparecem como Opcional, como Voz e áudio e Sites e páginas (podem depender do plano).
Resumo rápido
- Preencha Nome da Base de Conhecimento e defina o Comportamento da IA.
- Preencha Dados da empresa (ex.: Nome da empresa, Site e Instagram).
- Escreva as Instruções para a IA no campo grande.
- Quando aparecer, use Ajustar com IA e confira o Ver comparativo antes de Aplicar alterações.
- Finalize em Concluir ou salve em Salvar.
- Use Testar para experimentar a base.
Resultado esperado: Base de Conhecimento fica salva e pronta para ser testada e usada no atendimento.
Tour guiado (o que existe aqui)
- Comportamento da IA (Etapa 1): Defina itens como Nome da Base de Conhecimento, Nome do assistente virtual e opções de comportamento.
Quando disponível, selecione Modelo da IA (ex.: Assistente de criação interno (Recomendado) ou Assistente externo GPT (Avançado)) e preencha o que for pedido. - Dados da empresa (Etapa 2): Preencha Nome da empresa.
Campos como Site (Opcional) e Instagram (Opcional) ajudam na geração/organização das informações.
Ao criar uma base nova, aparece a mensagem: “Vamos acessar seu Instagram e site para obter alguns dados que nos ajudarão nesse processo.” - Instruções para a IA (Etapa 3): Escreva o conteúdo principal no campo com o placeholder “Insira as informações que você acha necessárias…”.
Quando disponível, use:
- Ajustar com IA (gera sugestão)
- Ver comparativo (abre uma comparação)
- Aplicar alterações (usa o texto sugerido)
Também pode aparecer Histórico de alterações com o botão Ver histórico. - Configurações complementares (Opcional): Quando estiver editando uma base, pode aparecer o bloco Configurações complementares.
Dentro dele podem existir recursos como Voz e áudio, Arquivos da base, Sites e páginas, Funções e integrações API e Fluxograma de atendimento. - Rodapé de ações: Use:
- Voltar (ou Retomar primeiros passos, quando aparecer)
- Testar
- Salvar (ou Salvar e testar, quando aparecer)
- Revisão inteligente (mostra uma análise com nota/estado)
Campos principais
Nome da Base de Conhecimento
edit_notetextoDescrição: Digite um nome para identificar esta base.
Use algo que ajude a reconhecer o canal ou o objetivo (ex.: uma base para WhatsApp, outra para Instagram).
Regras/validações: Placeholder: “Ex: WhatsApp Trio Produtora”.
Exemplos: - WhatsApp Trio Produtora
- Suporte - Loja Centro
Nome do assistente virtual
edit_notetextoDescrição: Digite o nome que a IA usa como “nome de assistente”.
Esse nome também aparece nos exemplos de mensagens.
Regras/validações: Placeholder: “Ex: Isabella”.
Exemplos: - Isabella
- Atendimento Virtual
Exibir o nome da assistente no início de cada mensagem
edit_notecheckboxValor padrão: marcado
Descrição: Marque para começar as mensagens mostrando o nome do assistente.
Desmarque se preferir mensagens sem assinatura no começo.
Exemplos: - Marcado: IA começa com o nome
- Desmarcado: IA não mostra o nome no início
Modelo da IA
edit_noteseleção (rádio)Valor padrão: Assistente de criação interno ( Recomendado )
Descrição: Selecione qual modelo usar:
- Assistente de criação interno ( Recomendado )
- Assistente externo GPT ( Avançado )
Ao escolher o modo externo, aparece um texto explicando: “Utilize esta opção se você já possui um assistente criado na sua conta OpenAI (GPT)”.
Exemplos: - Assistente de criação interno ( Recomendado )
- Assistente externo GPT ( Avançado )
Assistant ID
edit_notetextoDescrição: Preencha este campo quando o Modelo da IA estiver em Assistente externo GPT ( Avançado ).
Depois, use o botão Testar assistente para conferir.
Regras/validações: Placeholder: “Ex: asst_123456”.
O botão Testar assistente só habilita quando Assistant ID e OpenAI API Key estiverem preenchidos.
Exemplos: - asst_123456
- asst_987654
OpenAI API Key
edit_notesenhaDescrição: Preencha este campo quando usar um modo externo.
Use o botão Testar assistente para validar.
Regras/validações: Placeholder: “sk-...”.
Exemplos: - sk-...
- sk-...
Modo de se comunicar
edit_noteseleçãoValor padrão: Respostas Diretas e Objetivas
Descrição: Escolha o jeito de escrever as respostas.
Use curto quando quiser mensagens mais diretas.
Regras/validações: Opções:
- Respostas Completas e nos Mínimos Detalhes
- Respostas Diretas e Objetivas
- Respostas extremamente Diretas e Curtas
Exemplos: - Respostas Diretas e Objetivas
- Respostas extremamente Diretas e Curtas
Como agir caso não saiba a resposta
edit_noteseleçãoDescrição: Escolha o que a IA faz quando não encontra a resposta.
Após selecionar, aparece um bloco com “Exemplo:” do que a IA fala.
Regras/validações: Opções visíveis:
- Encaminhamento para atendimento humano
- Admitir que não sabe a resposta e informar que entraremos em contato
- Oferecer ajuda alternativa
- Fornecer informações de contato para suporte adicional
- Pedido de mais detalhes para melhor entendimento
Exemplos: - Encaminhamento para atendimento humano
- Oferecer ajuda alternativa
Quando enviar para o atendimento humano
edit_notetexto (textarea)Descrição: Este campo aparece quando a opção escolhida for Encaminhamento para atendimento humano.
Escreva situações em que a conversa deve ir para uma pessoa.
Regras/validações: Limite visível: maxlength="300".
Exemplos: - Caso o cliente peça para falar com um atendente.
- Caso tenha reclamação ou queira negociar valores.
Mensagem enviada ao cliente caso seja direcionado para o atendimento humano
edit_notetexto (textarea)Descrição: Este campo aparece quando a opção for Encaminhamento para atendimento humano.
Escreva a mensagem que o cliente recebe quando ocorrer a transferência.
Existe a instrução: “Deixe em branco para não notificar o cliente sobre a transferência”.
Regras/validações: Limite visível: maxlength="300".
Exemplos: - Vou encaminhar sua solicitação para um especialista e retorno o mais breve possível.
- (em branco) para não avisar
Nome da empresa
edit_notetextoDescrição: Digite o nome do negócio.
Isso ajuda a base a ficar mais coerente e com “cara” de empresa.
Regras/validações: Placeholder: “Ex: Trio Produtora”.
Exemplos: - Trio Produtora
- Padaria Pão Quente
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
edit_notetexto (textarea)Descrição: Escreva as informações mais importantes do negócio.
Quando disponível, use Ajustar com IA e confira Ver comparativo antes de Aplicar alterações.
Regras/validações: Placeholder completo: “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: - Produtos/serviços, diferenciais, horários e formas de contato.
- Como responder dúvidas comuns e como orientar o cliente.
Regras e comportamentos importantes
- Ao tentar avançar/salvar sem preencher o que for necessário, aparece: “Favor preencher os campos obrigatórios” (campos ficam destacados).
- No campo Instagram (Opcional), evite espaços e caracteres diferentes de letras, números, ponto e underline; o exemplo exibido é “Ex: @TrioProdutora”.
- No campo Site (Opcional), use um formato válido (exemplo exibido: “Ex: www.trioprodutora.com”).
- Em Voz e áudio, a própria dica diz: “Deixe em branco para desativar o envio de audio pela IA” no campo Quando responder por áudio.
- Em Ajustar com IA, a instrução diz: “A IA sugere mudanças e mostra um comparativo antes de aplicar.” Use Ver comparativo e só depois Aplicar alterações.
- Em Arquivos da base, existe aviso: “Arquivo acima do limite recomendado” e o texto: “O conteúdo excede 100.000 caracteres. Recomendamos dividi-lo em arquivos menores.”
- Em Arquivos da base, a opção “Usar como Base de Conhecimento” pode ficar indisponível, com o aviso: “Esta opção só está disponível para planilhas ou arquivos de texto.”
Como criar ou editar e salvar
Preencher a identificação da base
Preencha Nome da Base de Conhecimento.
Preencha Nome do assistente virtual e, se fizer sentido, marque/desmarque Exibir o nome da assistente no início de cada mensagem.
Escolher o Modelo da IA (quando aparecer)
Em Modelo da IA, selecione uma opção.
Se selecionar Assistente externo GPT ( Avançado ), preencha Assistant ID e OpenAI API Key e clique em Testar assistente.
Definir estilo e comportamento
Escolha o Modo de se comunicar.
Em Como agir caso não saiba a resposta, selecione uma opção e leia o Exemplo: que aparece.
Se escolher Encaminhamento para atendimento humano, preencha:
- Quando enviar para o atendimento humano
- Mensagem enviada ao cliente caso seja direcionado para o atendimento humano (ou deixe em branco, se preferir)
Avançar para os dados do negócio
Clique em Próximo Passo.
Se aparecer “Favor preencher os campos obrigatórios”, volte e preencha os campos destacados.
Preencher os dados da empresa
Preencha Nome da empresa.
Se tiver, preencha Site (Opcional) e Instagram (Opcional).
Escrever as instruções principais para a IA
No campo grande (com o placeholder “Insira as informações que você acha necessárias…”), escreva o que a IA precisa saber.
Inclua detalhes úteis do negócio e o jeito certo de atender.
Usar o ajuste por IA (quando disponível)
Escreva um pedido no campo de ajuste (ex.: “Deixe mais direto e inclua nosso horário de atendimento”).
Clique em Ajustar com IA.
Quando aparecer, use Ver comparativo e depois Aplicar alterações.
Salvar e testar
Clique em Concluir (na criação) ou Salvar (na edição).
Para experimentar, clique em Testar.
Se aparecer Salvar e testar, use essa opção para já abrir o teste depois de salvar.
Problemas comuns e como resolver
Causa provável: Algum campo necessário ficou em branco.
Como corrigir: Preencha os campos que estiverem destacados.
Depois, clique novamente em Próximo Passo, Concluir ou Salvar.
Como confirmar: A mensagem não aparece mais e a etapa seguinte abre normalmente.
Causa provável: O campo do teste ficou vazio.
Como corrigir: Digite um texto em Teste a voz da sua IA e clique no botão de play.
Como confirmar: O áudio começa a tocar e o carregamento do play para.
Causa provável: Limite diário de áudios foi atingido.
Como corrigir: Use o link Clique aqui que aparece na mensagem para aumentar o plano.
Se não quiser áudio, deixe Quando responder por áudio em branco (a própria dica diz que isso desativa).
Como confirmar: O aviso para de aparecer (quando o limite deixar de bloquear) e a configuração fica estável.
Causa provável: Arquivo não é aceito para virar conhecimento (ex.: não é texto/planilha) ou a opção está desativada.
Como corrigir: Leia o aviso mostrado no editor do arquivo.
Quando aparecer “Esta opção só está disponível para planilhas ou arquivos de texto.”, troque por um arquivo desse tipo.
Quando aparecer o aviso de 100.000 caracteres, divida o conteúdo em arquivos menores.
Como confirmar: A opção Usar como Base de Conhecimento fica habilitada e salva sem erro.
Causa provável: Faltou preencher Assistant ID ou OpenAI API Key.
Como corrigir: Preencha Assistant ID e OpenAI API Key.
Depois, clique em Testar assistente.
Como confirmar: O botão habilita e aparece um retorno do teste (ou um aviso/resultado).
O que muda quando configura
Alterações no sistema: O conteúdo preenchido em Instruções para a IA passa a ser usado como base para as respostas.
Ao usar Ajustar com IA, o sistema gera uma sugestão e mostra um comparativo antes de aplicar.
Quando estiver editando, o bloco Uso da base de conhecimento mostra a quantidade utilizada do limite total de caracteres.
- Funções e integrações API
Logs: Não existe texto visível indicando onde ver registros (logs). Para confirmar mudanças, use Testar e observe se a IA responde do jeito esperado.