Adicione arquivos e páginas web à base de conhecimento do Olvio

A base de conhecimento do Olvio reúne documentos e páginas web com informações que não estão nas suas páginas de produto, como uma FAQ, um guia de tamanhos, instruções de cuidado, termos de garantia ou fichas técnicas. A IA usa esse conteúdo nos chats das páginas de produto e, nos planos Growth e Scale, nas conversas do Olvio Advisor.

Você gerencia esse conteúdo na página Configuração de IA, nas seções Arquivos de conhecimento e Páginas web externas. As duas seções estão disponíveis em todos os planos, e o seu plano define quantos arquivos e páginas você pode adicionar. Essas duas seções não usam a barra de salvamento da página: um arquivo é salvo quando você clica em Salvar na base de conhecimento, e uma página web é salva quando o Olvio termina de lê-la.

Nos chats das páginas de produto, o Olvio já lê as páginas, os artigos de blog e as políticas da sua própria loja: consulte Como o Olvio lê as páginas, os posts do blog e as políticas da sua loja. As conversas do Olvio Advisor não usam esse conteúdo, então, nos planos Growth e Scale, adicione em Páginas web externas qualquer página da loja de que o Advisor precise. Uma página adicionada ali também é enviada com cada mensagem dos chats das páginas de produto e, por ser a sua entrada mais recente, pode tirar arquivos e páginas mais antigos do conjunto que a IA usa (consulte Como o Olvio usa seus arquivos e páginas abaixo), então adicione apenas as páginas de que o Advisor precisa. Notas sobre um único produto devem ficar no metacampo custom.olvio_knowledge desse produto: consulte Adicione notas específicas de produto com o metacampo custom.olvio_knowledge.

Envie um arquivo de conhecimento

Os arquivos de conhecimento aceitam arquivos PDF, DOCX, TXT, MD e CSV de até 50 MB cada. O Olvio ignora outros tipos de arquivo: se você soltar ou selecionar um deles, como uma planilha do Excel ou um arquivo antigo do Word (.doc), nenhuma janela de revisão é aberta. Antes de adicioná-los, salve as planilhas como CSV e os arquivos antigos do Word como DOCX ou PDF.

No admin do Olvio, abra Configuração de IA.
Em Arquivos de conhecimento, clique em Adicionar arquivos e escolha um arquivo, ou solte um arquivo na área de upload.
O Olvio extrai o texto no seu navegador e mostra Lendo seguido do nome do arquivo. Em seguida, abre-se uma janela com o título Revisão: seguido do nome do arquivo.
Confira o texto e edite-o se necessário. Somente o texto desta janela é salvo.
Clique em Salvar na base de conhecimento. A mensagem Arquivo enviado confirma o envio, e o arquivo aparece na lista. Para parar sem salvar, clique em Cancelar.

O Olvio não envia o arquivo original: ele envia e armazena apenas o nome do arquivo e o texto da janela de revisão, e a IA pode ver os dois.

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 salvá-lo ou cancelá-lo.

Confira o texto extraído

Os avisos sobre a extração aparecem no topo da janela de revisão, em Atenção:

Arquivos sem texto. Se o Olvio não encontrar texto em um arquivo, a caixa de texto fica vazia e Salvar na base de conhecimento fica indisponível. Para um PDF, a mensagem diz que o PDF parece digitalizado ou composto só de imagens: um PDF digitalizado não tem texto selecionável, então aplique primeiro o reconhecimento de texto (OCR) ou cole você mesmo o texto na caixa. Se só algumas páginas estiverem digitalizadas, o Olvio pula essas páginas sem avisar, então confira se a caixa de texto contém todas as páginas de que você precisa. Para outros arquivos, como um documento do Word que contém só imagens, a mensagem é No readable text was extracted… Confira se o documento contém texto, e não imagens de texto, ou cole você mesmo o texto na caixa.
Arquivos que o Olvio não consegue ler. Se um PDF ou DOCX estiver danificado ou protegido, ou se o seu navegador não conseguir carregar o leitor de PDF ou DOCX do Olvio (por exemplo, em uma rede ou com uma extensão do navegador que o bloqueie), a caixa de texto fica vazia, Salvar na base de conhecimento fica indisponível e a mensagem de Atenção começa com Couldn't read seguido do nome do arquivo e do motivo. Se o arquivo pedir uma senha ao ser aberto, salve uma cópia sem senha e adicione essa cópia. Se o arquivo abrir normalmente no seu computador sem senha, desative qualquer extensão do navegador que possa bloquear o leitor, ou mude para outro navegador ou outra rede. Depois, abra o admin do Olvio novamente em uma nova aba do navegador e adicione o arquivo de novo: adicioná-lo de novo na página que já está aberta pode mostrar a mesma mensagem. Se ainda falhar, ou se o arquivo não abrir normalmente, salve-o novamente em outro aplicativo, ou copie o texto dele para um arquivo TXT, e adicione-o novamente.
Documentos do Word. Um arquivo DOCX também pode mostrar algumas observações curtas da conversão. Confira se o texto na caixa está correto; se estiver, você pode salvar.
Linhas repetidas. Em PDFs com várias páginas, o Olvio remove linhas curtas que se repetem em muitas páginas, como cabeçalhos e rodapés, e informa quantas foram removidas. Confira se nada de que você precisa foi removido.
Documentos longos. Cada arquivo pode conter até 900 KB de texto. O contador abaixo do texto mostra o tamanho atual, por exemplo 120.5 KB / 900 KB (máx. por ficheiro). Se um documento for mais longo, o Olvio mantém os primeiros 900 KB e avisa você.

Nos arquivos CSV, o Olvio transforma cada linha em uma linha de tabela e separa as colunas em cada vírgula, inclusive vírgulas dentro de texto entre aspas. Se algumas células contiverem vírgulas, confira essas linhas na janela de revisão.

O Olvio lê arquivos TXT, MD e CSV como texto UTF-8. Se letras acentuadas aparecerem erradas na janela de revisão, clique em Cancelar, salve o arquivo de novo com codificação UTF-8 (no Excel, escolha CSV UTF-8 (Delimitado por vírgulas)) e adicione-o novamente.

Adicione uma página web externa

Em Configuração de IA, vá até Páginas web externas e cole o endereço completo da página, por exemplo https://example.com/faq.
Clique em Adicionar. O botão mostra um indicador de carregamento enquanto o Olvio lê a página.
Quando a página tiver sido lida, você verá Página adicionada à base de conhecimento e a página aparecerá na lista.

O Olvio mantém todo o texto da página, incluindo menus e rodapés, então escolha páginas focadas nas informações de que os compradores precisam.

Se a página não puder ser lida, nada é salvo e você vê Não foi possível recuperar esta página: seguido do motivo. O endereço continua no campo para que você possa corrigi-lo. O Olvio consegue ler uma página quando:

O endereço começa com https:// e usa um nome de domínio público. Endereços IP, localhost e endereços com número de porta (como :8080) são recusados com URL inválida. Use um endereço https:// público completo.
A página é pública. O Olvio não consegue fazer login em um site, então só vê o que um visitante sem login vê. Se esse visitante receber uma página de login, de senha ou de cookies nesse endereço, o Olvio pode salvar o texto dessa página no lugar, sem erro, e mostrá-la como Recuperada. Para conferir, abra o endereço em uma janela anônima do navegador.
O endereço aponta para uma página web ou um arquivo de texto simples. Outros arquivos, como um PDF com link em um site, falham com Unsupported content type: baixe o arquivo e envie-o em Arquivos de conhecimento.
O texto está na própria página. O Olvio não executa os scripts da página, então uma página que monta seu conteúdo com JavaScript pode falhar com No readable text found… ou fornecer ao Olvio só parte do texto.
O site permite visitantes automatizados. Alguns sites bloqueiam visitantes automatizados, então a página pode falhar com um erro HTTP como HTTP 403, ou com No readable text found…, mesmo que abra no seu navegador. Nesse caso, copie o texto da página para um arquivo TXT e envie-o em Arquivos de conhecimento.
A página carrega em até 10 segundos e não passa de 3 MB. Caso contrário, você vê Timed out after 10 s, Network error while reading… ou Page too large (max 3 MB).
Se o endereço redirecionar, o endereço final segue as mesmas regras. Caso contrário, você vê Redirected to a blocked address.

Um motivo como HTTP 404 é o erro retornado pelo site: abra o endereço no navegador para conferir se está correto. Network error significa que o Olvio não conseguiu se conectar ao site: confira o endereço e tente novamente. Cada endereço só pode ser adicionado uma vez; adicioná-lo de novo mostra Esta URL já está na sua base de conhecimento.

Mantenha as páginas web atualizadas

Cada página aparece na lista com seu domínio e caminho, como example.com/faq, e um selo de status:

Recuperada: o Olvio tem o texto da página. A linha abaixo mostra Atualizada em com a data e a hora em que o Olvio leu a página pela última vez.
Erro: a última tentativa de ler a página falhou. A linha abaixo mostra Última tentativa em com a data e a hora, seguidas do motivo. O Olvio continua usando o texto lido antes.

Para verificar uma página agora, clique no ícone de atualizar dela. Você vê Página atualizada se o conteúdo mudou, ou Já está atualizada se não mudou. Se o Olvio não conseguir ler a página, você vê Não foi possível atualizar: seguido do motivo, e o conteúdo anterior continua em uso.

O Olvio também atualiza suas páginas automaticamente, normalmente toda noite, e só substitui o texto salvo quando a página mudou. Uma atualização automática que falha mostra o mesmo selo Erro e mantém o texto anterior.

Atualize ou remova arquivos e páginas

Não é possível ver nem editar o texto de um arquivo depois de salvá-lo. Para atualizar um documento, exclua-o e envie a nova versão. Para mudar o endereço de uma página web, exclua a página e adicione o novo endereço.

Para remover um arquivo ou uma página web, clique no ícone de lixeira ao lado. A exclusão é imediata, sem etapa de confirmação, e você vê Arquivo removido.

Limites dos planos

O seu plano define quantos arquivos de conhecimento e quantas páginas web externas você pode adicionar. Os dois limites são separados: páginas web não contam para o limite de arquivos, e arquivos não contam para o limite de páginas web. Esses limites se referem a quantas entradas você pode armazenar, não a quantas a IA usa: nas conversas, ela usa apenas seus arquivos e páginas mais recentes, contados em conjunto (consulte a próxima seção).

Plano	Arquivos de conhecimento	Páginas web externas
Starter	10	10
Growth	30	30
Scale	100	100

Um contador abaixo da descrição de cada seção, como 3/10, mostra quantos você adicionou e fica vermelho quando você atinge o limite.

No limite, o Olvio não adiciona a entrada e mostra You've reached the Starter plan limit of 10 knowledge files… para um arquivo, ou Limite de 10 páginas web atingido (plano Starter). Exclua uma ou faça upgrade. para uma página, com o seu próprio plano e limite. Para arquivos, essa verificação acontece quando você clica em Salvar na base de conhecimento. A janela de revisão fecha quando você clica em Salvar na base de conhecimento, então, se o arquivo não for salvo, as edições que você fez são perdidas e é preciso adicionar o arquivo novamente. Se o seu contador de arquivos já estiver no limite, exclua um arquivo antes de enviar outro. Para adicionar mais, exclua uma entrada dessa seção ou, no Starter ou no Growth, faça upgrade do seu plano: consulte Faça upgrade ou downgrade do seu plano.

Se você mudar para um plano com limite menor, os arquivos e páginas já adicionados continuam, mas você não pode adicionar mais a uma seção até que ela fique abaixo do novo limite.

Como o Olvio usa seus arquivos e páginas

A IA usa as informações dos seus arquivos e páginas para responder aos compradores e é instruída a apresentá-las como conhecimento próprio da sua loja, sem dizer de qual documento ou página elas vêm.
A IA é instruída a ignorar instruções escritas dentro de um arquivo ou página. Para mudar o comportamento dela, use Regras de conversa: consulte Escreva regras de conversa eficazes.
Alterações nos seus arquivos e páginas, como uma entrada nova, atualizada ou excluída, chegam às conversas em poucos minutos, geralmente a partir da próxima mensagem enviada por um comprador.
O Olvio usa apenas um número limitado das suas entradas adicionadas mais recentemente, contando arquivos e páginas web em conjunto, e uma quantidade limitada do texto delas. Se você adicionar muitas entradas, as mais antigas não são usadas, mesmo as curtas. Um documento longo também pode ocupar sozinho todo esse espaço, então o final de um documento muito longo pode não ser usado. Mantenha sua base de conhecimento com poucos documentos focados: junte documentos curtos relacionados em um único arquivo e exclua os desatualizados. Para dar prioridade de novo a um documento mais antigo, exclua-o e adicione-o novamente.
O texto é enviado ao Claude com a sua chave de API da Anthropic junto com cada mensagem do comprador, então arquivos e páginas longos aumentam o seu uso da Anthropic. Consulte O que usa sua chave de API da Anthropic e o que não usa.
Tudo o que está na sua base de conhecimento pode ser repetido aos compradores, então não adicione documentos internos ou confidenciais.
Arquivos e páginas não alteram as perguntas sugeridas exibidas nas suas páginas de produto.

Para ver quais perguntas a IA não conseguiu responder e decidir o que adicionar, consulte Encontre e corrija lacunas de conhecimento na aba Sem resposta.

Mensagens que você pode ver

Mensagem	O que fazer
"size-guide.pdf" é muito grande (máx. 50MB)	O arquivo tem mais de 50 MB. Reduza o tamanho dele, divida-o ou copie o texto dele para um arquivo TXT.
Não foi possível ler "size-guide.csv" — tente converter para PDF ou TXT	Seu navegador não conseguiu abrir o arquivo. Confira se ele abre no seu computador e adicione-o novamente. Se ainda falhar, copie o texto dele para um novo arquivo TXT e envie esse arquivo.
Uma mensagem que começa com File content too large	O texto na janela de revisão tinha mais de 900 KB, então o arquivo não foi salvo. Adicione o arquivo novamente e mantenha o texto em até 900 KB antes de salvar.
Too many uploads… ou Muitas solicitações — aguarde um momento e tente novamente.	Aguarde um momento e adicione o arquivo novamente, ou tente de novo com a página web.
Could not save the file… ou Não foi possível salvar a página. Tente novamente em instantes.	Um problema temporário impediu o salvamento. Aguarde um momento e adicione o arquivo novamente, ou tente de novo com a página web.