Quartz 4

AI Assistant (Chat)

4 min read

DD-AI-ASSISTANT.md

Versione: 1.0 Data: 2025-10-12 Documento Principale: FIRE 25.07 - ARCHITECTURE-OVERVIEW Scopo: Fornire una guida utente completa per la configurazione e l’utilizzo della funzionalità “AI Assistant (Chat)” in FIRE.

1. Filosofia: Chatta con la Tua Conoscenza

L‘“AI Assistant” di FIRE non è una semplice chatbot generica. È un potente sistema RAG (Retrieval-Augmented Generation), progettato per permetterti di “conversare” direttamente con i tuoi documenti e dati.

In parole semplici:

  1. Tu fornisci a FIRE una cartella di documenti (note, analisi, report, articoli). Questa diventa la tua “Knowledge Base” (Base di Conoscenza).
  2. FIRE “studia” questi documenti e ne crea un indice intelligente.
  3. Quando fai una domanda, l’AI prima cerca le informazioni più pertinenti all’interno della tua Knowledge Base e poi usa quelle informazioni per formulare una risposta precisa e contestualizzata.

Questo ti permette di usare l’AI come un vero assistente di ricerca personale, garantendo che le risposte siano basate sui tuoi dati e non solo sulla conoscenza generica del modello.

2. Configurazione Iniziale: I 3 Passi Fondamentali

Per usare l’assistente, sono necessari tre passaggi di configurazione.

Passo 1: Configurare il Server AI Locale

L’assistente richiede un modello linguistico (LLM) in esecuzione sul tuo computer. Questo garantisce la massima privacy. La soluzione consigliata è LM Studio.

  1. Scarica e installa LM Studio.
  2. Dalla schermata principale, cerca e scarica un modello orientato al codice (es. CodeLlama, Deepseek Coder, Phind CodeLlama).
  3. Vai alla sezione “Local Server” (icona <-> a sinistra).
  4. Seleziona il modello che hai scaricato e clicca su “Start Server”.

Una volta avviato, avrai un server AI in esecuzione, tipicamente all’indirizzo http://localhost:1234/v1.

Passo 2: Configurare FIRE

Ora devi dire a FIRE come trovare il tuo server AI e la tua Knowledge Base.

  1. Avvia FIRE e vai su Tools → Settings….
  2. Configura la Knowledge Base:
    • Vai alla tab “Data Sources”.
    • Nella sezione “Local Data & AI Knowledge Base”, clicca su “Select Folder…” e scegli la cartella sul tuo computer che contiene i documenti che vuoi che l’AI “studi”.
  3. Configura il Server AI:
    • Vai alla tab “AI Tools”.
    • In “AI Server URL”, inserisci l’indirizzo del tuo server locale (es. http://localhost:1234/v1).
    • In “Model Name”, puoi cliccare “Refresh Models” per caricare la lista dei modelli disponibili dal server e selezionarne uno.
  4. Clicca “Ok” per salvare le impostazioni.

Passo 3: Indicizzare la Knowledge Base

L’ultimo passo è dire a FIRE di “leggere” e indicizzare i documenti che hai scelto.

  1. Vai alla tab principale “AI Assistant (Chat)“.
  2. Lo status in alto a destra dovrebbe ora mostrare “Status: Not Indexed”.
  3. Clicca sul pulsante “Index Knowledge Base”.
  4. Attendi il completamento del processo. A seconda della quantità di documenti, potrebbe richiedere da pochi secondi a diversi minuti.
  5. Al termine, lo status cambierà in “Status: Ready”.

Sei pronto! L’AI Assistant è ora configurato e pronto a rispondere alle tue domande.

3. Workflow di Utilizzo

Una volta completata la configurazione, l’utilizzo è semplice:

  1. Fai una Domanda: Digita la tua domanda nella casella di testo in fondo alla tab “AI Assistant (Chat)” e premi Invio o clicca “Send”.
  2. Analizza la Risposta: L’AI fornirà una risposta basata sulla tua Knowledge Base.
  3. Controlla le Fonti: Se la risposta è basata su informazioni recuperate dai tuoi documenti, sotto la risposta apparirà una sezione “Sources” con i link ai file specifici che sono stati utilizzati. Puoi cliccare su questi link per aprire i documenti originali.

Esempio Pratico:

  1. Configurazione: Imposti come Knowledge Base una cartella contenente un file note.txt con il testo: “La mia strategia principale si basa su un incrocio di medie mobili a 20 e 50 periodi.”
  2. Indicizzazione: Clicchi su “Index Knowledge Base”.
  3. Domanda: Chiedi all’assistente: “Qual è la mia strategia principale?”
  4. Risposta (attesa): L’AI risponderà qualcosa come: “La tua strategia principale si basa su un incrocio di medie mobili a 20 e 50 periodi.” E sotto, linkerà il file note.txt come fonte.

Graph View