Ir para conteúdo principal

Adicione notas específicas de produto com o metacampo custom.olvio_knowledge

Adicione a um produto da Shopify notas em que a IA do Olvio confia mais do que na descrição dele, no chat da página desse produto.

Adicione notas específicas de produto com o metacampo custom.olvio_knowledge

Algumas coisas que os compradores perguntam sobre um produto não estão na descrição dele: como ele veste, com o que é compatível, por quanto tempo usá-lo. Você pode passar essas informações ao Olvio em um metacampo de produto com namespace e chave custom.olvio_knowledge. Na página desse produto, e para um produto mencionado antes na conversa, a IA do Olvio trata essa nota como a informação mais confiável sobre o produto. As notas de produto funcionam em todos os planos: Starter, Growth e Scale.

Como o Olvio usa a nota

  • Quando um comprador conversa no chat da página do produto, a IA lê a nota inteira e confia nela mais do que nas outras informações do produto, como a descrição.

  • A IA também lê a nota quando o produto aparece em um chat em outra página de produto: quando ela pesquisa no seu catálogo para um comprador ou quando o produto foi mencionado antes na conversa.

  • O Olvio Advisor (Growth e Scale) lê as notas dos produtos que avalia, para confirmar que um produto é adequado antes de recomendá-lo.

  • O Olvio também usa a nota ao escrever as perguntas sugeridas da página desse produto. Essas perguntas não são atualizadas na hora: o Olvio costuma escrever novas durante a noite depois de registrar sua alteração.

  • A IA é instruída a apresentar as informações como conhecimento próprio, sem dizer aos compradores que elas vêm de uma nota. O Olvio não exibe a nota na sua loja virtual.

  • A IA é instruída a escolher o idioma da resposta com base na sua loja virtual e nas mensagens do comprador, não no conteúdo dos produtos. Assim, você pode escrever a nota uma única vez, no idioma padrão da sua loja.

Criar a definição do metacampo

O Olvio não cria esse campo para você. Você cria a definição dele uma única vez no admin da Shopify e depois o preenche em cada produto que precisa de uma nota.

  1. No admin da Shopify, acesse Produtos e abra qualquer produto.

  2. Na seção Metacampos, clique em Adicionar definição.

  3. Em Nome, digite um nome fácil de reconhecer, como Conhecimento Olvio.

  4. Confira se Namespace e chave mostra exatamente custom.olvio_knowledge. A Shopify preenche esse valor a partir do nome; edite-o se estiver diferente.

  5. Clique em Selecionar tipo e escolha Rich text.

  6. Clique em Salvar.

O Olvio só lê um campo cujo namespace e chave sejam exatamente custom.olvio_knowledge. Use o tipo Rich text. Se sua loja já tem esse campo como Texto de linha única ou Texto de várias linhas, o Olvio também o lê.

Escrever a nota de um produto

  1. No admin da Shopify, abra o produto.

  2. Na seção Metacampos, clique no campo que você criou. Se não o encontrar, clique em Ver tudo.

  3. Digite sua nota.

  4. Clique em Salvar.

Quando o chat de uma página de produto diz a um comprador que não tem um detalhe do produto, a pergunta costuma aparecer na aba Sem resposta da página Conversas, abaixo do produto a que ela se refere. O botão Adicionar info ao lado do produto abre esse produto no admin da Shopify em uma nova aba, para que você adicione a informação que falta à nota dele. Veja Encontre e corrija lacunas de conhecimento na aba Sem resposta.

Para remover uma nota, esvazie o campo e salve o produto. O Olvio deixa de usar a nota assim que registra a alteração.

O que escrever

  • Informações que os compradores perguntam e que não estão na descrição, por exemplo dicas de tamanho e caimento, compatibilidade com outros produtos, materiais ou ingredientes, por quanto tempo usar o produto ou instruções de cuidado.

  • Coloque as informações mais importantes primeiro. Quando o produto aparece fora da própria página, no Olvio Advisor ou quando o Olvio escreve perguntas sugeridas, pode ser que só o início de uma nota longa seja usado.

  • Escreva cada informação como uma frase completa, como Veste pequeno: recomendamos um tamanho acima. Em um campo Rich text, o Olvio lê apenas as palavras: títulos, negrito, listas e quebras de linha não são mantidos, e os endereços dos links não são lidos.

  • Mantenha a nota atualizada. Como a IA confia nela mais do que na descrição, uma nota desatualizada leva a respostas erradas.

O Olvio já lê as políticas e as páginas da sua loja, como suas políticas de frete e de devolução (veja Como o Olvio lê as páginas, os posts do blog e as políticas da sua loja). Para outras informações que valem para muitos produtos, como uma tabela de tamanhos de uma linha inteira, adicione um arquivo de conhecimento em Configuração de IA. Veja Adicione arquivos e páginas web à base de conhecimento do Olvio.

Quando suas alterações chegam ao chat

O Olvio sincroniza automaticamente as edições de produtos. Para confirmar que o chat usa sua nova nota, abra a página do produto em uma nova janela anônima (privada) do navegador e faça sua pergunta nela. Em uma aba do navegador em que você já conversou sobre esse produto, a conversa pode voltar depois que você recarrega a página, e as respostas anteriores podem repetir a nota antiga.

Se o chat ainda usar a nota antiga alguns minutos depois de você salvar o produto na Shopify, faça uma ressincronização: no admin da Shopify, abra Olvio e, na página Painel, clique em Ressincronizar. Uma ressincronização lê todos os produtos novamente, inclusive a nota de cada um.

A ressincronização é executada em segundo plano, e o chat pode continuar usando a nota antiga até ela terminar. Aguarde até que o Painel não mostre mais Sincronização do catálogo em andamento e teste o chat de novo em uma nova janela anônima. Se ele mostrar Falha na sincronização do catálogo, clique em Tentar sincronizar novamente.

Uma ressincronização conta como uma alteração em cada produto, então na noite seguinte o Olvio pode escrever novas perguntas sugeridas para muitos dos seus produtos, o que usa sua chave de API da Anthropic. Veja O que usa sua chave de API da Anthropic e o que não usa.

Você pode fazer uma ressincronização uma vez por dia. Se Ressincronizar estiver esmaecido, passe o mouse sobre ele para ver quando estará disponível de novo. Veja Ressincronize seu catálogo de produtos.

Isto respondeu à sua pergunta?