O Olvio dá respostas erradas ou genéricas
A IA do Olvio responde aos compradores com base no conteúdo da sua própria loja: seus produtos e coleções, as páginas, os posts do blog e as políticas da loja, e o que você adiciona em Configuração de IA e nas notas de produto. Quando uma resposta está errada, vaga ou genérica, a causa geralmente é uma informação que falta, que está desatualizada ou que a IA tem dificuldade de encontrar. Este artigo ajuda você a encontrar a causa e corrigi-la.
Comece pela conversa
Antes de mudar qualquer coisa, leia a troca que deu errado:
Abra Conversas no menu do app Olvio.
Encontre o chat na lista. Para filtrar, pesquise palavras da primeira pergunta do comprador ou o título do produto no campo Pesquisar perguntas ou produto. A lista e a pesquisa abrangem suas conversas mais recentes, então procure o chat logo depois que ele acontecer.
Clique na linha para ler a transcrição e compare a pergunta do comprador com a resposta do Olvio. Em um chat longo, o Olvio guarda apenas as mensagens mais recentes; por isso, a transcrição começa no meio da conversa e a pesquisa só encontra a pergunta mais antiga do comprador que ainda está guardada. Veja Leia sua lista de conversas e as transcrições.
Depois, abra a aba Sem resposta no topo da página. Ela lista, agrupadas por produto, as perguntas sobre produtos que a IA não conseguiu responder no chat das suas páginas de produto. Veja Encontre e corrija lacunas de conhecimento na aba Sem resposta.
Relacione o que você vê a uma correção:
A IA diz que um detalhe do produto não está disponível: adicione o detalhe ao produto. Veja Adicione os detalhes de produto que faltam abaixo.
A IA erra uma informação sobre um produto: corrija a descrição, os metacampos ou a nota do produto, ou exclua um arquivo de conhecimento desatualizado.
A IA não sabe responder sobre entrega, devoluções ou outros temas que valem para toda a loja: confira as páginas e as políticas da loja ou adicione um arquivo de conhecimento.
A IA não encontra ou não recomenda um produto que você vende: confira o status do produto e a sincronização do catálogo.
As respostas estão corretas, mas genéricas sobre a sua marca: amplie sua Descrição do negócio.
O tom, o tamanho ou as recomendações não agradam você: ajuste suas Regras de conversa.
A IA responde no idioma errado: veja O widget ou a IA usa o idioma errado.
Adicione os detalhes de produto que faltam
Quando a IA diz a um comprador que um detalhe do produto não está disponível, ou o encaminha ao seu suporte para uma informação sobre um produto, a pergunta costuma aparecer na aba Sem resposta. Essa é a lista mais direta do que adicionar.
Em Conversas, abra a aba Sem resposta.
No cartão do produto, clique em Adicionar info. O produto abre no admin da Shopify.
Adicione a informação que falta ao produto, por exemplo na descrição, em um metacampo de produto ou na nota
custom.olvio_knowledge.Clique em Salvar na Shopify.
De volta à aba Sem resposta, clique no botão de marca de seleção (Marcar como concluído) na linha da pergunta. A pergunta é removida da lista.
De cada produto, a IA lê o título, o tipo, o fornecedor, as tags, as coleções, o preço, a descrição, as opções e as variantes, incluindo se cada variante está em estoque, e os metacampos. Lembre-se:
Descrições e valores de metacampos muito longos são encurtados, então coloque no início os detalhes sobre os quais os compradores mais perguntam.
A IA não lê metacampos de apps de avaliações nem metacampos que apontam para outra coisa, como um arquivo, outro produto ou uma página.
A IA não vê o que aparece nas imagens dos seus produtos, então escreva em texto tudo o que os compradores precisam saber.
O Olvio sincroniza as edições de produtos automaticamente. Se o chat ainda der a resposta antiga alguns minutos depois de você salvar, principalmente se você alterou só um metacampo ou a nota do produto, clique em Ressincronizar no Painel (clique em Olvio no menu do app). Você pode ressincronizar uma vez por dia. Se Ressincronizar estiver desativado, passe o cursor sobre ele para ver quando estará disponível de novo. Veja Ressincronize seu catálogo de produtos, Encontre e corrija lacunas de conhecimento na aba Sem resposta e Que fontes o Olvio lê.
Adicione notas para um único produto
Algumas informações que os compradores perguntam não estão na descrição do produto: como ele veste, com o que é compatível, por quanto tempo usá-lo. Escreva essas informações no metacampo custom.olvio_knowledge do produto. Use o tipo Rich text; tipos de texto simples também funcionam.
O Olvio não cria esse metacampo para você. Crie a definição uma única vez no admin da Shopify: abra qualquer produto, clique em Adicionar definição na seção Metacampos, digite um Nome como Conhecimento Olvio, confira se Namespace e chave mostra exatamente custom.olvio_knowledge (edite se não mostrar), clique em Selecionar tipo, escolha Rich text e depois clique em Salvar. O campo passa a ficar disponível em todos os produtos.
Para escrever a nota de um produto, abra o produto, clique no campo na seção Metacampos (clique em Ver tudo se não o encontrar), digite a nota e clique em Salvar.
A IA confia nessa nota mais do que nas outras informações do produto, inclusive na descrição. Por isso, uma nota desatualizada gera respostas erradas, mesmo quando a descrição está correta: mantenha as notas atualizadas e esvazie o campo quando uma nota não se aplicar mais. Veja Adicione notas específicas de produto com o metacampo custom.olvio_knowledge.
Adicione informações que valem para toda a loja
O Olvio lê as páginas, os posts do blog e as políticas publicados na sua loja virtual, como as páginas Sobre ou de perguntas frequentes e as políticas de reembolso e de frete. No chat das suas páginas de produto, quando a pergunta de um comprador corresponde a algo que você escreveu ali, o Olvio passa esse trecho para a IA. Não é preciso configurar nada. Lembre-se:
Depois que você escolhe um plano, o Olvio lê suas páginas, posts do blog e políticas pela primeira vez na verificação diária seguinte. Em uma loja com muitas páginas, essa primeira leitura pode levar alguns dias. Uma página ou um post do blog que você publicar depois costuma ser lido na verificação diária seguinte.
O Olvio lê sua loja no idioma padrão dela.
Uma edição que você salva em uma página ou em um post do blog na Shopify costuma ser captada na verificação diária seguinte do Olvio. Uma edição em um texto que fica no seu tema, como uma seção adicionada no editor de temas, pode levar até cerca de um mês, às vezes um pouco mais, e uma edição em uma política, cerca de uma semana ou um pouco mais. Ressincronizar não lê suas páginas de novo.
O Olvio Advisor (planos Growth e Scale) não usa suas páginas, posts do blog nem políticas.
Para informações que não estão publicadas na sua loja virtual, para uma mudança que não pode esperar ou para conteúdo que o Olvio Advisor deve usar, abra Configuração de IA:
Arquivos de conhecimento: envie documentos como um guia de tamanhos, instruções de cuidado, termos de garantia ou perguntas frequentes criadas a partir dos seus tickets de suporte. Os formatos aceitos são PDF, DOCX, TXT, MD e CSV, até 50 MB. Salve planilhas como CSV.
Páginas web externas: adicione páginas web públicas pelo endereço, por exemplo perguntas frequentes ou um guia em outro site. O Olvio as atualiza automaticamente, normalmente toda noite.
Seu plano define quantos arquivos de conhecimento e quantas páginas web externas você pode adicionar. Um arquivo ou uma página novos ou excluídos chegam ao chat em poucos minutos, geralmente a partir da próxima mensagem que um comprador enviar. O Olvio dá prioridade aos arquivos e páginas adicionados mais recentemente; por isso, se você adicionar muito conteúdo, entradas mais antigas podem não ser usadas. Exclua documentos desatualizados: um arquivo que contradiz suas páginas de produto pode causar respostas erradas. Veja Adicione arquivos e páginas web à base de conhecimento do Olvio.
Se um produto não for encontrado ou recomendado
Quando um comprador pede outro produto, a IA só recomenda produtos com o status Ativo na Shopify. Produtos em rascunho e arquivados nunca são recomendados.
Confira também o banner do catálogo no Painel (clique em Olvio no menu do app):
Alguns produtos não estão totalmente indexados: alguns produtos ativos ainda não podem ser pesquisados pelo Olvio. Clique em Ressincronizar.
Sincronização do catálogo em andamento: uma sincronização está em execução. Espere terminar e teste de novo.
Falha na sincronização do catálogo: clique em Tentar sincronizar novamente.
Descreva seu negócio
Se as respostas estão corretas, mas poderiam vir de qualquer loja, a IA precisa de mais contexto sobre a sua marca. Em Configuração de IA, preencha a Descrição do negócio, com até 10.000 caracteres.
Uma descrição fraca: Vendemos roupas online.
Uma descrição mais forte: A Northfield Outfitters fabrica jaquetas e calças de trilha impermeáveis para climas frios e úmidos. Cada jaqueta usa uma membrana reciclada de três camadas e costuras seladas, e vem com garantia vitalícia de reparo. A maioria dos nossos clientes faz trilhas na Escócia e na Escandinávia. Enviamos para toda a Europa em até 3 dias úteis e aceitamos devoluções em até 30 dias.
Explique o que você vende e para quem, o que diferencia seus produtos e quais são suas principais políticas. Em Categorias / Palavras-chave, adicione até 30 palavras-chave, com até 80 caracteres cada, sobre suas áreas de especialidade.
Clique em Salvar na barra de salvamento. A mensagem Configuração salva confirma, e o chat passa a usar a mudança em cerca de um minuto. Veja Configure sua Configuração de IA.
Ajuste suas regras de conversa
A seção Regras de conversa da Configuração de IA tem duas listas, Fazer e Evitar. Cada lista comporta até 20 regras com até 500 caracteres cada. As regras são a forma mais precisa de mudar como a IA se comporta em uma situação específica. Como a seção recomenda, escreva as regras de forma positiva sempre que possível. Por exemplo:
Se a IA sugere uma variante fora de estoque, adicione em Fazer: Quando o tamanho ou a cor que o comprador quer estiver fora de estoque, sugira uma variante parecida que esteja em estoque.
Se a IA recomenda produtos demais, adicione em Fazer: Recomende no máximo dois produtos em uma única resposta.
Se a IA entra em um tema do qual você precisa ficar longe, adicione em Evitar: Nunca faça alegações médicas ou terapêuticas sobre nossos produtos.
Suas regras têm prioridade sobre o tom, o tamanho e a formatação padrão do Olvio. Elas não mudam o idioma em que a IA responde nas suas páginas de produto e não fazem a IA revelar a sua configuração.
As regras mudam como a IA responde, não o que ela sabe. Se uma informação falta ou está errada, adicione ou corrija a informação em vez de escrever uma regra. Veja Escreva regras de conversa eficazes.
Se a IA afirmar algo que não está nos seus dados
As instruções integradas do Olvio dizem à IA para afirmar apenas fatos que estão nos seus dados de produto e no conteúdo da sua loja. Quando falta um detalhe, principalmente um número como uma duração, uma quantidade ou uma porcentagem, a IA é orientada a dizer que a informação não foi especificada em vez de adivinhar. Mesmo assim, modelos de IA podem errar de vez em quando.
Quando isso acontecer:
Verifique se a informação errada vem do seu próprio conteúdo, como um arquivo de conhecimento antigo, uma nota de produto desatualizada ou uma página que contradiz a descrição do produto, e corrija.
Se a informação estiver faltando, adicione-a ao produto ou aos seus arquivos de conhecimento.
Se o problema continuar voltando em um tema específico, adicione uma regra para essa situação.
Algumas respostas são esperadas, e não erradas: a IA não consegue consultar um pedido nem o status de entrega dele, por isso encaminha os compradores ao seu suporte nessas perguntas.
Experimente outro modelo Claude
Se as informações dos seus produtos e a Configuração de IA estão completas e as respostas a perguntas mais complexas, como comparações detalhadas de produtos, ainda deixam a desejar, experimente um modelo mais capaz:
Abra Chave de API no menu do app Olvio.
No menu Modelo Claude, escolha Claude Sonnet 5 — equilíbrio entre qualidade e custo ou Claude Opus 5 — melhor qualidade, custo mais alto. O padrão é Claude Haiku 4.5 — o mais rápido, menor custo (recomendado).
Clique em Salvar na barra de salvamento. O Olvio verifica se a sua conta da Anthropic pode usar o modelo e depois mostra Configurações salvas.
O modelo selecionado é usado em todos os chats, sugestões e turnos do Advisor, e a Anthropic cobra cada solicitação pelo preço desse modelo. Veja a página de preços da Anthropic e Escolha seu modelo Claude.
Confira a correção
Salve a mudança na Shopify ou em Configuração de IA e espere alguns minutos.
Abra a página do produto em uma nova janela anônima. O widget lembra um chat aberto na mesma aba do navegador, e uma conversa nova mostra a resposta que um novo comprador receberia.
Faça a mesma pergunta de novo.
Se a resposta ainda usar informações que você alterou em um produto, veja a observação sobre ressincronização em Adicione os detalhes de produto que faltam acima.
Edições nas páginas, nos posts do blog e nas políticas da loja demoram mais para chegar ao chat (veja Adicione informações que valem para toda a loja acima). Para testar uma mudança antes, adicione-a em Configuração de IA e escreva de forma clara, porque o chat ainda pode ver o texto antigo até o Olvio ler a página de novo.