A página Configuração de IA é onde você apresenta sua loja ao Olvio: o que você vende, o que a IA precisa saber e como ela deve falar com os compradores. O Olvio usa essas configurações em cada chat da página de produto e, nos planos Growth e Scale, nas conversas do Olvio Advisor. As perguntas sugeridas não as usam. O Olvio funciona sem elas, mas as respostas serão mais genéricas.

Abra Configuração de IA no menu do app Olvio. A página está disponível em todos os planos e tem cinco seções: Descrição do negócio, Categorias / Palavras-chave, Arquivos de conhecimento, Páginas web externas e Regras de conversa.

Descreva seu negócio no campo Descrição, com até 10.000 caracteres. Um contador no canto inferior direito do campo, como 1250/10000, mostra quantos caracteres você já usou. Cubra o básico:

Escreva como se estivesse apresentando a loja a um novo vendedor no primeiro dia de trabalho. Dois parágrafos de contexto claro ajudam mais a IA do que uma lista de frases genéricas. O texto de exemplo do campo mostra uma forma de começar: Você é o assistente virtual da [marca], especializado em…

O Olvio também lê automaticamente as páginas, os posts do blog e as políticas da sua loja. Ele só leva um trecho para um chat da página de produto quando esse trecho corresponde à pergunta do comprador, e o Olvio Advisor não os usa. Incluir suas principais políticas na descrição mantém essas informações à vista da IA em todas as conversas. Nos planos Growth e Scale, você também pode adicionar em Páginas web externas uma página da loja de que o Advisor precise. Adicione apenas as páginas de que o Advisor precisa: cada uma conta para o seu limite de páginas web, também é usada nos chats da página de produto e pode tirar arquivos e páginas mais antigos do conjunto que a IA usa. Veja Como o Olvio lê as páginas, os posts do blog e as políticas da sua loja.

As palavras-chave descrevem as áreas de especialização da sua IA. Para adicionar uma, digite-a em Adicionar uma palavra-chave e clique em Adicionar. Cada palavra-chave aparece como uma tag; clique no × de uma tag para removê-la. Você pode adicionar até 30 palavras-chave com até 80 caracteres cada, e uma palavra-chave escrita exatamente igual a outra que já está na lista não é adicionada de novo. Quando a lista tem 30 palavras-chave, Adicionar limpa o campo sem adicionar nada, então remova uma palavra-chave primeiro.

Exemplos para uma loja de beleza: Limpadores, Séruns, Protetores solares, Cuidados com o corpo. Para uma loja de snowboard: All-mountain, Freestyle, Powder, Botas, Fixações.

O Olvio passa suas palavras-chave para a IA como as áreas de especialização da sua loja. Elas não substituem seu catálogo: o que a IA sabe sobre seus produtos vem do catálogo que o Olvio sincroniza a partir da Shopify. Veja Como o Olvio mantém seu catálogo sincronizado.

Adicione documentos que a IA deve usar para responder com mais precisão, como uma FAQ, fichas técnicas ou guias. Os formatos aceitos são PDF, DOCX, TXT, MD e CSV, com até 50 MB por arquivo. Para planilhas, salve primeiro como CSV.

Para adicionar um arquivo:

O Olvio salva apenas o texto exibido na janela de revisão, não o arquivo original. Cada arquivo pode ter até 900 KB de texto, e o contador abaixo do texto mostra o tamanho atual. Se um documento for maior, o Olvio mantém os primeiros 900 KB e avisa você. Se suas edições fizerem o texto passar de 900 KB, o arquivo não é salvo, aparece uma mensagem que começa com File content too large e você precisa adicionar o arquivo de novo. Em uma conversa, o Olvio só consegue usar parte de um documento muito longo, então mantenha cada arquivo focado no que os compradores realmente perguntam.

Os arquivos são adicionados um de cada vez. Se você soltar ou selecionar vários, o Olvio abre o primeiro e mostra uma mensagem; adicione os outros depois de salvar ou cancelar o primeiro.

Não é possível ver nem editar o texto de um arquivo depois de salvá-lo. Para atualizar um documento, exclua-o pelo ícone de lixeira ao lado do nome e envie a nova versão. O arquivo é excluído assim que você clica no ícone, sem etapa de confirmação.

Adicione páginas web públicas que a IA deve ler, como uma FAQ ou um guia hospedado em outro site. O Olvio lê cada página quando você a adiciona e depois volta a verificá-la automaticamente, normalmente todas as noites.

Se a página não puder ser lida, nada é adicionado e você vê Não foi possível recuperar esta página: seguido do motivo. O Olvio não executa os scripts das páginas. Uma página que monta o conteúdo com JavaScript pode falhar com a mensagem Não foi possível recuperar esta página: No readable text found on the page ou ser adicionada com apenas parte do texto, como os menus. Sites que bloqueiam visitantes automatizados podem falhar com um motivo como HTTP 403. Páginas com mais de 3 MB são recusadas com o motivo Page too large (max 3 MB). O endereço precisa ser um endereço https:// público com nome de domínio, sem endereço IP nem número de porta (como :8080); caso contrário, você vê URL inválida. Use um endereço https:// público completo. O Olvio lê apenas páginas web e texto simples: para adicionar um PDF, envie-o em Arquivos de conhecimento. O mesmo endereço não pode ser adicionado duas vezes.

Cada página da lista mostra um selo. Recuperada significa que o Olvio leu a página, e a linha abaixo mostra quando ela foi lida pela última vez. Erro significa que a última tentativa falhou, e a linha abaixo mostra quando e por quê; a IA continua usando o conteúdo que o Olvio leu antes.

Para verificar agora se uma página mudou, clique no ícone de atualizar dela. Você vê Página atualizada se o conteúdo mudou, ou Já está atualizada se não mudou. Para remover uma página, clique no ícone de lixeira dela.

Seu plano define quantos arquivos de conhecimento e quantas páginas web você pode adicionar. Os dois limites são separados: páginas web não contam para o seu limite de arquivos, e arquivos não contam para o seu limite de páginas web.

Um contador abaixo da descrição de cada seção, como 3/10, mostra em que ponto você está e fica vermelho quando você atinge o limite. No limite, exclua um item antes de adicionar outro. No Starter ou no Growth, você também pode fazer upgrade para um plano com limite maior. Confira o contador de arquivos antes de adicionar um arquivo: no limite, a janela de revisão abre mesmo assim, mas quando você clica em Salvar na base de conhecimento o arquivo não é salvo, aparece uma mensagem de erro e as edições feitas na janela são perdidas. Veja Faça upgrade ou downgrade do seu plano.

Se você mudar para um plano com limite menor, os arquivos e páginas que já adicionou continuam lá, e um contador pode mostrar mais do que o limite, como 50/30. Você não pode adicionar mais nada a essa seção até que ela fique abaixo do novo limite.

Para notas sobre um produto específico, use o metacampo custom.olvio_knowledge desse produto na Shopify. Veja Adicione notas específicas de produto com o metacampo custom.olvio_knowledge. Para mais detalhes sobre arquivos e páginas, veja Adicione arquivos e páginas web à base de conhecimento do Olvio.

As regras dizem à IA o que fazer e o que evitar em todas as conversas. Elas ficam em duas listas, Fazer e Evitar:

Como a própria página sugere, formule as regras de forma positiva sempre que possível: a IA as segue melhor quando descrevem o que fazer em vez do que evitar. Para mais dicas, veja Escreva regras de conversa eficazes.

O tom padrão da IA é acolhedor e tranquilizador, mas direto. A IA é instruída a dar prioridade às suas regras sobre as instruções internas do Olvio relativas a tom, tamanho e formatação, então use-as para ajustar o estilo. No chat da página de produto, a IA é instruída a não deixar que suas regras mudem o idioma em que ela responde. A IA é instruída a aplicar suas regras sem contar aos compradores sobre elas.

A IA é instruída a não revelar nem citar sua configuração (descrição do negócio, palavras-chave ou regras) quando um comprador pergunta sobre ela; ela é instruída a recusar em uma frase e voltar a ajudar. Mesmo assim, ela usa o que sua descrição do negócio diz para responder às perguntas, então também não coloque ali informações internas ou confidenciais.

Descrição do negócio, Categorias / Palavras-chave e Regras de conversa são salvas juntas. Assim que você altera uma dessas seções, a barra de salvamento da Shopify aparece:

Arquivos de conhecimento e páginas web externas não usam a barra de salvamento: cada upload, adição, atualização ou exclusão é salvo na hora.

As alterações chegam às conversas com compradores em poucos minutos, normalmente a partir da próxima mensagem que um comprador enviar. Depois que uma descrição do negócio é salva, a etapa Personalize sua IA do guia de configuração no Painel (clique em Olvio no menu do app) é marcada como concluída. Veja Seu guia de configuração: prepare o Olvio para seu primeiro cliente.

Sua descrição do negócio, palavras-chave e regras, além dos arquivos e páginas web que o Olvio usa, são enviados ao Claude com sua chave de API da Anthropic junto com cada mensagem do comprador, então textos longos aumentam seu uso da Anthropic. Veja O que usa sua chave de API da Anthropic e o que não usa.

Para descobrir o que adicionar em seguida, abra Conversas e confira a aba Sem resposta: ela lista as perguntas sobre produtos que a IA não conseguiu responder. Veja Encontre e corrija lacunas de conhecimento na aba Sem resposta.