IA: gestita dalla Piattaforma o chiave propria (BYOK)

In IA decidi, provider per provider (OpenAI, Claude (Anthropic), Gemini (Google) e DeepSeek), se i tuoi clienti usano l’IA gestita dalla Piattaforma (il consumo viene detratto dal tuo wallet, Manuale 39) o una tua chiave di quel provider (BYOK: «Bring Your Own Key»). La schermata ha cinque schede: Modelli da usare, Chiavi, Prezzi, Negoziati e Margine.

4.1 Modelli da usare: quali modelli offri ai tuoi clienti

È il primo passaggio di tutto il resto: solo i modelli che attivi qui, provider per provider, diventano poi disponibili in Chiavi, Prezzi, Negoziati e nel selettore di modello dell’agente dei tuoi clienti (Manuale 23). Ogni gruppo di provider porta un distintivo con la tua situazione reale con esso:

• «Con la tua chiave»: usi una tua chiave di quel provider (paragrafo 4.2, sotto).
• «Con chiave della Piattaforma»: non hai una tua chiave di quel provider — i tuoi clienti usano la chiave della Piattaforma e il consumo viene detratto dal tuo wallet ai tuoi prezzi (Manuale 39, paragrafo 1); lo stesso gruppo del provider ripete l’avviso: «Il consumo viene addebitato dal tuo wallet ai tuoi prezzi».
• «Nessuna chiave configurata»: né tu né la Piattaforma avete ancora una chiave di quel provider pronta per il tuo account — puoi comunque attivare o disattivare i suoi modelli da qui.

Requisiti: solo il ruolo Proprietario può attivare o disattivare modelli; il resto del tuo team vede la schermata in sola lettura.

Attivare un modello è immediato — un altro interruttore, senza conferma. Disattivarlo chiede SEMPRE conferma, con l’effetto reale mostrato in anticipo: «Stai per disattivare [modello] di [provider]. I tuoi clienti smetteranno di vederlo nei loro agenti.»

Procedura: chiedere al supporto di attivare un modello che non vedi

1. In fondo a «Modelli da usare», premi «Richiedi al supporto» — chiunque nel tuo team può farlo, senza bisogno del permesso di Proprietario.
2. Si apre la finestra «Nuovo ticket» (la stessa del tuo stesso supporto, Manuale 42, paragrafo 3 «Il mio supporto») con l’Oggetto già scritto: «Attivazione modello IA». Completa la Descrizione con il modello di cui hai bisogno.
3. Premi Crea ticket.

Risultato: il pulsante viene sostituito dall’avviso «Ticket inviato. Il team di supporto lo esaminerà a breve.», e il ticket resta visibile nel tuo stesso supporto (Manuale 42, paragrafo 3) come qualsiasi altro.

4.2 Chiavi: una o più per provider

Puoi avere più chiavi dello stesso provider — per esempio, un «Account premium clienti» e un «Account economico» di OpenAI — e distribuirle tra i tuoi clienti secondo necessità. Ogni card di provider elenca le tue chiavi con il Nome che gli hai dato e una versione mascherata della chiave reale (per riconoscerla senza esporla), e offre Modello (fissa il modello predefinito di quella chiave) e un cestino per eliminarla.

Procedura: aggiungere una chiave

Requisiti: ruolo Proprietario — come attivare/disattivare modelli (paragrafo 4.1), il resto del tuo team vede Chiavi in sola lettura. Disponibile per OpenAI, Claude (Anthropic) e Gemini (Google) — DeepSeek non offre questo pulsante per ora (vedi l’avviso sotto).

1. Sulla card del provider, premi «+ Aggiungi chiave».
2. Scrivi il Nome — per identificare questa chiave se ne hai più di una dello stesso provider.
3. Incolla la Chiave API.
4. Premi Salva chiave.

Risultato: la chiave compare sulla card del suo provider, pronta per essere assegnata ai tuoi clienti. Se provi a eliminare una chiave ancora assegnata a un cliente, la console ti avvisa e non la elimina finché non rimuovi prima quell’assegnazione.

Il pulsante Modello di ogni chiave apre un selettore — non si scrive più il modello a mano: puoi scegliere solo tra i modelli che hai attivato per quel provider in Modelli da usare (paragrafo 4.1), con l’opzione «Nessun modello predefinito» se preferisci non fissarne nessuno. Se il modello che cerchi non compare nell’elenco, il selettore stesso te lo ricorda: «Non vedi un modello? Attivalo in Modelli da usare».

Avviso — DeepSeek: rimandato per ora

La card di DeepSeek porta il distintivo «Rimandato» e non offre il pulsante «+ Aggiungi chiave» — a differenza di OpenAI, Claude e Gemini, non puoi ancora dargli una tua chiave. Il testo della card stessa lo spiega: «DeepSeek è rimandato per ora: lo attiveremo quando saranno disponibili deployment ospitati nell’Unione Europea. Nel frattempo non si possono aggiungere chiavi di questo provider.» Questo non influisce su «Modelli da usare» (paragrafo 4.1): i suoi modelli continuano a comparire lì e puoi attivarli o disattivarli come quelli degli altri provider — l’unica cosa bloccata è la chiave propria.

4.3 Assegnazione ai clienti: quale chiave e modello usa ciascuno

In Assegnazione ai clienti, cerca il cliente per nome e, per ogni provider in cui hai una tua chiave, scegli la Chiave e il Modello che deve usare quel cliente specifico, e premi Salva. Un provider senza alcuna chiave propria mostra «Non hai ancora nessuna chiave propria di questo provider» invece del selettore.

Nota — Esempio: la stessa chiave, due clienti, due modelli diversi

Nulla ti obbliga a usare una chiave per un solo cliente o un solo modello. Puoi avere, per esempio, 4 chiavi distribuite tra i tuoi provider e assegnare la STESSA chiave OpenAI a due clienti diversi, ciascuno con il proprio modello — per esempio, un cliente con gpt-4o e un altro con gpt-4o-mini, entrambi sullo stesso «Account premium clienti».

4.4 Prezzi: cosa fai pagare ai tuoi clienti

Fissa il prezzo che fai pagare ai tuoi clienti per ogni modello. Accanto, in «Cosa ti addebita la Piattaforma», hai il tuo elenco di riferimento — il prezzo che il tuo contratto ti dà già, il tuo riferimento di margine, mai modificabile da qui.

Procedura: fissare un prezzo di rivendita

1. In «Il tuo listino di rivendita», premi «+ Nuovo prezzo».
2. Scegli il Provider e il Modello — entrambi sono selettori: il Modello si compila con i modelli che hai attivato per quel provider in Modelli da usare (paragrafo 4.1); se non vedi quello che cerchi, il suggerimento «Non vedi un modello? Attivalo in Modelli da usare» ti porta direttamente a quella scheda — e la Valuta (EUR per impostazione predefinita).
3. Scrivi il Prezzo di input e il Prezzo di output, entrambi per 1M di token.
4. Premi Continua.
5. Rivedi il riepilogo — «Stai per fissare X €/Y € per 1M token per [provider] · [modello], da adesso» — e premi Conferma.

Risultato: il prezzo diventa vigente da quel momento e compare in «Il tuo listino di rivendita». Il link «Cronologia» di ogni riga apre le versioni precedenti con la loro data di vigenza.

4.5 Negoziati: un prezzo speciale per un cliente specifico

Se concordi condizioni diverse con un cliente specifico (per volume, per contratto…), fissa un prezzo negoziato solo per lui — distinto dal tuo listino di rivendita generale — con una nota che documenta l’accordo.

Procedura: negoziare un prezzo

1. Cerca il cliente e premi «+ Negozia prezzo».
2. Scegli Provider, Modello e Valuta — Provider e Modello sono selettori alimentati da ciò che hai attivato in Modelli da usare (paragrafo 4.1), con lo stesso suggerimento «Non vedi un modello? Attivalo in Modelli da usare» se te ne manca uno; la Valuta deve corrispondere alla valuta del contratto di QUEL cliente perché il prezzo possa applicarsi.
3. Scrivi il Prezzo di input e il Prezzo di output (per 1M token).
4. Scrivi la Nota — il riferimento dell’accordo; è obbligatoria, non puoi continuare senza di essa.
5. Premi Continua e poi Conferma.

Risultato: la tabella dei negoziati di quel cliente mostra provider, modello, i due prezzi e la tua nota, con il proprio link «Cronologia».

Nota — Se scegli la valuta sbagliata

Questo modulo non convalida contro il contratto reale del cliente: se la valuta non corrisponde a quella del suo contratto, il prezzo negoziato semplicemente non arriva mai ad applicarsi (non dà mai un errore) — verifica prima la valuta del cliente.

4.6 Margine: cosa fatturi rispetto a cosa ti addebita la Piattaforma

Margine confronta, per il Periodo e il Raggruppamento (Modello o Cliente) che scegli: ciò che hai Fatturato ai tuoi clienti, ciò che Ti addebita la Piattaforma, il Tuo margine e la % di margine — tutto nella tua valuta di contratto.

Avviso — Qui non vedi mai il costo reale della Piattaforma — solo ciò che ti addebita

Questa vista mostra ciò che TU fatturi e ciò che la Piattaforma addebita A TE — mai il costo reale che comporta per la Piattaforma fornire il servizio. Se un cliente usa una tua chiave (BYOK), quella riga porta il distintivo «Con la tua chiave propria» e «Ti addebita la Piattaforma» resta a 0 € — perché quel consumo non passa mai dalla Piattaforma: lo paga il tuo provider di IA, con la tua fatturazione OpenAI/Claude/Gemini/DeepSeek, fuori da questa console.

Se qualche consumo non ha ancora un prezzo di rivendita fissato (paragrafo 4.4), la tabella lo segnala con un avviso di «Fallback» — finché non fissi quel prezzo, quel consumo continua comunque a esserti fatturato, ma senza che tu possa vederlo scomposto come tuo margine.

4.7 Permettere ai tuoi clienti la chiave propria (diverso dalla TUA chiave propria)

È un’altra scheda di questa schermata, «Clienti con chiave propria» — non confonderla con «Chiavi» (paragrafo 4.2, sopra): lì configuri la TUA chiave propria per rivenderla ai tuoi clienti attraverso il tuo wallet. Qui decidi se i tuoi clienti possono configurare la loro propria e completamente indipendente — senza passare né dal tuo wallet né dalla tua chiave, esattamente come la scheda «Provider IA proprio» della loro Piattaforma (Manuale 76).

L’interruttore «Permetti ai miei clienti di usare la propria chiave di provider IA» si trova in questa scheda, con una spiegazione semplice e la data dell’ultima modifica (o «Non ancora modificato» se non l’hai mai toccato). Solo il ruolo Proprietario può cambiarlo; il resto del tuo team lo vede in sola lettura.

Procedura: attivare o disattivare la chiave propria per i tuoi clienti

1. In IA → Clienti con chiave propria, fai clic sull’interruttore.
2. Se lo stai disattivando, conferma nella finestra di avviso: «I clienti che hanno già salvato la propria chiave smetteranno di usarla immediatamente e torneranno al provider della piattaforma. La loro chiave salvata non viene eliminata: potranno tornare a usarla se riattivi questa impostazione.»

Risultato: attivarlo NON accende la funzione per tutti i tuoi clienti in una volta sola — la abilita solo come opzione. L’attivazione EFFETTIVA, cliente per cliente, avviene poi nella copia del suo piano (paragrafo 4.8, oppure chiedi al supporto di attivarla se la tua console non ti permette di modificarla). Disattivarlo, invece, HA effetto immediato su tutti i clienti che l’avevano già configurata.

4.8 Ripartizione IA per cliente

Nella tua schermata Clienti (Manuale 38), ogni riga può essere espansa con «Ripartizione IA»: la stessa suddivisione Piattaforma / Chiave propria / Riserva che vedi aggregata in «Margine» (paragrafo 4.6), ma di UN cliente specifico. Accanto alla ripartizione, un indicatore ti dice se quel cliente ha attivata la capacità «Provider IA proprio» — quella che hai abilitato con l’interruttore del paragrafo precedente.

Se hai bisogno di attivarla o disattivarla per un cliente specifico, aprilo e modifica la copia del suo piano — troverai lì la riga «Provider IA proprio», come il resto delle sue capacità (stesso meccanismo del Manuale 38).

Nota — «Chiave propria» in questa ripartizione è SEMPRE quella del cliente stesso

Non confonderla con il distintivo «Con la tua chiave propria» di «Margine» (paragrafo 4.6): quella riga riguarda LA TUA chiave (quella che rivendi loro). Questa ripartizione per cliente, invece, suddivide ciò che QUEL cliente specifico consuma con Piattaforma / la propria chiave (la sua, configurata sulla propria Piattaforma) / Riserva — due cose distinte che possono coesistere nello stesso cliente.