Back al manuale

DAWTONE AI

DAWTONE AI è l'assistente globale del software: resta nella colonna destra, può dialogare mentre lavori nella DAW o in Plugin Nodes, e traduce richieste in azioni validate sul progetto. Può usare un provider esterno reale oppure il fallback locale/offline per alcune azioni semplici.

Dove si trova

L'assistente non è una tab della DAW: è un pannello laterale globale, visibile quando serve e indipendente dalla vista attiva. In alto trovi il selettore provider, il pulsante setup con icona gear e il pulsante di chiusura. La conversazione usa bubble: i tuoi messaggi sono allineati a destra, quelli AI a sinistra.

Invio e scrittura

Invio invia il messaggio.
Alt + Invio va a capo nel prompt.
Durante l'attesa, DAWTONE mostra una bubble con puntini animati.
I messaggi tecnici di setup non vengono inseriti come risposte AI nella conversazione.

Provider supportati

Provider	Uso
Offline fallback	Parser locale senza rete. Non è una vera AI: interpreta alcune frasi comuni e crea azioni base quando non hai configurato un provider.
OpenAI-compatible API	Endpoint compatibile con Responses API o bridge OpenAI-like, con API key/token locale.
Google Gemini API	Endpoint Gemini generateContent con model e API key. DAWTONE normalizza endpoint base, endpoint con `{model}` e modelli scritti come `models/...`.
Anthropic API	Endpoint Messages API con modello e token.
Custom HTTP / MCP bridge	Ponte locale o server MCP/HTTP che riceve il prompt e restituisce testo o JSON azioni DAWTONE.

Setup provider

Apri DAWTONE AI dalla colonna destra.
Scegli il provider dal menu in alto.
Clicca il gear.
Inserisci endpoint, modello e API key/token.
Salva. Le credenziali vengono salvate localmente sulla macchina.

L'API key viene mascherata nel setup. Se l'hai mostrata in uno screenshot o condivisa, rigenerala nel pannello del provider.

Google Gemini: formato endpoint

Puoi inserire un endpoint completo o parziale. DAWTONE completa e normalizza questi formati:

https://generativelanguage.googleapis.com/v1beta/models
v1beta/models/{model}:generateContent
https://generativelanguage.googleapis.com/v1beta/models/{model}:generateContent

Il modello va scritto nel campo Model, ad esempio gemini-2.5-flash. Se scrivi models/gemini-2.5-flash, DAWTONE rimuove automaticamente il prefisso models/. Se Gemini rifiuta la richiesta, la chat mostra il messaggio reale del provider, non solo il codice HTTP.

Cosa può modificare oggi

Azione	Risultato
Creare tracce	Nuova traccia MIDI o audio, con nome, strumento ed eventuali effetti.
Creare clip MIDI	Pattern drums, bassline, accordi o melodie con durata, start e root note.
Creare clip audio sintetiche	Kick, tone, bass, noise o riser generati localmente come bozza audio.
Aggiungere device	Strumenti o effetti nella traccia scelta o selezionata.
Render MIDI to audio	Trasforma una traccia MIDI in audio, con opzione replace/in place quando prevista.
Duplicare clip	Duplica la clip selezionata usando il comando DAWTONE nativo.
Modificare clip audio	Gain, fade in/out, transpose e reverse sulla clip audio selezionata.
Importare dal Browser	Aggiunge il file audio selezionato o cerca un file adatto nelle cartelle del Browser.

Browser e clip audio

Puoi usare l'AI con il Browser in due modi. Il modo deterministico è selezionare un file audio nel Browser e chiedere di aggiungerlo in timeline. Il modo assistito è chiedere un suono adatto senza selezionarlo: DAWTONE cerca tra le cartelle locali del Browser e sceglie il miglior candidato in base a nome file e percorso.

aggiungi il file selezionato dal browser alla timeline
metti il loop selezionato dal browser alla fine della traccia audio
prendi un drum adatto dal browser
cerca un kick techno nel browser e mettilo in timeline

La ricerca parte dalla cartella Browser corrente, poi passa alle altre root locali aggiunte. Per restare leggera, si ferma dopo un numero limitato di file visitati. L'AI non deve inventare path: il file reale viene scelto da DAWTONE.

Plugin Nodes con AI

L'assistente può generare o modificare grafi Plugin Nodes tramite una struttura dichiarativa validata: nodi, parametri, porte e connessioni. Il grafo viene applicato solo dopo i controlli su DAG, tipi di porte e nodi esistenti. Puoi chiedere di creare un device tipo “reverb ambient con Gain, Dry/Wet, Decay e Size” oppure di rinominare, rimuovere gruppi, cambiare unità e trasformare controlli in dropdown.

Le risposte sono applicate a step quando la richiesta richiede più passaggi.
Il pannello Plugin Nodes non contiene più una chat separata: usa la chat AI globale.
La scelta provider resta persistente e non torna all'offline a ogni nuovo plugin.

Formato azioni per provider e MCP

Quando un provider deve modificare il progetto, deve restituire JSON compatto. DAWTONE estrae il JSON dalla risposta, valida le azioni e poi le esegue con le funzioni native. Esempio:

{
  "reply": "Creo una bassline MIDI con Pulse.",
  "dawtoneActions": [
    {
      "type": "create_track",
      "trackKind": "midi",
      "name": "Pulse Bass",
      "instrument": "Pulse"
    },
    {
      "type": "create_midi_clip",
      "kind": "bass",
      "startBeat": 0,
      "lengthBeats": 16,
      "rootMidiNote": 45
    }
  ]
}

Per importare dal Browser, usa add_browser_audio_clip con source impostato a selected o best_match. Con best_match aggiungi anche query, per esempio techno kick drum loop.

Fallback offline

Il fallback locale è utile per provare DAWTONE AI senza rete o provider. Non comprende qualsiasi lingua e non ragiona come un modello cloud: riconosce frasi semplici e le converte in azioni base. Quando vuoi frasi libere, più lingue, contesto e richieste complesse, configura un provider reale o un bridge MCP.

Errori e diagnostica

Messaggio	Cosa fare
Setup required	Configura endpoint, modello e token dal gear.
HTTP 400	Leggi il messaggio completo in chat: di solito indica endpoint, modello o payload non valido.
HTTP 404	Il modello non esiste o non è disponibile per quell'API/versione.
HTTP 429	Quota, credito o billing del provider non disponibile.
Nessun file audio adatto	Aggiungi cartelle al Browser, cambia query o seleziona manualmente un file.

Buone pratiche

Chiedi una modifica concreta per volta quando vuoi controllare il risultato.
Specifica durata, traccia, genere, energia e strumento se stai creando materiale musicale.
Usa il Browser per limitare la scelta dei sample a cartelle curate.
Controlla sempre musicalmente il risultato: l'AI accelera la bozza, non sostituisce editing, ascolto e gusto.