Documentazione

Page Assist

Page Assist è stato creato per usare Ollama in locale, ma la stessa schermata accetta anche un endpoint ospitato: Impostazioni → OpenAI Compatible API → Add Provider → Custom. Bastano tre campi e la barra laterale riassume la scheda aperta usando Claude o GPT, anziché un modello limitato dalla RAM del tuo portatile.

Settings → OpenAI Compatible API → Add Provider → Custom: Provider Name, un Base URL che conserva /v1 e la chiave — poi seleziona gli ID modello dall'elenco che Page Assist recupera autonomamente.

Settings → OpenAI Compatible API → Add Provider → Custom

Provider Name   Kunavo
Base URL        https://api.kunavo.com/v1
API Key         sk-kn-...
                [ Save ]

Model List      (appears after Save — fetched from GET /v1/models)
  [x] claude-haiku-4-5
  [x] claude-sonnet-5
  [x] gpt-5-6-terra

Il Base URL conserva il suffisso /v1. La pagina OpenAI Compatible API non lo specifica, ma lo indica il campo. Il testo di aiuto recita «L’URL di base del provider API OpenAI. es. (http://localhost:1234/v1)» e le due pagine dei provider correlati che mostrano un URL concreto per lo stesso campo concordano: per LM Studio «per impostazione predefinita è http://localhost:1234/v1» e per LLaMA.cpp è http://localhost:8080/v1. Page Assist aggiunge soltanto il percorso, quindi l’origine senza suffisso restituisce 404 anziché 401, l’opposto dei client in stile Anthropic, che vogliono la sola origine.

L’elenco dei modelli viene recuperato, non inserito manualmente: di solito. Dopo Save, Page Assist apre un Model List con la dicitura «Seleziona i modelli di chat che vuoi usare con questo provider», popolato dai dati dell’endpoint. Kunavo risponde a GET /v1/models, quindi l’elenco si compila automaticamente. Se è vuoto, l’estensione mostra «Nessun modello trovato. Assicurati di aver aggiunto il provider corretto con l’URL di base e la chiave API»: un messaggio corretto, perché un elenco vuoto è molto più spesso dovuto all’URL di base o alla chiave che al catalogo. Verifica il problema con il curl qui sotto prima di intervenire sull’estensione. Gli ID possono anche essere aggiunti manualmente tramite Add Custom Model, il cui campo Model ID accetta senza modifiche uno slug dalla tabella in questa pagina.

Seleziona Chat Model, non l’altra opzione. Il modulo Add Custom Model offre una scelta Model Type, ma Kunavo non fornisce modelli di embedding: nessun elemento del catalogo risponde a quell’endpoint, quindi qui la seconda opzione non ha alcun modello da selezionare. La funzionalità Knowledge Base ne dipende: la pagina del fornitore afferma che è necessario impostarne uno in RAG Settings e consiglia nomic-embed-text. Per questo, tieni configurato un Ollama locale insieme a questo provider: Page Assist consente di avere più provider contemporaneamente e i due ruoli non devono provenire dallo stesso servizio.

Le impostazioni audio richiedono una configurazione a parte. La sezione Text-to-Speech di Page Assist offre un provider OpenAI TTS con una propria chiave API, un proprio URL di base e un modello TTS; Kunavo non fornisce modelli di sintesi vocale. Vale anche il contrario: Kunavo non fornisce modelli di riconoscimento vocale e l’input vocale di Page Assist usa il riconoscitore integrato nel browser, configurato in Speech Recognition Language, senza effettuare chiamate API. Lascia entrambe le sezioni configurate come sono.

Questa configurazione si basa sulla documentazione del fornitore e sulle stringhe della sua interfaccia, come risultavano alla data indicata sotto. Kunavo non ha eseguito Page Assist con il proprio endpoint: nessuna versione dell’estensione specifica, nessuna sessione nella barra laterale, nessuna risposta in streaming e nessuno scambio con gli strumenti. Una pagina di configurazione pubblicata non è un test e non va interpretata come tale. Puoi verificare autonomamente in dieci secondi il curl; il comportamento dell’estensione con un endpoint funzionante dipende da Page Assist.

Non hai ancora una chiave? Crea un account Kunavo, genera una chiave (inizia con sk-kn-) e aggiungi credito da $10: le chiamate vengono pagate con quel saldo e le chiamate non riuscite non vengono addebitate. La dashboard si apre quindi sulla configurazione Page Assist.

Passo dopo passo

Crea una chiave su /app/keys e copiala: viene mostrata una sola volta.
Fai clic sull’icona di Page Assist nella barra degli strumenti del browser, poi sull’icona Settings e apri la scheda OpenAI Compatible API.
Fai clic su Add Provider. Kunavo non è tra le opzioni predefinite nel menu a discesa, quindi scegli Custom: è il percorso che, al passaggio 5, la guida del fornitore indica per tutto ciò che non compare nell’elenco.
Compila Provider Name, Base URL = https://api.kunavo.com/v1 e API Key, poi fai clic su Save.
Nell’Model List che si apre, seleziona gli ID che vuoi usare. Di solito due sono il numero giusto: uno economico per i riepiloghi delle pagine e uno potente per le domande successive.
Apri la barra laterale su una pagina reale: Ctrl+Shift+L apre la Web UI. Scegli il modello dal selettore e fai una domanda sul contenuto della scheda. Una pagina con contenuti reali ti dirà più di un saluto, perché il testo della pagina è ciò che ha un costo.

Verificato rispetto a La pagina OpenAI Compatible API di Page Assist il 21 settembre 2026. Le impostazioni di terze parti cambiano; se il nome di un campo qui non corrisponde più a quello visualizzato, fa fede quella pagina, non questa.

Verifica prima di eseguire il debug del client

Una sola richiesta stabilisce se il problema riguarda l'endpoint, la chiave o il file di configurazione. Se restituisce JSON, lo stesso base URL e la stessa chiave funzionano in Page Assist.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Quale model id inserire nel campo

Ogni modello di testo è raggiungibile come model id: l'elenco aggiornato è GET /v1/models e il catalogo con i prezzi è nella pagina dei modelli. Le tariffe sono in USD per 1M di token, input / output.

ID del modello	Kunavo ingresso / uscita	Dove si inserisce in Page Assist
`claude-haiku-4-5`	$0.70 / $3.50	l’impostazione predefinita per una barra laterale: riepiloghi delle pagine e domande successive, dove conta soprattutto il volume
`gpt-5-6-terra`	$0.70 / $4.20	pagine lunghe — documentazione, discussioni, trascrizioni — inviate per intero anziché ridotte
`claude-sonnet-5`	$1.40 / $7.00	la domanda dopo il riepilogo, quando la risposta deve essere corretta
`gpt-5-6-sol`	$2.00 / $12.00	un secondo parere da un’altra famiglia; aggiungilo come secondo ID selezionato, con lo stesso provider

La fatturazione è per token, usando un saldo prepagato senza canone mensile: vedi billing. In presenza di contesto ripetuto, che costituisce la maggior parte di ciò che invia un editor o un client di chat, prompt caching incide sulla spesa più della scelta del modello.

Quanto costa la pagina e quali dati lasciano il browser

Un client nella barra laterale genera costi diversi da un editor, e la differenza è la pagina. Ogni volta che Page Assist interagisce con la scheda, il testo estratto da quella scheda viene inviato come token di input: una pagina di documentazione o una lunga discussione può contenerne decine di migliaia, e il testo viene reinviato a ogni domanda successiva nella stessa conversazione. Per questo la tabella dei modelli qui sopra mette in evidenza prima gli ID economici: in questo client, di solito i token di input superano di un ordine di grandezza quelli di output e claude-haiku-4-5 o gpt-5-6-terra che leggono una pagina intera costano meno di un modello più potente che ne legge una versione troncata.

Tre impostazioni aggiungono traffico che non hai richiesto esplicitamente e sono tutte elencate nella pagina Settings del fornitore:

Generate Title using AI — «Genera automaticamente il titolo della chat a partire dalla conversazione». Una chiamata aggiuntiva per conversazione, con il modello selezionato.
Internet Search, con Internet Search ON by default e Total Search Results: le pagine recuperate vengono aggiunte al prompt, quindi il costo in token cresce con il numero di risultati.
Page Action, l’estensione complementare: il modello «inizia leggendo la pagina, poi esegue le azioni una alla volta», quindi legge il DOM a ogni passaggio, non a ogni conversazione. L’impostazione Require approval before each action è attiva per impostazione predefinita ed è consigliabile lasciarla attiva.

Il confine della privacy segue lo stesso percorso. Page Assist salva chat, knowledge base e impostazioni nella memoria locale del browser; ciò che attraversa la rete è quello che invii. Una volta selezionato questo provider, vengono inviati a api.kunavo.com il testo della pagina, il tuo messaggio e la conversazione in corso, quindi i dati passano al servizio upstream che fornisce il modello indicato dall’ID. Consulta l’informativa sulla privacy per sapere cosa viene conservato da questo servizio. Se non incolleresti una pagina in una finestra di chat, torna a usare Ollama in locale: l’estensione consente di tenere configurati entrambi i provider contemporaneamente proprio perché il cambio avvenga con una sola selezione dal menu.

Se sei arrivato qui dal preset OpenRouter

OpenRouter non richiede il percorso Custom. È uno dei preset elencati nella pagina OpenAI Compatible API del fornitore, insieme a Ollama, LM Studio, Groq, Together, Mistral, xAI e circa altri venti; il percorso prevede quindi i primi quattro clic, poi OpenRouter dal menu a discesa invece di Custom, la chiave corrispondente in API Key e Save. Il preset include il proprio URL di base e gli ID modello di OpenRouter hanno un prefisso del fornitore, nel formato anthropic/claude-sonnet-4.5, mentre gli ID nella tabella qui sopra sono senza prefisso. Scegliere un provider significa scegliere quale spazio dei nomi usare per gli ID da inserire.

Su questo client, vale la pena passare a OpenRouter se vuoi una schermata che dia accesso anche a modelli non disponibili su Kunavo, oppure se hai già configurato la chiave e non serve alcuna configurazione aggiuntiva. Vale la pena passare a Kunavo perché gli ID nella tabella sono gli stessi che usi anche negli strumenti di programmazione: una sola chiave basta per entrambi e la memorizzazione nella cache dei prompt sul contesto della pagina reinviato è ciò che incide davvero sul costo della barra laterale. Vedi caching. Puoi mantenere entrambi i provider: Page Assist li mostra insieme e il selettore dei modelli non dipende dalla riga di provenienza del modello.

Domande frequenti

Come si usa un’API personalizzata con Page Assist?

Fai clic sull’icona di Page Assist nella barra degli strumenti del browser, apri Settings, vai alla scheda OpenAI Compatible API e fai clic su Add Provider. Se il tuo endpoint non è tra le opzioni predefinite nel menu a discesa, seleziona Custom e compila Provider Name, Base URL e API Key, poi fai clic su Save. Page Assist apre quindi una Model List recuperata dall’endpoint, in cui puoi selezionare i modelli di chat da usare con quel provider. Se il recupero non restituisce risultati, puoi inserire gli ID manualmente tramite Add Custom Model.

L’URL di base di Page Assist deve includere /v1?

Sì, per un endpoint compatibile con OpenAI. La pagina OpenAI Compatible API non lo specifica, ma lo indica il testo di aiuto del campo Base URL: «L’URL di base del provider API OpenAI. es. (http://localhost:1234/v1)». Anche le pagine di LM Studio e LLaMA.cpp mostrano lo stesso suffisso per quel campo: http://localhost:1234/v1 e http://localhost:8080/v1. Per Kunavo, quindi, l’URL è https://api.kunavo.com/v1. Page Assist aggiunge soltanto il percorso, perciò omettendo il suffisso si ottiene 404 anziché un errore di autenticazione.

Perché Page Assist non mostra modelli dopo che aggiungo un provider?

L’elenco viene recuperato dall’endpoint usando la chiave appena inserita e il messaggio dell’estensione indica cosa controllare: «Nessun modello trovato. Assicurati di aver aggiunto il provider corretto con l’URL di base e la chiave API». Verifica la stessa coppia fuori dall’estensione con una richiesta curl a /v1/models: se ricevi JSON, il problema è nella configurazione del provider; 401 indica un problema con la chiave e 404 di solito un /v1 mancante nell’URL di base. In alternativa, aggiungi gli ID manualmente tramite Add Custom Model, che non dipende dal recupero.

Page Assist può usare Claude o GPT invece di un modello locale?

Sì. «OpenAI Compatible API» indica il formato di comunicazione, non il fornitore, e l’ID del modello viene inoltrato all’URL di base configurato: quindi un ID Claude o GPT viene risolto da quell’endpoint, non all’interno dell’estensione. Le funzionalità per i modelli locali restano disponibili: Page Assist consente di usare più provider contemporaneamente, quindi una voce Ollama e una voce ospitata possono coesistere e puoi passare dall’una all’altra dal selettore dei modelli.

Qual è il modello meno costoso per Page Assist?

In questo client prevalgono i costi di input, perché interagire con una scheda comporta il reinvio del testo estratto a ogni turno della conversazione. Per impostazione predefinita conviene quindi scegliere un modello economico con un contesto ampio: claude-haiku-4-5 per le pagine ordinarie e gpt-5-6-terra per quelle lunghe. Puoi aggiungere come seconda opzione un ID più potente, come claude-sonnet-5, per le domande in cui la risposta è importante. Le tariffe per milione di token di ciascun modello sono nella tabella di questa pagina e la memorizzazione nella cache dei prompt incide sul costo della barra laterale più della scelta del modello.

La Knowledge Base di Page Assist può usare Kunavo?

Non per la fase di indicizzazione. Knowledge Base è una funzionalità RAG e, secondo la documentazione del fornitore, in RAG Settings occorre impostare un modello di embedding; viene consigliato nomic-embed-text. Kunavo non fornisce modelli di embedding, quindi per quel campo serve un provider diverso: di solito si usa Ollama in locale, che può funzionare insieme a questo senza conflitti. La parte di chat non ne risente: una volta indicizzati i documenti, per rispondere alle domande su di essi si può usare qualsiasi ID chat di questo provider.

Kunavo ha testato Page Assist?

No. Il 21 settembre 2026 sono state verificate la documentazione OpenAI Compatible API di Page Assist e le stringhe inglesi dell’interfaccia dell’estensione: il percorso nelle impostazioni, le etichette e l’ordine dei campi, l’esempio dell’URL di base e il messaggio mostrato quando l’elenco è vuoto sono riportati da quelle fonti. Kunavo non ha installato l’estensione, fissato una versione né inviato richieste tramite essa, e non fa affermazioni sul funzionamento dello streaming, sull’estrazione delle pagine o sul recupero della Model List in una versione specifica. La richiesta curl in questa pagina è ciò che puoi verificare in autonomia.