Assistente AI

MotioForge Studio include un assistente conversazionale che risponde a domande sull'uso del software, sulla configurazione hardware e sulla risoluzione di problemi. L'assistente conosce l'intera documentazione e può leggere automaticamente il log della sessione corrente per dare risposte contestuali agli errori.

Come aprire l'assistente

Premi F2 da qualsiasi finestra di MotioForge Studio.
Clicca il pulsante Chiedi all'AI nella finestra di guida (F1).
Dal menu Aiuto → Chiedi all'AI.

Cosa può rispondere

Come si configura un dominio, una porta o un elemento.
Come si crea e modifica un'animazione sulla timeline.
Che cosa significa un messaggio di errore o di avviso.
Come risolvere un problema di connessione o di playback.
Idee e suggerimenti su possibili applicazioni del sistema.

Nota: L'assistente risponde solo a domande pertinenti a MotioForge Studio e all'animatronica. Non fornisce assistenza su programmazione, codice sorgente o argomenti non legati al sistema.

Backend disponibili

L'assistente supporta due motori AI, selezionabili in Preferenze → Assistente AI:

Backend	Costo	Requisiti	Privacy
Ollama (locale)	Gratuito	Ollama installato sul PC + modello scaricato (~2–4 GB)	Nessun dato esce dalla rete locale
Claude API (Anthropic)	A carico dell'utente (frazioni di cent per sessione)	Account Anthropic e API key personale	Dati inviati ai server Anthropic

Nota: se nel campo API key Claude è presente una chiave, MotioForge Studio usa Claude automaticamente, qualunque sia il backend selezionato.

Configurare Ollama (gratuito, locale)

Ollama è un programma open source che esegue modelli AI direttamente sul tuo computer, senza connessione Internet e senza costi.

1 — Installazione

Vai su https://ollama.com e clicca Download.
Scegli il pacchetto per il tuo sistema operativo:
- Windows — scarica OllamaSetup.exe e avvia l'installazione. Al termine Ollama è disponibile nel menu Start e nella barra delle applicazioni.
- macOS — scarica il file .zip, estrai l'app e trascinala in Applicazioni. Al primo avvio potrebbe chiedere il permesso di eseguire software di terze parti.
- Linux — apri un terminale e incolla:
  curl -fsSL https://ollama.com/install.sh | sh

Requisiti hardware: Ollama funziona su qualsiasi PC moderno con almeno 8 GB di RAM libera. Con una GPU Nvidia o AMD dedicata le risposte arrivano in pochi secondi. Senza GPU dedicata (CPU-only), ogni risposta può richiedere da 1 a 5 minuti, anche su PC potenti. Se tempi di attesa così lunghi sono un problema, usa Claude API (sezione sotto): le risposte arrivano in 5–15 secondi a prescindere dall'hardware, con costi trascurabili.

2 — Scaricare un modello

La finestra "Launch" che appare dopo l'installazione non serve per MotioForge Studio. Mostra app standalone di Ollama (come Claude Code, Codex, Hermes…) da avviare nel browser. Chiudila pure e prosegui con il passo qui sotto.

Apri un terminale (Prompt dei comandi su Windows, Terminale su macOS/Linux) e scarica un modello con uno dei seguenti comandi:

Comando	Dimensione	Quando usarlo
`ollama pull llama3.2`	~2 GB	Buon equilibrio qualità/velocità. Consigliato per iniziare.
`ollama pull mistral`	~4 GB	Risposte più elaborate e precise.
`ollama pull phi3`	~2 GB	Molto leggero, adatto a PC con poca RAM.

Il download richiede qualche minuto a seconda della connessione. Una volta completato, il modello è salvato localmente e non è necessario scaricarlo di nuovo.

3 — Avviare Ollama

Ollama deve essere in esecuzione prima di usare l'assistente di MotioForge Studio.

Windows: Ollama parte automaticamente con Windows dopo l'installazione. Se non è in esecuzione, cerca Ollama nel menu Start e avvialo. Comparirà un'icona nella barra delle applicazioni (accanto all'orologio).
macOS: Apri Ollama dalla cartella Applicazioni. L'icona apparirà nella barra dei menu.
Linux: In un terminale digita: ollama serve
Lascia il terminale aperto oppure avvia Ollama come servizio di sistema.

Per verificare che Ollama sia attivo, apri un browser e vai su http://localhost:11434. Se vedi il testo Ollama is running, tutto funziona.

4 — Configurazione in MotioForge Studio

Apri Preferenze → Assistente AI.
Seleziona Ollama (locale / gratuito) come backend.
In URL Ollama lascia il valore predefinito http://localhost:11434 (modificalo solo se Ollama è su un altro computer della rete).
In Modello Ollama scegli o scrivi il nome del modello scaricato, ad esempio llama3.2.
Clicca OK e premi F2 per aprire l'assistente.

Configurare Claude API (risposte di qualità superiore)

Claude è il modello AI sviluppato da Anthropic. Fornisce risposte significativamente più precise e contestuali rispetto ai modelli locali, soprattutto nell'analisi del log degli errori. Il servizio è a pagamento, ma il costo per uso tipico è trascurabile.

1 — Creare un account Anthropic

Vai su https://console.anthropic.com e registrati.
Nella sezione Billing, aggiungi un metodo di pagamento e ricarica il credito (anche 5–10 € sono sufficienti per mesi di utilizzo normale).

2 — Generare una API key

Nella console Anthropic apri la sezione API Keys.
Clicca Create Key, dai un nome alla chiave (ad es. MotioForge) e copia il valore.
Conserva la chiave in un luogo sicuro: non sarà più visibile dopo aver chiuso la pagina.

3 — Configurazione in MotioForge Studio

Apri Preferenze → Assistente AI.
Seleziona Claude API (Anthropic) come backend.
Incolla la API key nel campo API key Claude.
Scegli il modello:
- Claude Haiku — economico e rapido (costo ~0,001 € per domanda). Consigliato per uso quotidiano.
- Claude Sonnet — qualità superiore, analisi più approfondita del log (costo ~0,01 € per domanda).
Clicca OK e premi F2 per aprire l'assistente.

Una sessione di 10 domande con Claude Haiku costa meno di 0,01 €. Con Claude Sonnet rimane sotto 0,10 €. Il costo dipende dalla lunghezza delle risposte e dalle righe di log incluse nel contesto.

Lettura automatica del log

Quando il campo Righe log incluse nelle preferenze è maggiore di 0, MotioForge Studio allega automaticamente le ultime righe del file di log al contesto inviato all'AI. Questo permette risposte contestuali agli errori reali della sessione:

"Perché la porta non si connette?" — l'AI legge il messaggio di errore esatto.
"Cosa significa questo avviso?" — l'AI interpreta il testo del log.
"Il playback si ferma sempre allo stesso punto, perché?" — l'AI analizza la sequenza di eventi.

Il numero di righe incluse è configurabile nelle preferenze (default: 80 righe; 0 = disattivato).

Privacy e sicurezza

Ollama: nessun dato viene inviato a server esterni. Tutto rimane sul PC dell'utente.
Claude API: il testo delle domande, la documentazione e le righe di log vengono inviati ai server Anthropic. Non includere dati personali o informazioni riservate nelle domande.
API key: la chiave è salvata nel file di preferenze dell'utente. Non condividere quel file con altri.