Modelli IA e chiave personale

L'IA nel pannello funziona in molti punti: descrizioni di prodotti e piatti, risposte agli ospiti, analisi delle chiamate, creazione di materiali didattici, assistente per le sezioni. Per impostazione predefinita la modello per ogni attività la scegliamo noi — e per la maggior parte è sufficiente.

La sezione «Modelli IA (LLM)» serve a chi vuole decidere in autonomia: quale servizio risponde alle funzioni assistente dell'account e su quale modello opera. E se avete già un vostro contratto con un provider — potete collegare una chiave personale, e le chiamate passeranno attraverso di essa.

Aprire: la scheda «Modelli IA (LLM)» nel negozio delle estensioni (categoria «Account») → admin.cenaly.com/ai-models. La sezione non ha una propria voce di menu — non è un errore, la porta è una sola, dal negozio. La sezione è accessibile solo al proprietario dell'account.

A cosa serve questa sezione#

Scenario	Cosa fare
«Lasciate che tutto funzioni da solo»	nulla: la sezione può non essere aperta, la piattaforma seleziona da sé il modello per ogni attività
«Voglio che risponda un modello specifico»	collegare un servizio pronto e sceglierlo come preferito
«Abbiamo un nostro contratto con un provider / una nostra inferenza»	aggiungere una connessione personalizzata con il proprio indirizzo e la propria chiave
«Bisogna capire dove finiscono i crediti IA»	consultare le schede del saldo nella pagina abbonamento

Cosa serve per iniziare#

Cosa	A cosa serve
Siete il proprietario dell'account	la sezione è owner-only, e questo lo verifica il server, non solo l'interfaccia
La scheda nel negozio delle estensioni	è l'unica porta d'accesso alla sezione; non c'è un costo separato per il collegamento della scheda
Per la chiave personale — un endpoint compatibile con OpenAI	servono l'indirizzo (base URL con versione, solo `https`), la chiave API e l'id del modello
Il saldo IA — per i servizi pronti	funzionano tramite la nostra infrastruttura e si pagano con crediti IA in base all'utilizzo effettivo

Passo 1. Collegare un servizio IA pronto#

Il primo blocco della pagina è «Servizi IA Cenaly»: ChatGPT (OpenAI), Gemini (Google), Grok (xAI) e DeepSeek. Collegamento in un clic:

Premete «Collega» accanto al servizio desiderato — le chiavi API non servono, la richiesta passa attraverso la nostra infrastruttura.
Nel servizio collegato comparirà la riga «Modello» — scegliete un modello specifico dall'elenco del servizio (l'elenco è diverso per ciascuno e viene aggiornato di tanto in tanto).
Il servizio non necessario si disattiva con il pulsante «Disconnetti».

Il pagamento avviene con i crediti IA dell'account, come per qualsiasi altra funzione IA: non compare una fattura separata per il «collegamento di ChatGPT», si paga per le chiamate effettive.

Passo 2. Collegare la propria chiave#

Il secondo blocco è «LLM personalizzati». È per chi ha un proprio accesso al modello: un contratto personale con un provider, un gateway aziendale o un proprio modello distribuito con API compatibile con OpenAI.

«Aggiungi LLM personalizzato» e compilate: Nome (come lo riconoscerete), Base URL API — l'indirizzo insieme alla versione, ad esempio https://api.example.com/v1 (solo https), Chiave API, Modello — l'id del modello presso quel provider.
Premete «Verifica connessione» — partirà una richiesta di test e vedrete «Connessione attiva» con la misura della latenza oppure il motivo del rifiuto. La verifica funziona sia prima del salvataggio sia successivamente su un record già salvato.
«Aggiungi» — la connessione comparirà nell'elenco. Può essere temporaneamente disattivata con l'interruttore oppure eliminata (con conferma: insieme al record viene eliminata anche la chiave salvata).

Come viene conservata la chiave: si trova sul server e non viene restituita al browser — nell'interfaccia è visibile solo la dicitura «Chiave API salvata» e la maschera. La chiave può essere sostituita, ma non letta dal pannello.

Cosa succede con il denaro: per le chiamate con la vostra chiave i crediti IA non vengono addebitati — pagate direttamente al vostro provider. Ma se il vostro endpoint non ha risposto, la chiamata non fallisce: passa attraverso la normale coda della piattaforma — e quella chiamata viene conteggiata in crediti. Verificate la disponibilità del vostro endpoint se notate un consumo dove non ve lo aspettavate.

Le connessioni possono essere più di una (fino a dieci) — ad esempio, modelli diversi per esperimenti diversi; funzionano quelle con l'interruttore attivo.

Passo 3. Scegliere il modello preferito#

Il terzo blocco è «Modello preferito», un selettore per l'intero account:

«Per impostazione predefinita (consigliato in base all'attività)» — la piattaforma sceglie il modello da sé, separatamente per ogni funzione. È lo stato iniziale;
un servizio specifico o una connessione personalizzata — le funzioni assistente lo utilizzeranno in via prioritaria.

Ordine dei tentativi con una preferenza selezionata: prima il vostro endpoint personalizzato (se è quello preferito), poi la chiamata della piattaforma sul modello scelto, poi il normale percorso di riserva — affinché la funzione non «muoia» a causa di un singolo provider non disponibile.

⚠️ La scelta non vale in tutte le funzioni IA — dettagli nelle «Limitazioni».

Dove si vede il consumo#

Il consumo IA si trova nella pagina abbonamento, in due schede: «Crediti LLM» — il saldo residuo per le attività IA, e «Costi IA» — il consumo mensile per funzione, la previsione della fattura fino a fine mese e il tetto mensile. Dalle righe si vede quale funzione esattamente consuma: descrizioni, chiamate, traduttore, formazione.

Non ci saranno righe per le chiamate con la vostra chiave personale — tali chiamate non consumano il nostro saldo.

Limitazioni#

La scelta non ha effetto su cenaly.ru. Nel perimetro russo le funzioni di IA operano su YandexGPT e le impostazioni di questa sezione non vengono richieste: la pagina si aprirà e si salverà, ma non c'è nessuno che la applichi. È una conseguenza dei requisiti sul trattamento dei dati, non un'impostazione dimenticata.
La scelta non ha effetto sulle chiamate con strumenti. Alcune funzioni sono strutturate come «modello + strumenti» — il bot IA della chat ospiti, il copilota del pannello, il suggeritore di email in posta. Funzionano sul proprio modello indipendentemente da quanto scelto qui.
La sezione è solo per il proprietario. Un collaboratore non la vedrà nel menu e, tramite link diretto, otterrà una schermata di errore di caricamento con il pulsante «Riprova», non un cortese «accesso negato» — lo sappiamo, stiamo correggendo.
La chiave personalizzata non ha né scadenza né rotazione automatica. Se cambiate la chiave presso il provider, cambiatela anche qui, altrimenti le chiamate inizieranno a passare per la via di riserva (e a consumo di crediti).
Solo API compatibile con OpenAI e solo https. L'endpoint va indicato insieme alla versione del percorso; protocolli arbitrari e formati di risposta personalizzati non sono supportati.
Non conosciamo l'elenco dei modelli del vostro provider — l'id del modello va inserito manualmente, dalla documentazione del provider.
I servizi pronti sono quattro. ChatGPT, Gemini, Grok, DeepSeek; il resto — tramite connessione personalizzata.

Risoluzione dei problemi#

Sintomo	Verificate
«Verifica connessione» risponde con un errore	l'indirizzo deve essere completo, insieme alla versione (`…/v1`) e via `https`; la chiave deve essere valida; presso il provider deve essere aperto l'accesso da indirizzi esterni
La connessione c'è, ma le risposte arrivano «come prima»	la funzione può essere tra quelle che vanno fuori dalla scelta (chat-bot, copilota, suggeritore di posta); oppure l'account opera nel perimetro `cenaly.ru`
I crediti vengono consumati nonostante sia collegata la propria chiave	il vostro endpoint non risponde e le chiamate passano per la via di riserva. Verificate la connessione con il pulsante e controllate le righe in «Costi IA»
La chiave nel campo è mostrata con asterischi	è previsto così: la chiave è conservata sul server e non viene restituita. Se ne serve un'altra, inseritene una nuova
Il collaboratore vede «Impossibile caricare le impostazioni LLM»	la sezione è accessibile solo al proprietario dell'account
La pagina non si trova nel menu	lì non c'è: si accede solo dalla scheda «Modelli IA (LLM)» nello store delle estensioni

La disamina generale per sintomi è in risoluzione dei problemi; se nulla ha funzionato, scriveteci — come ottenere assistenza.

Domande frequenti#

Serve davvero entrare in questa sezione?#

No. Senza di essa tutto funziona: la piattaforma seleziona da sola il modello per ogni attività. La sezione serve se volete scegliere voi il modello o collegare la vostra chiave.

Serve la propria chiave OpenAI per usare l'IA?#

No. I servizi pronti si collegano con un clic e funzionano tramite la nostra infrastruttura, il pagamento avviene con i crediti IA dell'account. La propria chiave è un'alternativa, non un requisito.

La propria chiave costa meno?#

Dipende dal vostro contratto con il provider. Tecnicamente è «fuori dal nostro conto»: per tali chiamate i crediti IA non vengono addebitati e pagate direttamente al provider.

Chi vede la mia chiave API?#

Nessuno dall'interfaccia: la chiave viene scritta sul server e non torna al browser — vedrete solo l'indicazione che è stata salvata. La sezione è accessibile esclusivamente al proprietario dell'account.

Si possono scegliere modelli diversi per funzioni diverse?#

No, la preferenza è una sola per account. Modelli diversi per attività diverse sono proprio la modalità «predefinita», in cui sceglie la piattaforma.

Perché su `cenaly.ru` la scelta non funziona?#

Il perimetro russo opera su YandexGPT: i dati non escono dal perimetro, quindi provider esterni ed endpoint proprio non si collegano.

Cosa succede se il mio endpoint è temporaneamente non disponibile?#

La funzione non si rompe: la chiamata passerà per la coda ordinaria della piattaforma — e sarà conteggiata in crediti IA. Non ci sarà una perdita silenziosa della richiesta.

Quanto costa la scheda «Modelli IA» in sé?#

Non c'è un costo separato per il collegamento della scheda — pagate solo per l'utilizzo effettivo dei modelli tramite la nostra infrastruttura.

Sezioni correlate#

Abbonamento — le schede «Crediti LLM» e «Costi IA»: saldo, consumo per funzione e tetto mensile
Store delle app — l'unica porta verso la sezione «Modelli IA»
Base di conoscenza — scelta del provider IA per la costruzione della base e consenso al trattamento
Formazione dei collaboratori — quale modello raccoglie i materiali didattici e i compiti
Traduttore IA per l'ospite — una delle funzioni che consumano il saldo IA
Chat con gli ospiti — il bot IA che opera sul proprio modello indipendentemente da questa scelta
Posta e risponditore automatico IA — un'altra funzione «modello più strumenti» che va fuori da questa scelta
Come ottenere assistenza — se la connessione non supera la verifica