Guida · Beta

Usa la tua chiave

Fai funzionare l'AI di Sonny sul tuo account OpenAI o Anthropic, oppure su un server compatibile con OpenAI ospitato da te, con conversazioni AI illimitate. Uno sblocco una tantum da $249, senza abbonamenti aggiuntivi. Ecco cosa ottieni e come configurarlo.

Vuoi la presentazione completa e il confronto dei costi? Consulta la panoramica di Usa la tua chiave.

Cosa ottieni con lo sblocco

Conversazioni AI illimitate
I limiti mensili di conversazioni spariscono. Il tuo provider ti addebita i token usati dal modello che hai scelto.
Il tuo provider, il tuo modello
Collega OpenAI, Anthropic (Claude) o qualsiasi endpoint compatibile con OpenAI, compreso un server Ollama o vLLM ospitato da te. Scegli tra i modelli consigliati o inserisci qualsiasi ID di modello.
Decidi dove avviene l'elaborazione AI
Ogni risposta ai clienti viene generata sul tuo account, secondo il tuo contratto con il provider. Ideale per ambienti server personalizzati e requisiti di residenza dei dati.
Le chiavi restano segrete
La tua chiave API è crittografata a riposo e non viene più mostrata: solo un indizio come "sk-a…4f2a", così sai quale chiave è collegata.
Tutte le funzionalità AI incluse
Il risponditore automatico, le bozze di risposta AI e la rifinitura passano tutti dalla tua chiave. Comportamento, soglie di sicurezza e orari di apertura funzionano esattamente come prima.
La base di conoscenza resta gestita
Le tue fonti di conoscenza restano gestite da Sonny senza costi aggiuntivi. È il provider collegato a generare le risposte per i clienti.

Configurazione

  1. 01

    Sblocca Usa la tua chiave

    Apri AI Copilot e trova la scheda Motore AI. In Usa la tua chiave (BYOK), seleziona Sblocca per $249. È un acquisto per spazio di lavoro, e solo il proprietario dello spazio di lavoro può effettuarlo.

  2. 02

    Configura la tua chiave

    Seleziona Configura la tua chiave per aprire Collega la tua AI. In Provider, scegli OpenAI, Anthropic (Claude) o Compatibile con OpenAI. Inserisci la Chiave API e scegli un Modello. I server compatibili con OpenAI richiedono anche il campo URL dell'endpoint con l'indirizzo pubblico definitivo in HTTPS; includi il percorso /v1 se il server lo usa. Aggiungi Basic Auth o intestazioni di accesso personalizzate se il tuo proxy le richiede.

  3. 03

    Testa la connessione

    Seleziona Testa connessione. Connettività verifica che Sonny possa raggiungere il provider e autenticarsi. Chiamata di strumenti verifica che il modello possa cercare nelle conoscenze e passare la conversazione a un collega. Entrambi i test devono essere superati prima di poter attivare la connessione.

  4. 04

    Salva e attiva

    Seleziona Salva e attiva. La pagina AI Copilot ora mostra Con la tua chiave. Usa Gestisci connessione per cambiare in seguito provider, credenziali o modello.

Una nota sui costi

Il costo esatto dipende da provider, modello e consumo di token. Controlla i prezzi attuali del tuo provider, poi usa la sua dashboard di utilizzo per vedere quanto costano davvero le tue conversazioni.

Buono a sapersi

Il mio endpoint ospitato in proprio deve usare HTTPS?
Sì. Per i provider ospitati in proprio Sonny accetta solo URL pubblici https://. Se in passato avevi collegato un endpoint http://, quella connessione è stata disattivata e vedrai una nota nelle impostazioni di AI Copilot: metti il tuo server dietro un proxy HTTPS, poi inserisci di nuovo l'URL per riattivarla.
Posso proteggere un server Ollama pubblico?
Sì. L'API locale di Ollama non autentica le richieste da sola, quindi mettila dietro un reverse proxy HTTPS e inserisci in Sonny le credenziali HTTP Basic Auth di quell'endpoint. Puoi anche aggiungere fino a 10 intestazioni personalizzate in sola scrittura per gateway come Cloudflare Access. Se è il proxy a gestire l'autenticazione puoi lasciare vuota la chiave API: Basic Auth sostituisce l'autenticazione Bearer con chiave API, quindi una chiave segnaposto non verrebbe mai inviata. Se il tuo gateway richiede entrambe, configura la sua chiave API in un'altra intestazione personalizzata. Le credenziali e i valori delle intestazioni sono crittografati e non vengono mai restituiti al tuo browser.
Cosa succede se la mia chiave smette di funzionare?
I clienti non restano mai senza risposta. Se il tuo provider rifiuta una richiesta (chiave scaduta, limite di richieste, server non disponibile), il risponditore automatico inoltra subito quelle conversazioni al tuo team e i proprietari dello spazio di lavoro ricevono una notifica con l'errore. Correggi la chiave (o torna a Sonny AI) e tutto riprende.
Posso tornare a Sonny AI?
Quando vuoi. La scheda ha un interruttore: disattivalo e Sonny AI subentra all'istante (con un piano AI attivo). La tua chiave e le impostazioni restano salvate, così puoi tornare indietro con un clic. Puoi anche tenere attivi insieme un piano AI e BYOK; risponde quello abilitato.
Quali modelli dovrei usare?
Usa un modello veloce e in grado di chiamare strumenti, come un modello di classe Claude Haiku o di classe OpenAI mini. Anche modelli ospitati in proprio più piccoli possono funzionare, ma aspettati risposte di qualità inferiore e inoltri meno affidabili; il test integrato di chiamata degli strumenti ti dirà se un modello non è all'altezza.
Le pagine della base di conoscenza hanno ancora un limite?
Sì: BYOK include un limite di 5000 pagine di conoscenza, perché Sonny continua a gestire le tue fonti di conoscenza separatamente dall'utilizzo del provider. Se hai anche un piano AI con un limite più alto, mantieni quello più alto.
La mia chiave API è al sicuro?
Le tue credenziali sono crittografate a riposo, non vengono più mostrate dopo il salvataggio e vengono usate solo quando Sonny invia una richiesta al provider che hai configurato. Gli URL degli endpoint ospitati in proprio sono limitati all'endpoint HTTPS pubblico che configuri.

Guide correlate

Scopri come ti aiuta Sonny