Ir para conteúdo principal

O que usa sua chave de API da Anthropic e o que não usa

Quais recursos do Olvio enviam solicitações ao Claude com sua chave da Anthropic, o que roda no Olvio e como manter o uso sob controle.

O que usa sua chave de API da Anthropic e o que não usa

O Olvio envia as solicitações ao Claude com a sua própria chave de API da Anthropic e o modelo Claude que você escolhe na página Chave de API, então a Anthropic cobra esse uso diretamente na sua conta da Anthropic. Seu plano do Olvio é cobrado separadamente, pelo Shopify. Este artigo lista os recursos do Olvio que enviam solicitações com a sua chave, o que o Olvio executa na própria infraestrutura e como manter sob controle o seu uso da Anthropic.

O teste gratuito de 14 dias vale apenas para o preço do seu plano do Olvio. As solicitações feitas com a sua chave durante o teste são cobradas pela Anthropic normalmente.

Na sua loja virtual

Essas solicitações acontecem enquanto os compradores usam o Olvio, inclusive quando você testa o widget na sua própria loja virtual.

  • Chat nas páginas de produto: cada mensagem que um comprador envia gera uma solicitação. Se o Olvio precisar procurar outro produto no seu catálogo para responder, essa mensagem gera uma segunda solicitação.

  • Cards de produto: quando a mensagem de um comprador cita produtos do seu catálogo diferentes do produto da página, e a resposta ainda não os mostrou como cards, uma solicitação extra curta verifica quais deles a resposta realmente recomenda antes de mostrar os cards desses produtos.

  • Perguntas sem resposta: quando a IA não consegue responder a uma pergunta e outros produtos fizeram parte da conversa, uma solicitação curta em segundo plano pode identificar a qual produto a pergunta se refere, para que ela seja listada no produto certo na aba Sem resposta de Conversas.

  • Olvio Advisor (Growth e Scale): cada mensagem em uma conversa do Advisor gera uma solicitação, inclusive o rótulo do chip enviado como primeira mensagem do comprador quando um link do Advisor inicia uma nova conversa. Uma mensagem que exige uma busca no catálogo gera uma segunda solicitação.

  • Perguntas sugeridas: quando um comprador abre uma página de produto e não há perguntas sugeridas salvas para esse produto no idioma que o widget usa nessa página, o Olvio faz uma solicitação para escrever as 2 perguntas sugeridas do produto. Quando os compradores já fizeram perguntas suficientes sobre um produto, o Olvio atualiza as perguntas sugeridas dele com base no que perguntaram, no máximo cerca de uma vez por dia por idioma. As perguntas sugeridas salvas também são atualizadas regularmente, o que gera uma nova solicitação na visita seguinte.

  • Suas próprias perguntas: se você definir as duas perguntas de um produto na página Questions, os compradores que navegam no idioma principal da sua loja as veem sem nenhuma solicitação. Quando uma das duas ainda é gerada pela IA, a primeira visita sem nada salvo para esse produto nesse idioma faz uma solicitação para gerar perguntas sugeridas. Em outro idioma que o Olvio cobre para a sua loja, essa primeira visita faz duas solicitações, mesmo quando as duas perguntas são suas: uma para traduzir suas perguntas para esse idioma e outra para gerar perguntas sugeridas para esse produto. O resultado é então salvo e atualizado como quaisquer perguntas sugeridas. Salvar um produto na página Questions não envia solicitação, mas apaga as perguntas sugeridas salvas desse produto em todos os idiomas que o Olvio cobre para a sua loja. A visita seguinte em cada idioma faz então solicitações como descrito acima, exceto no seu idioma principal quando as duas perguntas são suas.

No admin do Olvio e em segundo plano

  • Salvar sua chave ou seu modelo: quando você salva uma nova chave ou muda o Modelo Claude na página Chave de API, o Olvio envia uma solicitação de teste bem pequena com o modelo selecionado para verificar se a sua chave pode usá-lo. Excluir chave não envia solicitação.

  • Tradução dos textos do widget: quando o seu widget cobre um idioma diferente do seu idioma principal e esse idioma é inglês, francês, alemão, espanhol, italiano ou português, salvar um Nome do especialista ou uma Pergunta de chamariz alterados em WidgetProduct Detail Page os traduz para os seus idiomas cobertos que estão entre esses seis. A mesma tradução é feita quando você salva a página e falta uma tradução, por exemplo depois de adicionar um idioma, e quando o número de idiomas que o seu plano cobre aumenta, por exemplo depois de um upgrade.

  • Tradução do bloco Contato: salvar o nome do especialista, a pergunta de chamariz ou as perguntas em WidgetContato os traduz para os outros idiomas que o seu widget cobre. As traduções que faltam também são adicionadas quando você adiciona um idioma ou o seu plano passa a cobrir mais idiomas.

  • Mapa de perguntas dos clientes: o Olvio regenera o mapa toda noite assim que a sua loja tem perguntas recentes de compradores suficientes, e quando você clica em Gerar mapa agora ou Regenerar. Cada geração envia uma solicitação que dá nome aos temas do mapa.

  • Perguntas sem resposta: se a sua loja virtual publica mais de um idioma, sempre que o Olvio agrupa a lista da aba Sem resposta de Conversas, durante a noite ou quando você clica em Reorganizar, uma solicitação traduz as perguntas agrupadas para o idioma principal da sua loja (para inglês se esse idioma não for inglês, francês, alemão, espanhol, italiano ou português). Consulte Encontre e corrija lacunas de conhecimento na aba Sem resposta.

  • Perguntas sugeridas noturnas: toda noite, o Olvio analisa os produtos ativos importados ou atualizados no último dia, incluindo todos os produtos após uma importação completa do catálogo, como a primeira importação depois de escolher um plano ou quando você clica em Ressincronizar. Para cada idioma que cobre para a sua loja, ele escreve novas perguntas sugeridas para esses produtos, com duas exceções. Normalmente ele não faz nenhuma solicitação para um produto que já tem perguntas sugeridas nesse idioma quando o Olvio confirmou recentemente que o conteúdo do produto, como título, descrição, tags ou metacampos, não mudou. E ele não gera perguntas sugeridas para um produto cujas duas perguntas você definiu na página Questions: no seu idioma principal, ele salva suas perguntas sem solicitação e, em outro idioma, só envia uma solicitação para traduzi-las. Por isso, a noite seguinte a uma importação completa do catálogo pode enviar muitas solicitações com a sua chave.

O que não usa sua chave

O Olvio executa estas tarefas na própria infraestrutura, e elas não enviam solicitações com a sua chave:

  • A importação e a indexação dos seus produtos, páginas da loja, artigos de blog e políticas, para que o Olvio possa fazer buscas neles. Mesmo assim, produtos importados ou atualizados podem receber novas perguntas sugeridas na noite seguinte, como descrito acima.

  • A busca no catálogo em si, quando o Olvio procura produtos que correspondem à pergunta de um comprador.

  • O agrupamento de perguntas em temas no Mapa de perguntas dos clientes e o agrupamento de perguntas quase idênticas na aba Sem resposta de Conversas.

  • Salvar suas configurações nas páginas Configuração de IA e Advisor, incluindo a leitura dos seus arquivos de conhecimento e páginas web externas.

  • Seu painel e sua lista de conversas.

Antes de você escolher um plano, o chat e as perguntas sugeridas do Olvio não funcionam na sua loja virtual, então os compradores não fazem nenhuma solicitação com a sua chave.

Se a sua chave não puder ser usada

Se nenhuma chave estiver salva, o bloco do Olvio continua aparecendo nas suas páginas de produto, mas não mostra perguntas sugeridas e o chat responde Lamentamos, ocorreu um erro. Por favor, tente novamente. Os compradores veem a mesma resposta quando a Anthropic recusa uma solicitação, por exemplo porque a chave foi revogada ou a sua organização na Anthropic atingiu um limite de gastos. Para ver causas e soluções, consulte O chat responde "Lamentamos, ocorreu um erro. Por favor, tente novamente."

Mantenha seus custos com a Anthropic sob controle

  • Escolha Claude Haiku 4.5 — o mais rápido, menor custo (recomendado) na página Chave de API, a menos que você precise de mais qualidade nas respostas. Compare os modelos na página de preços da Anthropic e consulte Escolha seu modelo Claude.

  • Defina um limite de gastos no Claude Console: abra Settings → Billing e, na seção Spend limits, clique em Adjust limit (ou Set limit). Quando o limite é atingido, a Anthropic recusa novas solicitações até você aumentar o limite ou o acesso ser retomado. Durante esse período, o chat e o Advisor do Olvio param de responder, e uma página de produto cujas perguntas sugeridas precisam de uma nova solicitação não mostra nenhuma.

  • Cubra só os idiomas de que você precisa: cada idioma que o Olvio cobre para a sua loja tem as próprias perguntas sugeridas, e os textos do seu widget e as suas próprias perguntas só são traduzidos quando o Olvio cobre mais de um. A tradução da lista Sem resposta não depende disso: ela é feita quando a sua loja virtual publica mais de um idioma. No Growth, se a sua loja virtual publica pelo menos um idioma compatível com o Olvio além do seu idioma principal, você pode desmarcar o seu segundo idioma no card Idiomas da aba Avançado de Aparência e salvar para cobrir só o seu idioma principal. No Scale, não há escolha de idiomas: o widget cobre todos os idiomas publicados que o Olvio suporta. A exceção é uma loja que desmarcou o segundo idioma no Growth e salvou: no Scale, ela continua cobrindo só o idioma principal, então marque o idioma de novo e salve antes de fazer upgrade. Se você já fez o upgrade, entre em contato: consulte Contate-nos e horário de suporte. Consulte Multilíngue: escolha quais idiomas o seu widget cobre.

  • Defina as duas perguntas sugeridas dos seus produtos mais visitados na página Questions. Assim, os compradores que navegam no seu idioma principal as veem sem solicitação. Nos outros idiomas que o Olvio cobre, esses produtos continuam fazendo solicitações para traduzir suas perguntas e gerar perguntas sugeridas, então a economia é maior quando o seu widget cobre só o seu idioma principal. Consulte Personalize as perguntas sugeridas nas suas páginas de produto.

  • Mantenha sua base de conhecimento focada. As solicitações que escrevem as respostas do chat e do Advisor incluem as informações da sua Configuração de IA, seus arquivos de conhecimento e páginas web mais recentes, os detalhes dos produtos e as mensagens recentes da conversa, então conteúdos mais longos podem deixar essas solicitações maiores.

  • Clique em Ressincronizar só quando precisar. Na noite seguinte a uma importação completa do catálogo, o Olvio pode escrever novas perguntas sugeridas para todos os seus produtos, em cada idioma que cobre. Consulte Ressincronize seu catálogo de produtos.

Veja seu uso

O Olvio não mostra contagens de tokens nem custos de IA no admin. Em vez disso, confira as páginas Usage e Cost do Claude Console.

As solicitações do chat e do Advisor usam o cache de prompts da Anthropic, então instruções que se repetem entre solicitações podem ser lidas do cache da Anthropic em vez de serem processadas de novo. Por isso, o seu uso pode incluir gravações e leituras de cache, que a Anthropic cobra com preços próprios, e a página Usage mostra a sua taxa de cache.

Isto respondeu à sua pergunta?