Configurare l'Assistente AI

L'assistente AI di GENKAI conosce i documenti della tua avventura e risponde alle domande basandosi su quelli. Puoi usarlo tu dalla Console, oppure attivarlo su Telegram perché i giocatori possano fare domande direttamente al bot.

Quota gratuita

Ogni installazione include circa 250 domande gratuite senza bisogno di configurare nulla. La quota usa il modello GPT-5 mini ed è una tantum (non si rinnova mensilmente).

Per usare la quota gratuita serve un account: vai in Impostazioni → Account e registrati con email e password. L'account è gratuito.

Puoi verificare quanta quota ti rimane in Impostazioni → AI → "Verifica quota".

Chiave API (opzionale)

Quando la quota gratuita finisce, puoi inserire la tua chiave API per continuare senza limiti. Sono supportati due provider:

1. Vai su Impostazioni → AI
2. Scegli il provider (OpenAI o Anthropic)
3. Incolla la tua chiave API nel campo apposito
4. Clicca "Verifica" per confermare che la chiave funziona
5. Scegli il modello che preferisci dal menu a tendina

Effort (solo Anthropic)

Con Anthropic puoi regolare la profondità di ragionamento dell'AI:

• Low — risposte veloci, meno ragionamento
• Medium — bilanciato (consigliato)
• High — massima intelligenza, più lento

Usare l'AI dalla Console

Nella Console (pannello in basso al centro) c'è un tab dedicato all'AI. Scrivi una domanda e l'AI cerca nei tuoi documenti per rispondere.

Il contatore token mostra quanti token stai consumando per ogni risposta e per l'intera sessione.

AI su Telegram per i giocatori

Questa è una delle funzioni più potenti: i giocatori possono fare domande all'AI direttamente su Telegram, e l'AI risponde basandosi solo sui documenti che tu hai autorizzato per quel giocatore.

1. Vai in Impostazioni → AI
2. Attiva "Abilita risposte AI su Telegram"
3. Scegli la modalità:
   • Manuale — i giocatori chiedono con il comando /ai domanda
   • Automatico — l'AI risponde a ogni messaggio dei giocatori

Documenti filtrati per giocatore

Puoi controllare con precisione cosa l'AI "sa" quando risponde a ciascun giocatore:

• Documenti comuni — visibili a tutti i giocatori (es. regole del mondo, luoghi pubblici)
• Documenti per personaggio — visibili solo a quel giocatore (es. il background segreto del suo personaggio)

1. Vai in Impostazioni → Personaggi
2. Per ogni personaggio, clicca "Aggiungi documento"
3. Seleziona i file .md, .html, .htm o .txt che quel giocatore può "conoscere"
4. Usa il toggle per attivare o disattivare singoli documenti (utile per rivelare informazioni gradualmente)

Consigli d'uso

• Documenti ben scritti = risposte migliori — l'AI risponde meglio se i documenti sono chiari e organizzati
• Usa la modalità manuale all'inizio — così vedi come i giocatori usano l'AI prima di passare all'automatico
• Rivela gradualmente — disattiva i documenti con informazioni future e attivali quando la storia progredisce
• Controlla i token — il contatore ti aiuta a capire quanto stai consumando, specialmente con chiave API propria