Assistente IA di Dola: chat e agenti per Unreal

La chat di Dola AI non è un chatbot generico accanto a Unreal. È la porta d’ingresso a un insieme di agenti che lavorano sul progetto aperto: il plugin Dola gira dentro Unreal Editor, un bridge locale lo collega all’app desktop Dola, e gli agenti usano quel bridge per leggere e modificare asset reali. Questo articolo spiega cosa succede tra il tuo messaggio e la modifica nell’editor, quale specialista si occupa di cosa e come formulare le richieste perché vadano a buon fine.

Sei nuovo di Dola? Leggi prima Che cos’è Dola AI?, poi installa l’app.

• Resta in modalità game-dev. Il selettore nella barra del titolo (Ctrl+Shift+M) passa tra game-dev e Modeling, e i thread ricordano in quale modalità sono nati.
• Collega il tuo progetto ed esegui Install Dola plugin dall’elenco dei progetti dell’app desktop. Le build pubblicate del plugin sono per Unreal Engine 5.7 su Windows e Linux.
• Apri Unreal Editor (riaprilo dopo la prima installazione) così il bridge può completare l’handshake. Vedi collegare un progetto Unreal.
• Salva il progetto nel controllo di versione prima delle richieste importanti, così ogni modifica è facile da rivedere o annullare.

1. Scrivi un messaggio in una sola chat. Dola coinvolge lo specialista per ogni parte della richiesta, così non devi mai sceglierne uno.
2. Le attività piccole e circoscritte vanno direttamente a quello specialista. Le richieste di dimensioni da gioco diventano un piano con attività; se chiedi solo il piano, non cambia nulla finché non lo approvi.
3. Lo specialista usa i propri strumenti (il bridge in tempo reale con l’editor per Blueprint e asset, la modifica dei file per il C++, l’indice locale del progetto per la ricerca) e riferisce il risultato.
4. Per il lavoro sui grafi, lo specialista di Blueprint compila e salva prima di dichiarare completata l’attività.

Dola non dovrebbe chiederti di creare un livello per lui né di incollare comandi della console dell’editor; se un passaggio richiede l’editor, lo esegue uno specialista attraverso il bridge.

• Blueprint — Grafi di Blueprint sotto Content: nodi, pin, poi compilazione e salvataggio.
• C++ — Sorgenti del progetto, inclusi Source/*.h e Source/*.cpp con le macro di reflection di Unreal.
• Materiale — Materiali di Unreal (M_*) e istanze di materiale (MI_*).
• Livello — Mappe, attori e disposizione. Non inventa nomi di livelli.
• Widget — Blueprint di widget UMG (WBP_*).
• Animazione, Niagara, audio, Sequencer e IA di gameplay — AnimBlueprint e montaggi, sistemi Niagara, suoni e MetaSound, Level Sequence, e behavior tree con i rispettivi blackboard e controller IA.
• Asset — Trovare, creare e riordinare i file sotto Content.
• Editor — Aprire, riavviare e chiudere Unreal Editor sul tuo progetto.

Alcuni aiuti non cambiano mai il tuo progetto: ricercare sul web e nella documentazione con fonti, richiamare ciò che l’indice del progetto conosce e rivedere le modifiche proposte. L’elenco completo è nel catalogo degli agenti.

Lo specialista di Blueprint lavora su grafi che esistono già sotto Content. Elenca i percorsi degli asset, modifica il grafo attraverso il bridge, poi compila e salva. Indica il Blueprint e descrivi una modifica verificabile, ad esempio:

In BP_Door, apri la porta in un secondo quando il giocatore entra nel box di attivazione, poi compila e salva.

Poi guarda il grafo nell’editor e premi Play. Se qualcosa non va, descrivi ciò che hai visto invece di ricominciare da capo. Limita ogni richiesta a un Blueprint o a un comportamento; una lunga lista di desideri è meglio come piano che approvi passo dopo passo. Il percorso è nel primo flusso di lavoro con Blueprint.

Lo specialista C++ legge, cerca e modifica header e file .cpp sotto Source/, usando le convenzioni di Unreal come UCLASS, UPROPERTY e UFUNCTION. La consultazione delle API del motore gli permette di verificare nomi di classi e funzioni invece di indovinarli. Una richiesta potrebbe essere questa:

Aggiungi ad AMyCharacter un float MaxStamina modificabile e una funzione BlueprintCallable che lo consuma.

Dola non compila l’editor per te. Compila come fai di solito e, se la compilazione fallisce, incolla l’errore nello stesso thread. Lo specialista C++ non tocca i grafi di Blueprint, UMG o Niagara; quel lavoro spetta agli specialisti dei grafi. Maggiori dettagli in primi passi con l’assistenza C++.

Lo specialista dei materiali lavora con materiali di Unreal e istanze di materiale: gli asset M_* e MI_* nella cartella Content. Indicagli un asset per nome e di’ cosa deve cambiare, ad esempio un valore di parametro su una istanza specifica. Tieni le richieste sui materiali separate da quelle sui Blueprint, così ogni specialista ha un compito chiaro.

La modalità modellazione è diversa: lì i colori e i materiali PBR del modello sono gestiti nello studio di modellazione dell’app desktop, e il modello arriva in Unreal solo quando lo invii. Vedi La modalità modellazione è uno studio Babylon.

• Usa i nomi. Usa nomi e percorsi di asset, nomi di classi e di livelli che esistono. Agli agenti viene detto di non inventarli.
• Dì com’è il risultato finito. «La porta si apre quando entro nel box» è più facile da verificare di «migliora la porta».
• Una modifica alla volta per le piccole modifiche; per qualsiasi cosa di dimensioni da gioco chiedi un piano e approvalo prima che inizi il lavoro.
• Controlla nell’editor. Guarda il grafo, gioca nell’editor, compila il C++. Riporta nel thread ciò che hai visto.

La cronologia delle chat e gli indici di progetto sono progettati per restare sul tuo computer. Le esecuzioni degli agenti passano da dolaai.pro fino al backend di Dola, che esegue Claude, e l’uso viene scalato dai crediti del tuo piano mensile. Dettagli: modelli, prezzi, locale e ospitato e l’informativa sulla privacy.