OKNote
Per iniziare

🤖 Guida alla Configurazione dell'IA

L'IA attraversa quasi tutti i moduli di OKNote: riepiloghi delle note, traduzione, generazione di grafici, digest della posta, bozze di risposta IA, report settimanali e mensili... condividono tutti un'unica configurazione. Configurala una volta, sblocca tutto, con una sola chiave API di un provider di modelli.

1. Tre minuti per configurarla

Apri Impostazioni (⌘,) → Configurazione IA:

  1. Scegli un provider: il menu a tendina ha preset per i provider principali —

    Tipo Provider
    Basati in Cina DeepSeek, Zhipu GLM, Kimi (Moonshot), Qwen (Alibaba), Doubao (Volcengine), SiliconFlow, Tencent Hunyuan, Baidu Ernie
    Internazionali OpenAI, Anthropic Claude, Google Gemini, xAI Grok, OpenRouter, Mistral, Groq
    Locali / personalizzati Ollama, LM Studio, Custom (qualsiasi endpoint compatibile con OpenAI)

    Una volta scelto, il Base URL si compila automaticamente — di solito non serve toccarlo.

  2. Inserisci la tua chiave API: incolla la chiave generata sul sito del provider (procedura più sotto).

  3. Scegli un modello: il campo suggerisce i modelli consigliati da quel provider — basta cliccarne uno.

  4. Clicca su "Verifica": una connessione riuscita mostra la risposta del modello e la latenza; se fallisce, controlla la chiave e il credito del tuo account.

  5. Salva. Fatto!

🔒 La tua chiave API è salvata sul tuo server, crittografata con AES-256 — non viene mai inviata a terzi.

2. Come ottenere una chiave API

Il flusso è più o meno lo stesso ovunque: registrati sul sito del provider → apri la console sviluppatori/API → crea una chiave API → copiala. Due esempi:

DeepSeek (ottimo rapporto qualità-prezzo, molto diffuso in Cina)

  1. Vai su platform.deepseek.com, registrati e accedi.
  2. Nel menu a sinistra apri "API Keys" e clicca su "Create API Key".
  3. Copia la chiave generata (inizia con sk-, mostrata una sola volta) — ricarica una piccola somma e dura a lungo.

OpenAI

  1. Vai su platform.openai.com, accedi e apri "API keys".
  2. Clicca su "Create new secret key", poi copiala e salvala.

Zhipu (open.bigmodel.cn), Kimi (platform.moonshot.cn), Qwen (la console Bailian di Alibaba Cloud) e altri funzionano allo stesso modo — crea una chiave API nella pagina "API Keys" della loro piattaforma sviluppatori.

Ollama, modelli locali (completamente gratuiti, i dati non lasciano mai il tuo dispositivo)

  1. Installa Ollama sul tuo server (o sul tuo dispositivo) — scaricalo da ollama.com.
  2. Esegui ollama pull qwen3 (o qualsiasi modello preferisci) da terminale.
  3. In OKNote, scegli "Ollama (locale)" come provider. Il Base URL è predefinito su http://localhost:11434, nessuna chiave API necessaria — inserisci solo il nome del modello scaricato e verifica.

Nota: i modelli locali (Ollama / LM Studio), i provider personalizzati e la configurazione di più provider sono funzioni avanzate legate al livello della tua licenza; se un'opzione mostra un'icona di lucchetto, non è inclusa nel tuo piano attuale.

3. Avanzato: un'IA diversa per ogni modulo

Le Impostazioni hanno un interruttore "Configurazione per modulo" (legato al livello di licenza). Attivalo per impostare provider/modelli separati per:

  • IA Note/Report — riepiloghi delle note, traduzione, grafici, report settimanali/mensili delle attività
  • IA Posta — riepiloghi della posta, classificazione, bozze di risposta IA

Uno schema comune: usa un modello potente per note/report (la qualità conta per i report settimanali), e un modello economico e veloce per i riepiloghi della posta (qui conta di più il volume). Lasciarlo disattivato e condividere un'unica configurazione funziona bene comunque.

Per i team, l'amministratore può anche condividere la propria configurazione IA con tutti i membri, così nessun altro deve procurarsi una propria chiave.

4. Una volta configurata, dove si usa? — la mappa completa delle funzioni IA

Modulo Funzione Dove
Note Riepiloga / estrai tag / traduci in inglese / traduci in giapponese / genera grafici / domande libere Apri una nota qualsiasi, clicca sul pulsante fluttuante ✨ in basso a destra per aprire il pannello IA
Note Inserisci la risposta dell'IA nella nota Clicca su "Inserisci nella nota" nel pannello IA
Posta Riepilogo IA (categorizzazione e digest della posta in blocco) Barra laterale posta → Viste intelligenti → Riepilogo IA
Posta Bozza di risposta IA (con istruzioni personalizzate) Apri un'email → "Bozza di risposta IA"
Attività Creazione rapida di attività (linguaggio naturale / voce) Pulsante IA fluttuante, in basso a destra nella vista Calendario
Attività Generazione report settimanali/mensili IA Vista Report → "Genera report"

Merita una menzione speciale la modalità "Chat" del pannello IA delle note: risponde usando il contenuto della nota corrente come contesto — apri una lunga nota di riunione e chiedi semplicemente "cosa devo seguire dopo?". "Genera grafico" può trasformare direttamente i dati presenti in una nota in un grafico a barre, a linee o a torta e inserirlo nel corpo del testo.

5. Domande frequenti

  • Una funzione IA dice "non configurata"? Torna in Impostazioni → Configurazione IA, completa la configurazione e supera la verifica; se la configurazione per modulo è attiva, controlla che anche il modulo interessato (Note o Posta) sia configurato.
  • La verifica della connessione fallisce? Controlla, in ordine: che la chiave sia stata copiata per intero, che l'account del provider abbia credito e che la rete del tuo server possa raggiungere l'endpoint API del provider.
  • Vuoi cambiare modello? Cambia il nome del modello nelle impostazioni e salva — ha effetto immediato.

Le ultime due guide sono configurazioni avanzate per amministratori: "🔑 Dopo l'acquisto: attiva la licenza su questo server" e "🌐 Accesso pubblico: il tuo dominio + Cloudflare". Saltale se non ti riguardano.