AI - Approfondimenti

Chiavi API AI

Configurazione e gestione delle chiavi API per provider AI (ChatGPT e Google Gemini) in Laundry ERP

Chiavi API AI

Le impostazioni dell'applicazione AI di Laundry ERP permettono di controllare quale provider AI utilizzare, gestire le credenziali API e definire i prompt predefiniti. Laundry ERP supporta sia Google Gemini che OpenAI (ChatGPT) come provider nell'applicazione AI.

Alcune funzionalità AI possono essere utilizzate senza l'app AI installata. Tuttavia, per utilizzare credenziali API personalizzate o modificare il provider AI per un agente specifico, l'app deve essere installata.

Importante: Le chiavi API sono obbligatorie per i database Odoo.sh o on-premise che vogliono utilizzare funzionalità AI.Per gli utenti Odoo Online, l'aggiunta di proprie chiavi API non è obbligatoria. Tuttavia, alcune organizzazioni potrebbero preferire utilizzare le proprie chiavi per un maggiore controllo su permessi, aggiornamenti di versione o conformità alle policy interne.

Creare una Chiave API per ChatGPT

Per creare una chiave API per ChatGPT, visitare la pagina delle chiavi API di OpenAI. Cliccare su Login e inserire le credenziali dell'account OpenAI.

Nella pagina API Keys, cliccare su Create new secret key.

Si apre il popup Create new secret key. Selezionare il proprietario della nuova chiave:

  • You: la chiave è legata all'account utente e può effettuare richieste verso il progetto selezionato. Se l'utente viene rimosso dall'organizzazione o dal progetto, questa chiave viene disabilitata.
  • Service account: crea un nuovo membro bot (service account) del progetto. La chiave è associata al membro bot.

Successivamente, inserire un Name per questa chiave (opzionale ma consigliato). Quindi selezionare il Project dal menu a tendina. Infine, selezionare i Permissions appropriati.

Impostare i Permissions su Restricted richiede di configurare individualmente i permessi di lettura e scrittura per molteplici risorse. Per maggiori informazioni, consultare la documentazione OpenAI Platform.

Cliccare su Create secret key. Nel popup risultante, cliccare su Copy per copiare la nuova chiave.

Attenzione: Una volta chiuso questo popup, la chiave non potrà essere visualizzata nuovamente. Se viene persa, sarà necessario crearne una nuova.

Tornare a Laundry ERP e navigare in App AI → Configurazione → Impostazioni. Nella sezione Provider, spuntare la casella Usa il tuo account ChatGPT e incollare la nuova chiave nel campo Key. Cliccare Salva al termine.

Creare una Chiave API per Google Gemini

Per creare una chiave API per Google Gemini, visitare Google AI Studio - API Keys. Inserire le credenziali dell'account Google e cliccare Next per aprire Google AI Studio. Nell'angolo in alto a destra, cliccare su Create API Key.

Nel popup Create a new key, inserire un titolo nel campo Name your key. Successivamente, utilizzare il menu a tendina Choose an imported project per selezionare un progetto o importarne uno nuovo. Cliccare su Create key.

Nella pagina API Keys, trovare la chiave appropriata e cliccare sull'icona di copia.

Tornare a Laundry ERP e navigare in App AI → Configurazione → Impostazioni. Nella sezione Provider, spuntare la casella Usa il tuo account Google Gemini e incollare la nuova chiave nel campo Key. Cliccare Salva al termine.

Costi e Tariffe

L'utilizzo di chiavi API per AI può comportare costi aggiuntivi tramite il provider. I costi esatti dipendono dal modello AI utilizzato e dal tipo di account con ciascun provider.

Tariffe ChatGPT

Per informazioni aggiuntive sui prezzi di ChatGPT, visitare OpenAI API Pricing.

Tariffe Google Gemini

Per informazioni aggiuntive sui prezzi di Google Gemini, visitare Gemini API Pricing.

Utilizzo in Lavanderia Industriale

Esempi di Consumo API

Scenario 1 - Live Chat Clienti:

  • Una lavanderia con 50 conversazioni/giorno tramite live chat AI
  • Media 10 messaggi per conversazione
  • Costo stimato: ~$15-30/mese (varia per provider e modello)

Scenario 2 - Automazione Documenti:

  • Classificazione automatica di 200 documenti/giorno (DDT, fatture, ordini)
  • Generazione descrizioni per 50 nuovi articoli/mese
  • Costo stimato: ~$10-20/mese

Scenario 3 - Trascrizioni Riunioni:

  • 3 riunioni settimanali di 1 ora ciascuna
  • Trascrizione + riassunto automatico
  • Costo stimato: ~$5-10/mese
Suggerimento: Iniziare con il piano gratuito di Odoo Online per testare le funzionalità AI. Passare a chiavi API personalizzate solo quando i volumi giustificano il controllo diretto e i costi sono prevedibili.

Best Practices

Sicurezza delle Chiavi

  • Non condividere le chiavi API in repository pubblici o comunicazioni non sicure
  • Rotazione periodica: Cambiare le chiavi ogni 3-6 mesi per sicurezza
  • Permessi minimi: Configurare permessi API solo per le risorse strettamente necessarie
  • Monitoraggio utilizzo: Controllare regolarmente dashboard del provider per rilevare anomalie

Ottimizzazione Costi

  • Caching: Laundry ERP memorizza temporaneamente risposte per richieste simili
  • Modelli appropriati: Usare modelli più economici per task semplici (es. classificazione documenti)
  • Limiti di utilizzo: Configurare alert nel dashboard del provider per evitare sorprese
Nota sulla Privacy: I dati inviati ai provider AI (OpenAI, Google) sono soggetti alle loro policy. Per informazioni sensibili, valutare soluzioni on-premise o policy di data retention specifiche.