Prima di iniziare
- Un account su platform.openai.com, con la fatturazione attiva e del credito.
- Il permesso «Fatturazione (Account)». Senza, i riquadri della chiave non compaiono, né sull'account né sui workspace né sugli agenti.
#Cos'è e cosa cambia
La chiave OpenAI è un codice segreto che collega SupportFast al tuo account OpenAI. Senza una tua chiave, l'AI è compresa nel piano e usa il servizio di SupportFast.
| Cosa | Senza chiave propria | Con la tua chiave |
|---|---|---|
| Modello AI | Sempre il modello predefinito | Scegli il modello nel Playground dell'agente chat e nei nodi AI delle automazioni |
| Storico | Al massimo gli ultimi 5 messaggi | Scegli quanti messaggi della conversazione considerare |
| Messaggi AI e costo | Compresi nel piano: scalano dalla quota mensile | Non scalano dal piano: li paghi a OpenAI, sul conto della chiave |
| Messaggi vocali nel widget | Non compresi | Compresi: l'agente risponde leggendo la trascrizione |
| Vocali su WhatsApp, Instagram e Messenger, con Ricezione e Trascrizione Audio accesa nel canale | Li ascolti in console e rispondi tu | Vengono trascritti e l'agente risponde |
Cosa non cambia. Minuti di chiamata, esecuzioni, invii, agenti, utenti e le altre quote restano quelle del piano. Vedi Come si contano i consumi.
#Cosa usa la tua chiave
Con la chiave passano dal tuo conto OpenAI:
- le risposte dell'agente chat, su ogni canale;
- l'allenamento e la ricerca nella conoscenza;
- la trascrizione dei messaggi vocali;
- i nodi AI delle automazioni;
- il riepilogo e la traduzione nelle Conversazioni;
- la profilazione automatica dei contatti;
- per l'agente vocale, la generazione del prompt e l'analisi dopo la chiamata: esito, riepilogo e dati estratti.
#Quale chiave vale
Di solito basta una chiave sull'account, che vale per tutto. Se vuoi tenere separati dei costi, puoi mettere una chiave diversa su un workspace o su un singolo agente chat: vale la più vicina all'agente.
L'agente vocale e i nodi AI delle automazioni usano la chiave del workspace o dell'account. Per trascrivere i vocali dei canali vale la chiave dell'agente chat che risponde, se ne ha una; altrimenti quella del workspace o dell'account.
#Creare la chiave su OpenAI
- Entra nel pannello di OpenAI
Accedi a platform.openai.com con il tuo account OpenAI, oppure creane uno.
- Attiva la fatturazione
Aggiungi un metodo di pagamento e carica del credito. Senza credito la chiave non funziona.
- Crea la chiave
Ti consigliamo un progetto dedicato a SupportFast. Crea una nuova chiave segreta e dalle un nome riconoscibile, per esempio «SupportFast».
- Copiala intera
Copia la chiave, che comincia con
sk-, e tienila in un posto sicuro finché non la inserisci.
Permessi della chiave. Se su OpenAI limiti i permessi della chiave, lasciale l'accesso ai modelli per la chat e per la ricerca nella conoscenza.
#Inserire la chiave
A ogni livello la console controlla la chiave in un momento diverso:
| Dove | Quando viene provata su OpenAI | Se OpenAI la rifiuta |
|---|---|---|
| Account | Con Prova e salva, prima di salvarla. | Non viene salvata. |
| Workspace | Mai: si salva così com'è. | Te ne accorgi solo perché gli agenti non rispondono. Provala subito dopo il salvataggio, come spiegato qui sotto. |
| Agente chat | A ogni salvataggio della scheda Generali, anche se cambi altro. | Non si salva niente della scheda, nemmeno le altre modifiche. |
#Sull'account
Vale per tutti i workspace e gli agenti che non hanno una chiave propria.
- Apri la scheda della chiave
Vai in AccountAbbonamento e scorri fino alla scheda «Chiave OpenAI». In alternativa premi «Inserisci la chiave per messaggi illimitati» sulla scheda «Messaggi AI»: illimitati vuol dire senza il limite del piano, perché li paghi tu sul tuo conto OpenAI.
- Incolla la chiave
Incollala nel campo Chiave OpenAI. L'occhio Mostra la chiave la mostra per intero.
- Prova e salva
Premi Prova e salva. La console prova la chiave su OpenAI e la salva solo se funziona: compare «Chiave OpenAI salvata».
Risultato
Sulla scheda «Messaggi AI» compare «Chiave OpenAI inserita».
Una chiave rifiutata da OpenAI non viene salvata e leggi «La chiave non funziona: controlla di averla copiata intera e di aver attivato la fatturazione su platform.openai.com.».
#Su un workspace
Vale per gli agenti di quel workspace che non hanno una chiave propria.
- Apri le impostazioni del workspace
Vai nelle Impostazioni del workspace e trova la scheda «Chiave OpenAI».
- Spegni la chiave dell'account
Spegni Usa la chiave API dell'Account principale: compare il campo per la chiave.
- Incolla la chiave
Incollala nel campo Chiave OpenAI.
- Salva e prova
Premi Salva modifiche nella barra in basso. Qui la console non prova la chiave: apri subito un agente del workspace con il link della chat. Se risponde, la chiave funziona.
#Su un agente chat
Vale solo per quell'agente. Serve a separare i costi, per esempio di un cliente o di un progetto.
- Apri il Profilo Agente
Vai in Agente chatProfilo AgenteGenerali, riquadro «Chiave OpenAI».
- Spegni la chiave del workspace e incolla la tua
Spegni Usa la chiave del workspace e incolla la chiave nel campo Inserisci chiave API che compare.
- Salva
Premi Salva modifiche. A ogni salvataggio della scheda la console prova la chiave su OpenAI. Se viene rifiutata, sul campo leggi «OpenAI non ha accettato questa chiave: controllala e riprova.» e non si salva niente, nemmeno le altre modifiche.
Una chiave dell'agente che smette di funzionare blocca la scheda Generali. Se è finito il credito o hai revocato la chiave, nessuna modifica della scheda si salva, anche se riguarda altro. Per sbloccarla ricarica il credito, incolla una chiave che funziona, oppure riaccendi Usa la chiave del workspace e salva.
#Se la chiave smette di funzionare
Una chiave può smettere di funzionare quando finisce il credito su OpenAI o quando la revochi. Finché non la sistemi, gli agenti che la usano non rispondono ai clienti e gli allenamenti nuovi falliscono.
Tieni d'occhio il credito. Nel pannello di OpenAI imposta un limite di spesa e un avviso via email.
Per ripartire, ricarica il credito oppure crea una chiave nuova e inseriscila al posto della vecchia. Poi rilancia gli allenamenti falliti con ⋮Riesegui allenamento: vedi Allenamento: come funziona.
#Togliere la chiave
- Account. Nella scheda «Chiave OpenAI» premi Rimuovi e conferma. La chiave viene tolta subito e i messaggi AI tornano a scalare dal piano.
- Workspace. Riaccendi Usa la chiave API dell'Account principale e salva: la chiave del workspace viene tolta.
- Agente. Riaccendi Usa la chiave del workspace e salva: la chiave dell'agente viene tolta.
Togliere la chiave da un livello non cambia gli altri: agenti e workspace con una chiave propria continuano a usarla.
Togliere la chiave da SupportFast non la disattiva su OpenAI. Se non ti serve più, revocala anche dal pannello di OpenAI.
#Privacy
Con la tua chiave, i dati che l'AI elabora arrivano a OpenAI attraverso il tuo account OpenAI. Su quei dati valgono quindi anche i termini che hai accettato con OpenAI, compreso il suo accordo sul trattamento dei dati: controllali prima di inserire la chiave. Come SupportFast tratta i dati per tuo conto lo dicono l'accordo sul trattamento dei dati (DPA) e l'elenco dei sub-responsabili: vedi Documenti legali e Privacy e sicurezza. Per un dubbio sul tuo caso, chiedi al tuo consulente privacy.
Non mandare la chiave via email o in chat, nemmeno a noi. Se è finita in mani sbagliate, revocala su OpenAI e inserisci quella nuova.
#Domande frequenti
Posso usare la chiave di un altro fornitore di AI?
No. SupportFast accetta solo chiavi OpenAI.