Vai al contenuto principale

Cosa usa la tua chiave API di Anthropic e cosa no

Quali funzioni di Olvio inviano richieste a Claude con la tua chiave Anthropic, cosa gira su Olvio e come tenere sotto controllo l'utilizzo.

Cosa usa la tua chiave API di Anthropic e cosa no

Olvio invia le sue richieste a Claude con la tua chiave API Anthropic personale e con il modello Claude che scegli nella pagina Chiave API, quindi Anthropic fattura quell'utilizzo direttamente sul tuo account Anthropic. Il tuo piano Olvio viene fatturato a parte, tramite Shopify. Questo articolo elenca le funzioni di Olvio che inviano richieste con la tua chiave, ciò che Olvio esegue sulla propria infrastruttura e come tenere sotto controllo il tuo utilizzo di Anthropic.

La prova gratuita di 14 giorni riguarda solo il prezzo del tuo piano Olvio. Le richieste fatte con la tua chiave durante la prova vengono fatturate da Anthropic come di consueto.

Sul tuo negozio online

Queste richieste avvengono mentre gli acquirenti usano Olvio, anche quando provi il widget sul tuo negozio online.

  • Chat sulle pagine prodotto: ogni messaggio inviato da un acquirente genera una richiesta. Se Olvio deve cercare nel tuo catalogo un altro prodotto per rispondere, quel messaggio genera una seconda richiesta.

  • Schede prodotto: quando il messaggio di un acquirente nomina prodotti del tuo catalogo diversi da quello della pagina, e la risposta non li ha già mostrati come schede, una breve richiesta aggiuntiva verifica quali di questi la risposta consiglia davvero prima di mostrarne le schede.

  • Domande senza risposta: quando l'IA non riesce a rispondere a una domanda e nella conversazione sono comparsi altri prodotti, una breve richiesta in background può individuare a quale prodotto si riferisce la domanda, così che venga elencata sotto il prodotto giusto nella scheda Senza risposta di Conversazioni.

  • Olvio Advisor (Growth e Scale): ogni messaggio in una conversazione Advisor genera una richiesta, compresa l'etichetta del chip inviata come primo messaggio dell'acquirente quando un link Advisor avvia una nuova conversazione. Un messaggio che richiede una ricerca nel catalogo genera una seconda richiesta.

  • Domande suggerite: quando un acquirente apre una pagina prodotto e per quel prodotto non ci sono domande suggerite salvate nella lingua usata dal widget su quella pagina, Olvio fa una richiesta per scrivere le sue 2 domande suggerite. Quando gli acquirenti hanno posto abbastanza domande su un prodotto, Olvio aggiorna le sue domande suggerite in base a ciò che hanno chiesto, al massimo circa una volta al giorno per lingua. Anche le domande suggerite salvate vengono aggiornate regolarmente, il che genera una nuova richiesta alla visita successiva.

  • Le tue domande: se imposti entrambe le domande di un prodotto nella pagina Questions, gli acquirenti che navigano nella lingua principale del tuo negozio le vedono senza alcuna richiesta. Quando una delle due è ancora generata dall'IA, la prima visita senza nulla di salvato per quel prodotto in quella lingua fa una richiesta per generare le domande suggerite. In un'altra lingua che Olvio copre per il tuo negozio, quella prima visita fa due richieste, anche quando entrambe le domande sono tue: una per tradurre le tue domande in quella lingua e una per generare le domande suggerite per quel prodotto. Il risultato viene poi salvato e aggiornato come qualsiasi domanda suggerita. Salvare un prodotto nella pagina Questions non invia richieste, ma cancella le domande suggerite salvate di quel prodotto in tutte le lingue che Olvio copre per il tuo negozio. La visita successiva in ciascuna lingua fa quindi richieste come descritto sopra, tranne nella tua lingua principale quando entrambe le domande sono tue.

Nell'amministrazione di Olvio e in background

  • Salvataggio della chiave o del modello: quando salvi una nuova chiave o cambi il Modello Claude nella pagina Chiave API, Olvio invia una richiesta di prova molto piccola con il modello selezionato per verificare che la tua chiave possa usarlo. Elimina chiave non invia richieste.

  • Traduzione dei testi del widget: quando il tuo widget copre una lingua diversa dalla tua lingua principale e quella lingua è inglese, francese, tedesco, spagnolo, italiano o portoghese, salvare un Nome dell'esperto o una Domanda d'aggancio modificati in WidgetProduct Detail Page li traduce nelle tue lingue coperte che rientrano tra queste sei. La stessa traduzione viene eseguita quando salvi la pagina e manca una traduzione, ad esempio dopo aver aggiunto una lingua, e quando aumenta il numero di lingue coperte dal tuo piano, ad esempio dopo un upgrade.

  • Traduzione del blocco Contatti: salvare il nome dell'esperto, la domanda d'aggancio o le domande in WidgetContatti li traduce nelle altre lingue coperte dal tuo widget. Le traduzioni mancanti vengono aggiunte anche quando aggiungi una lingua o il tuo piano copre più lingue.

  • Mappa delle domande dei clienti: Olvio rigenera la mappa ogni notte non appena il tuo negozio ha abbastanza domande recenti degli acquirenti, e quando clicchi su Genera la mappa o Rigenera. Ogni generazione invia una richiesta che dà un nome ai suoi temi.

  • Domande senza risposta: se il tuo negozio online pubblica più di una lingua, ogni volta che Olvio raggruppa l'elenco della scheda Senza risposta di Conversazioni, di notte o quando clicchi su Riorganizza, una richiesta traduce le domande raggruppate nella lingua principale del tuo negozio (in inglese se quella lingua non è inglese, francese, tedesco, spagnolo, italiano o portoghese). Consulta Trova e colma le lacune di conoscenza nella scheda Senza risposta.

  • Domande suggerite notturne: ogni notte Olvio esamina i prodotti attivi importati o aggiornati nell'ultimo giorno, compresi tutti i prodotti dopo un'importazione completa del catalogo, come la prima importazione dopo la scelta di un piano o quando clicchi su Risincronizza. Per ogni lingua che copre per il tuo negozio, scrive nuove domande suggerite per questi prodotti, con due eccezioni. Di solito non fa alcuna richiesta per un prodotto che ha già domande suggerite in quella lingua quando Olvio ha confermato di recente che il suo contenuto, come titolo, descrizione, tag o metafield, non è cambiato. E non genera domande suggerite per un prodotto di cui hai impostato le due domande nella pagina Questions: nella tua lingua principale salva le tue domande senza richieste, e in un'altra lingua invia solo una richiesta per tradurle. La notte dopo un'importazione completa del catalogo può quindi inviare molte richieste con la tua chiave.

Cosa non usa la tua chiave

Olvio esegue queste operazioni sulla propria infrastruttura, senza inviare richieste con la tua chiave:

  • L'importazione e l'indicizzazione di prodotti, pagine del negozio, articoli del blog e informative, così che Olvio possa effettuare ricerche al loro interno. I prodotti importati o aggiornati possono comunque ricevere nuove domande suggerite la notte successiva, come descritto sopra.

  • La ricerca nel catalogo in sé, quando Olvio cerca i prodotti che corrispondono alla domanda di un acquirente.

  • Il raggruppamento delle domande in temi nella Mappa delle domande dei clienti e il raggruppamento delle domande quasi identiche nella scheda Senza risposta di Conversazioni.

  • Il salvataggio delle impostazioni nelle pagine Configurazione IA e Advisor, compresa la lettura dei tuoi file di conoscenza e delle pagine web esterne.

  • La tua dashboard e il tuo elenco di conversazioni.

Prima che tu scelga un piano, la chat e le domande suggerite di Olvio non sono attive sul tuo negozio online, quindi gli acquirenti non fanno richieste con la tua chiave.

Se la tua chiave non può essere usata

Se non è salvata alcuna chiave, il blocco Olvio compare comunque nelle tue pagine prodotto, ma non mostra domande suggerite e la chat risponde Siamo spiacenti, si è verificato un errore. Riprova. Gli acquirenti vedono la stessa risposta quando Anthropic rifiuta una richiesta, ad esempio perché la chiave è stata revocata o la tua organizzazione Anthropic ha raggiunto un limite di spesa. Per cause e soluzioni, consulta La chat risponde "Siamo spiacenti, si è verificato un errore. Riprova."

Tieni sotto controllo i costi di Anthropic

  • Scegli Claude Haiku 4.5 — il più veloce, costo più basso (consigliato) nella pagina Chiave API, a meno che tu non abbia bisogno di risposte di qualità superiore. Confronta i modelli nella pagina dei prezzi di Anthropic e consulta Scegli il tuo modello Claude.

  • Imposta un limite di spesa nella Claude Console: apri Settings → Billing, poi nella sezione Spend limits clicca su Adjust limit (o Set limit). Una volta raggiunto il limite, Anthropic rifiuta le nuove richieste finché non alzi il limite o l'accesso non riprende. Nel frattempo la chat e l'Advisor di Olvio smettono di rispondere, e una pagina prodotto le cui domande suggerite hanno bisogno di una nuova richiesta non ne mostra nessuna.

  • Copri solo le lingue che ti servono: ogni lingua che Olvio copre per il tuo negozio ha le sue domande suggerite, e i testi del widget e le tue domande vengono tradotti solo quando Olvio copre più di una lingua. La traduzione dell'elenco Senza risposta non dipende da questo: viene eseguita quando il tuo negozio online pubblica più di una lingua. Con Growth, se il tuo negozio online pubblica almeno una lingua supportata da Olvio oltre alla tua lingua principale, puoi deselezionare la tua seconda lingua nel riquadro Lingue della scheda Avanzato di Aspetto e salvare per coprire solo la tua lingua principale. Con Scale non c'è una scelta delle lingue: il widget copre tutte le lingue pubblicate supportate da Olvio. Fa eccezione un negozio che ha deselezionato la sua seconda lingua con Growth e ha salvato: con Scale continua a coprire solo la sua lingua principale, quindi seleziona di nuovo la lingua e salva prima di passare a Scale. Se sei già passato a Scale, contattaci: consulta Contattaci e orari di supporto. Consulta Multilingua: scegli quali lingue copre il tuo widget.

  • Imposta entrambe le domande suggerite dei tuoi prodotti più visitati nella pagina Questions. Gli acquirenti che navigano nella tua lingua principale le vedono così senza richieste. Nelle altre lingue coperte da Olvio, quei prodotti fanno comunque richieste per tradurre le tue domande e generare domande suggerite, quindi il risparmio è maggiore quando il tuo widget copre solo la tua lingua principale. Consulta Personalizza le domande suggerite nelle tue pagine prodotto.

  • Mantieni la base di conoscenza mirata. Le richieste che scrivono le risposte della chat e dell'Advisor includono le informazioni della tua Configurazione IA, i tuoi file di conoscenza e le pagine web più recenti, i dettagli dei prodotti e gli ultimi messaggi della conversazione, quindi contenuti più lunghi possono rendere queste richieste più grandi.

  • Clicca su Risincronizza solo quando serve. La notte dopo un'importazione completa del catalogo, Olvio può scrivere nuove domande suggerite per tutti i tuoi prodotti, in ogni lingua che copre. Consulta Risincronizza il tuo catalogo prodotti.

Controlla il tuo utilizzo

Olvio non mostra conteggi di token né costi dell'IA nella sua amministrazione. Consulta invece le pagine Usage e Cost della Claude Console.

Le richieste della chat e dell'Advisor usano il prompt caching di Anthropic, quindi le istruzioni che si ripetono tra una richiesta e l'altra possono essere lette dalla cache di Anthropic invece di essere elaborate di nuovo. Il tuo utilizzo può quindi includere scritture e letture della cache, a cui Anthropic applica tariffe distinte, e la pagina Usage mostra il tuo tasso di cache.

Hai ricevuto la risposta alla tua domanda?