Aiuto

Guida di Maestro

Maestro organizza revisioni editoriali di documenti .docx mediante moduli specializzati di intelligenza artificiale. I risultati compaiono come commenti nei file .docx, consentendo una discussione mirata delle modifiche proposte dai modelli.

Tutto inizia con un'orchestra: un gruppo di moduli che esamina lo stesso testo da prospettive complementari.

Profili di utilizzo

Al primo avvio scegli Base o Avanzato. Puoi cambiare nelle impostazioni del profilo. Le installazioni esistenti restano in Avanzato.

Base usa OpenAI: GPT-6 Luna per moduli e rapporti; GPT-6.1 Sol per assistenti, editor e revisione finale. Salva la chiave nelle impostazioni; la guida iniziale collega portale OpenAI e tutorial. Puoi creare e modificare contenuti locali senza chiave.

Base offre elaborazione diretta e in lotti. Le nuove richieste attivano la revisione finale e disattivano il rapporto; puoi cambiare entrambe le caselle. Le scelte tecniche precedenti tornano in Avanzato. Gli export in Base usano OpenAI senza modificare l’originale.

Per iniziare

Il flusso di lavoro di base prevede nove passaggi:

1. Nella dashboard del provider a pagamento che intendi utilizzare, acquista crediti o abilita la fatturazione API.
2. Salva almeno una chiave API in Impostazioni.
3. Esamina i moduli disponibili o crea un modulo personalizzato.
4. Se non vuoi esporre ai modelli IA dati sensibili contenuti nei tuoi testi, crea un filtro di protezione.
5. Componi un'orchestra con i moduli desiderati, manualmente oppure con l'Assistente di creazione.
6. Apri Nuovo invio e scegli l'orchestra.
7. Aggiungi uno o più documenti .docx.
8. Conferma l'invio e monitora l'elaborazione.
9. Apri il risultato, esamina i suggerimenti e scarica i file.

Il catalogo, le orchestre, la cronologia e i documenti esistenti vengono mantenuti durante gli aggiornamenti.

Se preferisci seguire questi passaggi con collegamenti diretti alle schermate effettive, apri Tutorial nella barra laterale. Il tutorial presenta il flusso di lavoro essenziale; questa Guida conserva i dettagli, i limiti e le indicazioni per la risoluzione dei problemi.

Chiavi API e fornitori

Maestro offre OpenAI, Anthropic, Gemini e DeepSeek. Configura i fornitori desiderati in Impostazioni → Chiavi API. Un’orchestra può combinare più fornitori. I modelli disponibili sono indicati nel selettore.

Kimi e MiMo sono disattivati in Maestro: le nuove chiamate a questi fornitori sono bloccate. La cronologia e i risultati esistenti restano leggibili. Per un nuovo invio, scegli un modello disponibile.

Creare una chiave non acquista crediti. Gli abbonamenti ai chatbot non sostituiscono la fatturazione API. In base all’account sono disponibili crediti prepagati, fatturazione o una quota gratuita. Maestro non riceve pagamenti, non consulta saldi e non rinnova quote.

• OpenAI: Gestisci chiavi · Crediti e fatturazione.
• Anthropic: Gestisci chiavi · Crediti e fatturazione.
• Gemini: Gestisci chiavi · Crediti e fatturazione.
• DeepSeek: Gestisci chiavi · Crediti e fatturazione.

I collegamenti aprono il sito ufficiale e possono richiedere l’accesso. Per DeepSeek, apri la sezione di fatturazione nel pannello. Seleziona l’account o il progetto corretto; gli acquisti avvengono presso il fornitore.

File, ricerca web, elaborazione batch e accelerazione dipendono dal modello e dalla modalità. Maestro propone le combinazioni compatibili in base al catalogo delle capacità. I modelli dello stesso fornitore possono avere funzioni diverse.

L’esportazione di moduli e orchestre include i file di riferimento dei moduli personalizzati. L’importazione crea copie locali indipendenti, senza chiavi, cronologia o collegamenti remoti del mittente. Per conservare un riferimento nel tuo account, seleziona Archivia il file presso il fornitore; usa Dettagli per caricarlo, rinnovarlo o eliminarlo. Se l’archiviazione remota non è disponibile, Maestro invia la copia locale con ogni richiesta compatibile. Il selettore indica il supporto dei file.

L’accelerazione è facoltativa. Attiva Dai priorità alla velocità nell’assistente dei commenti per consentire Fast/Priority quando supportati. Il costo può aumentare; altrimenti si usa la modalità normale. WebSocket non è una tariffa accelerata.

Un saldo insufficiente confermato offre Aggiungi crediti; le restrizioni finanziarie, Vedi fatturazione e limiti; le chiavi rifiutate, Gestisci chiavi. Limiti temporanei e quote gratuite non indicano necessariamente mancanza di denaro. Apri Altri dettagli per le informazioni tecniche. Aprire il pannello non acquista crediti e non ripete l’invio.

Nelle Impostazioni, la cartella dei testi revisionati appare per prima. Notificare al termine del lavoro è attivo per impostazione predefinita e dipende dai permessi del sistema. Sviluppatore è disponibile solo in modalità sviluppo; Dettagli del catalogo… apre il catalogo di distribuzione.

Moduli

Un modulo è uno specialista editoriale. Contiene un obiettivo, istruzioni, provider e modello. Esempi comuni includono chiarezza, stile, argomentazione e verifica dei riferimenti.

Un buon modulo:

• Descrive con precisione ciò che deve osservare.
• Indica il tipo di suggerimento che deve produrre.
• Evita di duplicare un altro modulo.
• Spiega quando non deve modificare il testo.
• Usa esempi solo quando riducono l'ambiguità.

Quando crei o modifichi un modulo, scrivi una bozza e usa Assistente per renderla più chiara e più adatta a Maestro. Il testo suggerito rimane modificabile e sostituisce il prompt solo quando lo salvi.

Se un modulo attivo, un profilo di formattazione o un filtro ha già il nome selezionato durante la creazione, Maestro conserva entrambi e aggiunge il primo suffisso disponibile al nuovo elemento: -1, -2 e così via. Quando modifichi un elemento esistente, i nomi duplicati restano bloccati per evitare una ridenominazione imprevista.

Il limite configurabile controlla quanti rilevamenti può produrre un modulo. Maestro non tronca diagnosi o proposte di riscrittura in base al numero di caratteri: dopo aver convalidato la risposta del provider, conserva il commento completo nel risultato e nel DOCX. Se il provider interrompe l'output al proprio limite, la risposta viene trattata come incompleta anziché come commento parziale.

Nei modelli supportati, puoi allegare un file PDF, DOCX, TXT o MD come materiale di riferimento. Il file rimane associato al modulo e viene interpretato dal provider ogni volta che il modulo viene eseguito.

Non inviare file di riferimento di grandi dimensioni. Privilegia materiale breve direttamente pertinente all'attività e privo di allegati non necessari.

I file lunghi aumentano il costo, il tempo di attesa e il rischio che istruzioni importanti risultino diluite nel contesto. Maestro accetta file di riferimento fino a 20 MB, ma questo è un limite tecnico, non una dimensione consigliata.

Invece di un file, puoi inserire un URL pubblico che inizi con https://. Maestro non scarica la pagina stessa: OpenAI utilizza Web Search limitato al dominio fornito, Anthropic utilizza Web Fetch, Gemini utilizza URL Context. Il campo non è disponibile per i modelli privi di accesso nativo documentato, inclusi gli attuali modelli DeepSeek. Le pagine protette da accesso, paywall o blocco dell'accesso automatizzato potrebbero non essere lette.

Non utilizzare materiale riservato senza prima verificare la policy del provider; per un URL, ricorda che la piattaforma del provider accederà all'indirizzo durante ogni esecuzione.

I moduli creati o importati possono essere eliminati singolarmente o in batch. Apri la modalità Seleziona, contrassegna gli elementi oppure usa Seleziona tutto per considerare solo gli elementi personalizzati visibili. I moduli inclusi in Maestro non possono essere selezionati né eliminati. Una ricerca, il passaggio tra Moduli e Profili di formattazione, il cambio di visualizzazione o l'uscita dalla pagina annullano la selezione.

Elimina sposta il modulo o il profilo di formattazione in Eliminati di recente. La relativa definizione e il materiale allegato restano locali e recuperabili. Le orchestre mantengono internamente il collegamento nella posizione originale, ma smettono di utilizzare il modulo finché è eliminato. Se un'orchestra rimane senza moduli attivi, viene anch'essa spostata in Eliminati di recente.

Quando un modulo viene ripristinato, torna nella posizione originale nelle orchestre. Un' orchestra eliminata automaticamente dopo aver perso tutti i suoi moduli torna anch'essa non appena uno di essi viene ripristinato. L'eccezione è un'orchestra eliminata esplicitamente: torna solo quando la ripristini tu stesso. Se modifichi e salvi un'orchestra mentre un modulo è eliminato, il collegamento nascosto viene deliberatamente rimosso.

In Eliminati di recente, utilizza Ripristina o Elimina definitivamente, singolarmente oppure in batch. L'eliminazione definitiva rimuove la definizione, il materiale di riferimento e i collegamenti correnti; vengono eliminate anche le orchestre rimaste strutturalmente vuote. Le revisioni precedenti, i risultati e i documenti rimangono disponibili. Gli elementi meno recenti senza data mostrano Data non disponibile e non scadono automaticamente.

L’esportazione di moduli e orchestre include i file di riferimento dei moduli personalizzati. L’importazione crea copie locali indipendenti, senza chiavi, cronologia o collegamenti remoti del mittente. Per conservare un riferimento nel tuo account, seleziona Archivia il file presso il fornitore; usa Dettagli per caricarlo, rinnovarlo o eliminarlo. Se l’archiviazione remota non è disponibile, Maestro invia la copia locale con ogni richiesta compatibile. Il selettore indica il supporto dei file.

Durante un'altra operazione, puoi comunque sfogliare il catalogo, cercare, cambiare vista, esportare e preparare una bozza. Le azioni che scrivono nel catalogo, quali importazione, salvataggio, duplicazione, eliminazione o ripristino, attendono il termine dell'operazione in corso.

Moduli giuridici disponibili

La vista Disponibili offre separatamente i moduli LGPD — vaglio editoriale e GDPR — vaglio editoriale. Sono inclusi in Maestro, ma compaiono in Attivi solo dopo aver scelto Attiva. Dopo l'attivazione, la scheda scompare da Disponibili. Il registro interno impedisce di creare una copia duplicata finché l'installazione resta attiva.

LGPD e GDPR sono anteprime editoriali specializzate. Possono segnalare problemi di chiarezza, informazioni mancanti e possibili questioni legali, ma non attestano la conformità né sostituiscono la consulenza legale. Richiedi la revisione di un avvocato nella giurisdizione pertinente prima della distribuzione commerciale o di una decisione legale.

Maschere

Una maschera identifica la struttura dei documenti di input. Aiuta Maestro a distinguere titoli, sottotitoli, corpo del testo, note, tabelle e altri elementi che richiedono un diverso trattamento editoriale.

In Moduli, usa Crea maschera, scegli un documento sorgente .docx, assegna un nome alla maschera e scegli se commentare solo le differenze o applicare anche modifiche sicure al documento finale. La maschera viene salvata nel catalogo locale e può essere inclusa nelle orchestre; le maschere esistenti restano disponibili per la modifica.

Senza IA, il documento sorgente deve usare in modo coerente gli stili Word definiti, ad esempio Titolo 1 per i titoli, Normale per il corpo del testo e uno stile dedicato per le note. Dimensione carattere, grassetto e spaziatura applicati direttamente non sono sufficienti per un'inferenza locale affidabile.

Abilita l'assistenza IA quando il documento non usa stili, quando quasi tutto è contrassegnato come Normale o quando la sua struttura dipende solo dall'aspetto visivo. L'IA interpreta schemi e piccoli campioni per proporre ruoli strutturali. Una volta creata, la maschera rimane nel catalogo.

Quando è abilitata, l'IA riceve solo gli schemi strutturati e i piccoli campioni necessari per l'interpretazione, mai il documento completo né il suo nome file. Questa chiamata avviene solo durante la creazione della maschera o la sostituzione del relativo documento sorgente.

Prima di elaborare molti documenti, prova la maschera con un campione rappresentativo. Se il suo stato indica che la struttura non è stata riconosciuta, controlla gli stili, i marcatori e le interruzioni usati nel file .docx.

Una maschera deve essere abbastanza specifica da preservare la struttura e abbastanza flessibile da accettare piccole variazioni editoriali.

Filtri di protezione

Un filtro di protezione è un modulo locale riutilizzabile che pseudonimizza i dati sensibili prima che il testo attraversi un confine API. In Moduli, usa Crea filtro di protezione per assegnare un nome e descrivere il filtro, quindi modificarne i criteri. Ogni criterio ha un'etichetta, una categoria di pseudonimo e indicazioni Come riconoscere questo criterio. Usa Avanzate solo quando devi esaminare o modificare l'espressione regolare, i relativi flag e gli esempi che dovrebbero o non dovrebbero corrispondere. Maestro conserva questi dettagli quando l'area avanzata è compressa.

Se preferisci, scegli un Modello per la generazione delle regole e usa Genera regola con IA per il criterio. La chiamata riceve solo l'etichetta, la categoria di pseudonimo e il testo Come riconoscere questo criterio; il documento da revisionare non viene inviato. Scrivi le indicazioni come esempio annotato usando nomi, identificativi e situazioni fittizi. La chiamata può usare crediti e richiede il servizio accelerato del provider quando il modello lo supporta.

La risposta deve contenere una regola strutturata e superare la convalida locale. In caso di esito positivo, Maestro mantiene l'etichetta, la categoria e le tue indicazioni, compila l'espressione regolare, i flag e gli esempi e apre Avanzate. Si tratta solo di una proposta nella forma: esamina gli esempi e i confini dell'espressione prima di salvare. L'annullamento non modifica il filtro e un errore non compila né salva parzialmente la regola.

Lo stesso filtro può essere usato da più orchestre. Quando configuri un'orchestra, abilita Protezione dei dati sensibili e scegli un filtro esistente o creane un altro. La modifica di un filtro condiviso cambia gli invii futuri di ogni orchestra che lo utilizza; Maestro mostra il numero interessato sopra i campi. La rimozione del filtro da una composizione non lo elimina dal catalogo.

Il salvataggio convalida ogni regola prima di modificare il catalogo. Un errore mantiene il modulo aperto e non salva parzialmente l'orchestra o il filtro. Ogni istantanea di invio riceve una copia completa della policy allora in vigore, così risultati e audit precedenti non cambiano quando il filtro viene modificato. Le policy create dalle versioni precedenti continuano a funzionare e diventano un filtro riutilizzabile la prima volta che vengono salvate nell'editor.

Orchestre

Un'orchestra definisce quali moduli partecipano a una revisione. Ogni modulo esamina la dimensione editoriale per cui è stato configurato.

La vista Disponibili raccoglie undici composizioni specializzate. Ogni scheda mostra scopo, composizione e lingua prima dell'attivazione. Usa Attiva solo per le specialità necessarie. Maestro verifica manifesto, hash e schema del pacchetto, riutilizza i moduli integrati e crea soltanto gli specialisti richiesti.

Attivare un'orchestra non modifica mai quella predefinita. La nuova composizione appare in Attive e diventa predefinita solo se scegli deliberatamente Imposta come predefinita. L'orchestra di sistema protetta resta invariata.

Ogni esempio è anche un normale pacchetto .maestro.orchestra. Puoi quindi importarlo con Importa orchestra, esaminare e modificare nomi, prompt, modelli, limiti e icone, ed esportarne successivamente un'altra copia. Le importazioni ripetute usano nuovi ID e aggiungono suffissi ai nomi; non sostituiscono una copia precedente. La modifica della lingua dell'applicazione non traduce una copia già installata.

I moduli personalizzati di un esempio iniziano senza un file di riferimento né un URL. Dopo l'importazione, puoi configurare ogni modulo con un file compatibile oppure un URL pubblico. Fonti diverse possono essere assegnate a moduli diversi. Il materiale aggiunto diventa il tuo contenuto e viene inviato solo quando viene eseguito quel modulo. Invia solo materiale che hai il diritto di utilizzare e condividere con il provider selezionato.

Per una revisione generale, inizia con pochi moduli complementari. Aggiungi specialisti solo quando vi è una chiara esigenza editoriale. Orchestre più lunghe richiedono più tempo e utilizzano più crediti del provider.

Quando usi Crea orchestra, puoi selezionare manualmente i moduli e un filtro riutilizzabile di Protezione dei dati sensibili oppure aprire l'Assistente di creazione. L'assistente non è una chat: ti guida attraverso quattro brevi passaggi: Attività e criteri, Materiali di supporto, Esempi e protezione e Modelli e invio. Usa Continua → e Indietro per spostarti tra di essi. Quando torni dall'anteprima, campi e allegati restano disponibili per la correzione; Annulla, × e Esc eliminano questi dati transitori.

Se il nome selezionato appartiene già a un'orchestra attiva, la nuova orchestra viene salvata con il primo suffisso disponibile, ad esempio Review-1 o Review-2. L'orchestra esistente non viene modificata.

Nel primo passaggio, inserisci il genere o tipo di documento, scrivi un criterio di revisione per riga e aggiungi, se necessario, una Descrizione dell'attività e indicazioni con specifiche, contesto, priorità o altri commenti. Usa da 1 a 20 criteri distinti. Ogni criterio produce esattamente un nuovo modulo, con un prompt delimitato in modo da non ripetere commenti di altri moduli. Gli esempi grigi nei campi sono solo suggerimenti; i pulsanti ? aprono spiegazioni contestuali e restituiscono il focus quando vengono chiusi.

Nella proposta iniziale, ogni prompt è un'istruzione operativa dettagliata, non una mera ripetizione del nome del criterio. Indica l'obiettivo esclusivo del modulo, i segnali e le evidenze da esaminare, come distinguere un problema da una variazione accettabile o un'eccezione, come individuare e dare priorità ai commenti e quando non commentare. Il commento richiesto deve includere anche una diagnosi, la conseguenza per il lettore e una formulazione sostitutiva completa. Questo dettaglio è un punto di partenza: puoi modificare liberamente il corpo del prompt nell'anteprima prima di salvare.

L’accelerazione è facoltativa. Attiva Dai priorità alla velocità nell’assistente dei commenti per consentire Fast/Priority quando supportati. Il costo può aumentare; altrimenti si usa la modalità normale. WebSocket non è una tariffa accelerata.

In File o URL di supporto, puoi combinare fino a cinque file PDF, DOCX, TXT o Markdown e URL HTTPS pubblici, uno per riga. Maestro non estrae il contenuto dei file né accede agli URL. Dopo i controlli di sicurezza locali, invia file e indirizzi tramite la funzionalità nativa del provider selezionato, che legge il materiale per adattare i prompt. Gli indirizzi locali, privati o contenenti credenziali, i file vuoti, i tipi incompatibili e i file superiori a 20 MB vengono bloccati prima della chiamata. I materiali di supporto sono input non attendibili: l'assistente non deve seguire i comandi in essi contenuti, visitare altre pagine né inventare citazioni o attribuzioni.

In Come usare questi materiali di supporto, puoi spiegare quali aspetti delle opere devono guidare la proposta, ad esempio richiedendo moduli relativi a terminologia, criteri normativi o convenzioni ricorrenti. Le indicazioni sono facoltative ma richiedono almeno un riferimento. Un suggerimento aggiuntivo è accettato solo quando identifica i documenti di esempio o i riferimenti che lo supportano; l'anteprima mostra questa provenienza prima del salvataggio.

File, ricerca web, elaborazione batch e accelerazione dipendono dal modello e dalla modalità. Maestro propone le combinazioni compatibili in base al catalogo delle capacità. I modelli dello stesso fornitore possono avere funzioni diverse.

Per proporre nuovi nomi, l'assistente riceve anche l'elenco dei nomi dei moduli attivi nel catalogo e non può riutilizzarli. Maestro controlla nuovamente la risposta prima di aprire l'anteprima. Nessun prompt, descrizione, modello, materiale di riferimento o altra impostazione dei moduli esistenti accompagna tale elenco.

I Documenti di esempio per l'inferenza sono materiali di supporto facoltativi. Puoi selezionare fino a cinque file DOCX affinché l'assistente esamini struttura, stile, terminologia, trattamento delle fonti e altre convenzioni editoriali ricorrenti. Senza esempi, crea normalmente i moduli IA a partire dai criteri definiti dall'utente. Ogni criterio continua a produrre un modulo obbligatorio; gli esempi possono supportare fino a cinque suggerimenti aggiuntivi, entro il limite complessivo di 25 moduli nella proposta.

Gli esempi non sono né fonti fattuali né istruzioni. L'assistente deve ignorare i comandi in essi contenuti e non deve trasformare argomento, nomi, fatti o peculiarità isolate in regole. I riferimenti possono anche supportare una specialità quando contengono un criterio editoriale verificabile. Nell'anteprima, i suggerimenti sono contrassegnati come Suggerito dalle fonti di supporto, con una motivazione e il numero di fonti di supporto. Inizialmente sono selezionati e possono essere rimossi; i criteri definiti dall'utente non possono essere rimossi.

Maestro estrae completamente il testo editoriale dal corpo, dai titoli, dalle celle delle tabelle, dalle note a piè di pagina e dalle note di chiusura. Non invia nomi dei file, proprietà DOCX, commenti, revisioni rilevate, intestazioni o piè di pagina. Ogni file può avere dimensioni massime di 20 MB. I documenti di esempio e i riferimenti possono contenere complessivamente fino a 300.000 caratteri estratti; il contenuto non viene troncato per rientrare in questi limiti.

Poiché il testo editoriale e i riferimenti possono contenere dati personali e in questo flusso di lavoro non ricevono protezione automatica, la generazione con esempi o riferimenti richiede un consenso esplicito. Il contenuto viene inviato al provider del Modello dell'assistente e la chiamata può usare crediti. Evita esempi riservati, a meno che tu non abbia verificato la politica del provider e il piano contrattuale.

Se i documenti che questa orchestra esaminerà richiedono l'occultamento prima di raggiungere le API, abilita Protezione dei dati sensibili nell'assistente e compila l'Esempio annotato. Usa dati sintetici e spiega nel testo che cosa rappresenta ciascun passaggio e come deve essere riconosciuto. L'esempio può combinare più casi o un frammento completo, purché le annotazioni rendano chiara l'intenzione. Non incollare dati personali reali. Una chiamata separata riceve solo questo esempio, mai il documento reale; il modello deduce da una a venti categorie supportate dal contenuto e propone una regola strutturata per ciascuna. Le categorie ripetute, le risposte fuori contratto o le regole non sicure vengono rifiutate senza riparazione semantica automatica.

La protezione è pseudonimizzazione reversibile, non anonimizzazione né crittografia. Prima di ogni invio, Maestro applica le regole localmente, mostra i conteggi e i passaggi per categoria e richiede conferma. Se il documento o la policy cambia, la conferma viene invalidata. Verifica in particolare le occorrenze mancanti e le corrispondenze eccessivamente ampie; se necessario, chiudi l'anteprima e modifica il filtro in Moduli o Modifica orchestra.

Dopo la conferma, il documento, il nome del file, i metadati testuali, i prompt, i riferimenti e i risultati riutilizzati che supererebbero il confine dell'API ricevono token opachi. I moduli locali continuano a leggere l'originale. Commenti, report e documenti finali vengono ripristinati localmente. Ai moduli viene richiesto di trattare i token come contenuto valido e di non commentarne la forma tecnica; prima del ripristino, Maestro elimina inoltre localmente le osservazioni relative a marcatori, segnaposto o pseudonimizzazione, nonché le proposte che rimuoverebbero i token o ne modificherebbero l'ordine. Un problema editoriale reale nel testo circostante viene comunque mostrato quando preserva gli pseudonimi. Una risposta che deforma un token interrompe il modulo invece di tentare di indovinarne il valore. I riferimenti DOCX, TXT, Markdown e PDF da cui è possibile estrarre testo diventano derivati .txt protetti. Gli URL e i PDF senza testo estraibile vengono bloccati mentre la protezione è attiva.

Se desideri anche un profilo di formattazione locale, scegli separatamente un esempio in Usa anche per la formattazione. La selezione iniziale è Nessuno. Il documento selezionato aggiunge un modulo Formattazione in modalità Solo commenti; gli altri esempi non partecipano al profilo. L'interpretazione IA dei modelli di formattazione può essere disattivata e, quando è attivata, la seconda chiamata riceve solo modelli estratti e piccoli campioni di quel documento.

Durante la generazione della proposta o il salvataggio dell'orchestra, Maestro visualizza al centro dell'assistente un piccolo popup Assistente in corso, con un indicatore di caricamento e la fase specifica. Attendi che scompaia: durante questa attività, campi, chiusura e azioni di salvataggio restano bloccati per impedire operazioni duplicate.

Dopo la generazione, esamina l'anteprima. Puoi modificare il nome e la descrizione dell'orchestra, il nome e il corpo del prompt di ogni modulo IA, il nome e la descrizione di Formattazione e il nome del filtro di protezione riutilizzabile. I confini contro le sovrapposizioni vengono mantenuti separatamente e ricalcolati al salvataggio usando solo i moduli selezionati. Nulla viene salvato prima di Salva orchestra e moduli; la chiusura, la pressione di Esc, il ritorno indietro o l'annullamento scartano la proposta, secondo il caso. Le collisioni di nomi con elementi già attivi che si verificano dopo la generazione o vengono introdotte durante la modifica dell'anteprima ricevono automaticamente i suffissi -1, -2 e successivi sul nuovo elemento. I nomi duplicati all'interno della proposta restano non validi. Gli errori di convalida o salvataggio mantengono aperta l'anteprima senza lasciare moduli parziali né un'orchestra.

Quando la generazione raggiunge il provider, Maestro registra l'operazione e il relativo Costo stimato nella Cronologia non appena termina. La stima include la chiamata della proposta e, quando utilizzata, la seconda chiamata di interpretazione della formattazione. Il record rimane anche se la chiamata non riesce o annulli l'anteprima senza salvare i moduli e l'orchestra.

I moduli proposti ricevono istruzioni di non fermarsi alla diagnosi: per ogni problema testuale, il commento deve fornire una formulazione sostitutiva concreta e completa per il passaggio citato. Maestro combina entrambe le parti senza abbreviarle né aggiungere puntini di sospensione. Quando una versione completa richiederebbe informazioni inventate, il modulo deve offrire la formulazione sicura più completa e indicare ciò che deve ancora essere verificato.

Se il modulo identifica un problema strutturale o generale che non può essere collegato a un estratto letterale, l'osservazione non scompare. Stato e Risultato mostrano Nota generale — nessuna posizione esatta nel documento e conservano la diagnosi e il suggerimento completi. Nel DOCX, il commento viene inserito sul primo passaggio testuale come osservazione di livello superiore, con un avviso che tale posizione è solo un ancoraggio tecnico e non il punto in cui si trova il problema.

L’esportazione di moduli e orchestre include i file di riferimento dei moduli personalizzati. L’importazione crea copie locali indipendenti, senza chiavi, cronologia o collegamenti remoti del mittente. Per conservare un riferimento nel tuo account, seleziona Archivia il file presso il fornitore; usa Dettagli per caricarlo, rinnovarlo o eliminarlo. Se l’archiviazione remota non è disponibile, Maestro invia la copia locale con ogni richiesta compatibile. Il selettore indica il supporto dei file.

Le orchestre create o importate possono essere eliminate singolarmente o in batch tramite la modalità Seleziona. Seleziona tutto considera solo le orchestre personalizzate visibili; l'orchestra di sistema Standard rimane protetta. Cambiando vista o uscendo dalla pagina, la selezione viene cancellata.

Elimina sposta l'orchestra in Eliminati di recente senza eliminare alcun modulo. Se l'orchestra era la scelta predefinita, l'orchestra Standard inclusa diventa nuovamente quella predefinita. Il ripristino dell'orchestra non modifica nuovamente questa preferenza e richiede che almeno uno dei suoi moduli sia attivo. Il ripristino o l'eliminazione definitiva di un'orchestra non ripristinano né eliminano mai i moduli.

Nella vista Eliminati di recente, usa Ripristina o Elimina definitivamente. Gli elementi rimangono recuperabili fino all'eliminazione manuale. Quando esiste già un elemento attivo con lo stesso nome, il ripristino aggiunge — ripristinata, mantenendone ID, configurazione e collegamenti. Le revisioni precedenti mantengono la composizione utilizzata.

Le stesse regole si applicano qui: la consultazione, l'esportazione e la preparazione di una modifica restano disponibili, mentre il salvataggio o la modifica del catalogo attendono il completamento dell'operazione corrente.

Prima di salvare, verifica:

• Che ogni modulo richiesto sia attivo.
• Che le credenziali del provider siano configurate.
• Che i moduli di ricerca o ad alto costo siano realmente necessari.

Nuova richiesta

In Nuova richiesta, scegli un'orchestra, aggiungi documenti e rivedi il riepilogo prima di confermare. I file possono essere selezionati nella finestra di sistema o trascinati direttamente nell' area documenti.

Per usare un modello diverso per un modulo, apri Modifica i moduli per questo invio. Il pannello è inizialmente chiuso e mostra i moduli dell'orchestra. La scelta si applica solo a questa richiesta e non modifica il modulo, l'orchestra o il modello del report.

I documenti devono essere in formato .docx. Scegli nomi file chiari perché ricompariranno nella cronologia e nei file esportati. Evita di inviare due copie dello stesso documento nella stessa coda.

Il report editoriale combina le osservazioni in una sintesi semplice. Inizialmente non è selezionato nel profilo Base ed è selezionato nel profilo Avanzato; controlla questa scelta a ogni nuovo invio. Se selezionato, usa il modello di report configurato e può consumare crediti. Non sostituisce la lettura degli interventi nel documento.

Quando l'orchestra usa Protezione dei dati sensibili, Avvia revisione apre prima un'anteprima calcolata interamente sul computer. Verifica i conteggi e i passaggi per categoria. Conferma e avvia associa la tua autorizzazione al contenuto e alla versione della policy correnti; Indietro non invia nulla. Selezionando documenti diversi o un'altra orchestra, la conferma precedente viene annullata.

Alla conferma, Maestro apre immediatamente Monitora revisione e mostra la fase specifica mentre legge i file selezionati, salva una copia operativa, proietta il testo e registra la coda e l'istantanea dell'orchestra nell'archiviazione locale. Se questa preparazione non riesce, il modulo riappare con i documenti conservati. Dopo la registrazione, i moduli personalizzati e le chiamate ai provider continuano in background usando solo i dati di quella coda.

La copia locale, la sincronizzazione persistente e l'identificazione dei documenti usano una coda dedicata. Di conseguenza, Copia dei documenti… non deve attendere una chiamata o un controllo dello stato di un'altra revisione già in corso.

Dopo che la coda è stata registrata, puoi aprire Nuova richiesta e avviare un'altra revisione senza attendere il completamento di quella precedente. La richiesta più recente occupa Monitora, mentre quelle precedenti continuano in Cronologia e vengono aggiornate automaticamente. Durante la copia iniziale e la proiezione, Nuova richiesta è temporaneamente non disponibile per proteggere i file ancora in uso. Torna disponibile non appena la coda viene registrata, anche se un modulo IA sta ancora analizzando il documento.

I commenti su una parola o un'espressione devono essere ancorati a quel passaggio. Se il provider restituisce maiuscole/minuscole, spaziatura, tipografia o identificazione del paragrafo errate, Maestro cerca di recuperare una sola occorrenza letterale non ambigua. Quando l'espressione è ripetuta, altre parole letterali della diagnosi devono distinguere un unico paragrafo. Senza questa certezza, il commento completo rimane come osservazione generale all'inizio del documento; l'applicazione non sceglie una posizione basandosi solo sulla somiglianza semantica.

Il riepilogo indica la modalità di elaborazione selezionata, il numero di moduli e i provider coinvolti. Batch costa meno, ma il provider può impiegare più tempo a rispondere. Diretto costa di più e comporta un'attesa minore perché le chiamate compatibili iniziano in parallelo. Non tutti i modelli supportano l'elaborazione batch. Quando il batch non è disponibile, Maestro esegue quel modulo direttamente, applicando prezzi e tempi di attesa dell'elaborazione diretta.

Quando scegli Batch, Usa l’elaborazione diretta se il batch non riesce segue la preferenza generale, ma può essere modificata solo per quell’invio. Il ripiego non si attiva per timeout o stato incerto: OpenAI deve chiudere il batch, confermare che non sia stata eseguita alcuna richiesta e Maestro deve convalidare lo stesso file remoto. La modifica viene salvata prima della prima chiamata diretta. Gli stati ambigui restano in pausa per evitare addebiti o commenti duplicati. I moduli locali sono indicati come Locale e non inviano contenuti a un provider IA.

Con l'elaborazione Diretta, la velocità del servizio inizia da Standard. Puoi anche scegliere Accelerata quando disponibile. Maestro richiede quindi Fast per GPT-5.6, Fast per Claude Opus 4.8 e Priority per i modelli Gemini compatibili; gli altri modelli rimangono sul profilo standard, anche in un'orchestra mista. La disponibilità dipende dall'account e dal provider e i prezzi potrebbero essere maggiorati. Se il provider rifiuta specificamente il profilo accelerato, Maestro riprova una volta in Standard; un timeout, un errore ordinario o la quota standard non provocano questo passaggio. Quando non esiste un prezzo pubblico affidabile per il servizio utilizzato, il costo appare come prezzo non disponibile.

La concorrenza diretta rispetta sempre il limite più basso tra la coda, le preferenze locali e il limite massimo noto. OpenAI, Anthropic e Gemini iniziano in modo prudente e si adattano durante la sessione. DeepSeek usa una chiamata in meno rispetto al limite pubblicato. Le risposte 429 (troppe richieste simultanee) riducono la frequenza e viene rispettato l'intervallo indicato da Retry-After.

Documenti lunghi

Alla conferma, Suddivisione del documento mostra solo la scelta corrente. Usa Modifica per aprire le tre opzioni e Comprimi per tornare al riepilogo. Il Piano di revisione si trova in un riquadro separato direttamente sotto Modalità di elaborazione; inizialmente è chiuso e mostra solo l'azione Visualizza, senza presentare in anticipo un lungo conteggio delle chiamate. Quando il piano viene aperto, ogni documento mostra le sue parole, i paragrafi, il riepilogo della suddivisione e il totale delle chiamate IA. La conferma non ripete 100% del testo, poiché ogni piano disponibile richiede già una copertura completa; tale informazione resta registrata in Stato e Cronologia. Usa Visualizza dettagli per modello per verificare quante chiamate riguardano il contesto e quante la revisione. Sia il piano sia i dettagli per modello si richiudono quando modifichi un documento, un modello, un'orchestra o una strategia. Come è stato calcolato? spiega le riserve senza richiedere conoscenze di token o finestre di contesto; i dati tecnici restano in Maggiori dettagli in Stato.

Quando una strategia può suddividere il documento, Modello per il riepilogo del contesto consente di scegliere il modello per la prima fase. Inizia con il modello di report editoriale configurato, ma può essere modificato solo per quella richiesta. Non modifica il modello di report né i modelli che revisionano il testo. Se il documento non viene suddiviso, questo modello non riceve alcuna chiamata. Quando avviene la suddivisione, il piano aperto identifica il modello di riepilogo selezionato.

Anche quando un documento rientra in una singola analisi, parte della capacità del modello può essere utilizzata per ragionare sull'attività. Suddividere il testo lascia più spazio a tale ragionamento e alle istruzioni, ai riferimenti e ai commenti, il che può aiutare nelle attività complesse. Il compromesso è un numero maggiore di chiamate IA, quindi la scelta rimane esplicita.

Con Automatico — suddividi quando necessario, Maestro invia l'intero testo in un'unica analisi quando rientra in sicurezza nel modello selezionato. Se non rientra, Maestro divide il contenuto per sezioni, paragrafi e, solo quando essenziale, frasi. Le dimensioni delle parti variano in base alla capacità documentata di ciascun modello e allo spazio richiesto per istruzioni, riferimenti, contesto adiacente e commenti. Non esiste quindi un numero fisso di parole o paragrafi che funziona per ogni modello.

In Suddividi in parti, indichi quante parti devono ricevere il testo. Quando il contenuto rientra in sicurezza, Maestro usa esattamente quel numero. Questa scelta può riservare più spazio per chiamata per attività che richiedono un ragionamento approfondito, come l'analisi dell'argomentazione. Maestro non attiva automaticamente questa modalità per qualsiasi provider. Crea più parti solo quando richiesto dalla capacità di un modello; il numero effettivo e le chiamate aggiuntive compaiono nel Piano di revisione prima dell'invio.

Prima di esaminare le parti, il modello selezionato in Modello per la sintesi del contesto crea sintesi strettamente descrittive di ciascuna di esse. Quando analizza una parte, il modello di revisione riceve il testo completo di quell'intervallo, le sintesi degli intervalli precedenti e successivi, la mappa delle sezioni e brevi passaggi ai confini. Può proporre commenti solo sul testo letterale dell'intervallo principale. Le sintesi non possono suggerire correzioni. Quando modelli di revisione richiedono suddivisioni diverse, il modello di sintesi prepara il contesto per ciascun piano.

Nel monitoraggio, questa esecuzione appare in due fasi: Contesto 1/2 e Revisione 2/2. Maestro combina le osservazioni di tutte le parti, rimuove i duplicati equivalenti, applica il limite di commenti all'intero documento e produce un unico DOCX. La scheda della copertura in Stato registra la strategia e la copertura effettiva. Se un errore recuperabile interrompe il lavoro, Riprendi da questa fase continua dagli artefatti confermati; una risposta remota ambigua non viene inviata di nuovo automaticamente.

In Intero documento in un'unica analisi, Maestro prova a inviare tutto il contenuto applicabile in una sola volta a ciascun modulo. L'opzione viene bloccata prima di qualsiasi chiamata quando la capacità ufficiale del modello non è nel catalogo o quando testo, istruzioni e riserve non rientrano. L'applicazione non tronca la fine del documento né passa silenziosamente a un'altra strategia. Anche un riferimento URL impedisce la conferma, perché Maestro non scarica la pagina in locale solo per misurarne la dimensione. Torna all'invio e scegli la modalità automatica, scegli Suddividi in parti oppure salva il riferimento come file.

La strategia predefinita è in Impostazioni > Avanzate > Documenti lunghi. La scelta in Nuovo invio modifica solo quell'invio. Quando l'impostazione predefinita è Suddividi in parti, viene salvato anche il numero preferito, che può essere modificato nell'invio. Se la protezione dei dati sensibili è attivata, viene applicata localmente prima di qualsiasi sintesi o revisione remota.

Se Intero documento in un'unica analisi non è possibile, nel riquadro del piano compaiono La strategia richiede una modifica e una spiegazione. Le opzioni di suddivisione si aprono automaticamente per consentirti di correggere la strategia, senza finestra pop-up né dettagli tecnici dell'errore.

Monitorare un invio

Usa Monitora invio nella barra laterale per visualizzare ogni lavoro ancora in preparazione o in elaborazione. La prima schermata è Lavori in corso: ogni scheda elenca il documento, l'orchestra, l'esecuzione effettiva Batch, Diretta o Mista, i provider, lo stato e l'avanzamento. Gli invii più recenti appaiono per primi.

Scegli Monitora su una scheda per aprire i dettagli di quella revisione. Usa Tutti i lavori per tornare all'elenco senza annullare né modificare l'invio. L'azione funziona con il mouse, Invio o Spazio; quando la barra laterale è compressa, usa l'icona dell'orologio.

Mentre i file sono ancora in preparazione, la scheda appare come In preparazione e diventa disponibile per l'ispezione non appena riceve un ID di coda. Una revisione completata, non riuscita o annullata esce dall'elenco dei lavori attivi ma resta accessibile in Cronologia. Quando non ci sono lavori in corso, la schermata offre Nuovo invio.

Dopo aver confermato Annulla invio, la schermata dei dettagli mostra Richiesta di annullamento in corso… mentre la richiesta viene registrata. In un'esecuzione diretta, le attività non ancora avviate vengono annullate localmente e il lavoro esce dall'elenco attivo non appena tale intenzione è salvata in modo persistente. Una chiamata già ricevuta dal provider può terminare, ma la sua risposta non riattiva la coda. Per un batch, il provider può usare uno stato di annullamento intermedio; i risultati completati e i costi già sostenuti vengono conservati.

La scheda di avanzamento riunisce sintesi e azioni principali. Dettagli dell'invio apre strategia, copertura, codice e modalità effettiva senza occupare sempre lo schermo. Aggiorna ora controlla i provider e mostra Aggiornamento in corso… durante il controllo; la preparazione dei file e altre operazioni locali indipendenti non bloccano questa azione. Quando un'opzione batch deve essere eseguita direttamente perché il modello non supporta i batch remoti, la schermata dei dettagli spiega che il monitoraggio deriva dallo stato salvato localmente da Maestro.

Se l'applicazione viene chiusa dopo l'avvio di una chiamata diretta ma prima della conferma del risultato, l'invio riappare come Revisione interrotta. Maestro non ripete automaticamente quella chiamata. L'avviso indica quante attività hanno un risultato remoto incerto e quante dimostrabilmente non sono state avviate. Usa Riprendi attività sicure per continuare solo queste ultime, oppure Termina invio per conservare i risultati confermati e annullare il resto.

La schermata dei dettagli mostra l'avanzamento complessivo e la fase di ciascun modulo. Gli stati principali sono:

• In preparazione: convalida dei documenti e dell'orchestra;
• In revisione: i moduli elaborano il contenuto;
• Consolidamento: raccolta e organizzazione dei suggerimenti;
• Generazione del report: preparazione degli artefatti finali;
• Completato: il risultato è pronto;
• Richiede attenzione: una fase richiede verifica;
• Non riuscito: l'elaborazione non ha potuto continuare.

La barra avanza quando termina una fase verificabile, non in base al tempo trascorso. Può quindi apparire ferma mentre un provider elabora un batch o un modulo lento. Maestro continua a controllare l'invio e aggiorna la percentuale non appena riceve un nuovo stato.

Come leggere un errore del provider

Quando OpenAI, Anthropic, Gemini o DeepSeek rifiuta o interrompe un'operazione, Maestro mostra una scheda di errore persistente. Indica la causa, ciò che non è stato completato e un'azione consigliata. Le cause riconosciute includono chiavi rifiutate, autorizzazioni o regioni, crediti e quote, limiti temporanei di frequenza, richieste o contesto non validi, modelli non disponibili, blocco dei contenuti, risposte interrotte o non valide, annullamento, errore di connessione, timeout, sovraccarico ed errori interni del provider.

Usa Maggiori dettagli solo quando devi esaminare l'evento o preparare informazioni per l'assistenza. L'area si apre nella scheda e può mostrare la fase, il modello richiesto, lo stato HTTP, il codice, il tipo, l'ID della richiesta, l'intervallo consigliato e un messaggio tecnico. Possono apparire nomi di documenti, percorsi o passaggi perché appartengono al lavoro locale dell'utente. Chiavi, token e dati di autenticazione in intestazioni, campi o URL vengono sostituiti con [redacted]. Payload completi, richieste, intestazioni e stack trace non vengono mostrati.

Se DeepSeek risponde al di fuori del formato richiesto anche dopo la riparazione automatica, la scheda segnala DeepSeek ha restituito un formato di risposta non valido. Riprova; se l'errore persiste, scegli un altro modello o semplifica il prompt del modulo.

Se tutti i moduli vengono rifiutati nell'invio iniziale, Maestro registra comunque la revisione nella Cronologia, apre Stato e mantiene visibile l'errore. Poiché non è stato prodotto alcun risultato editoriale, non crea né un documento revisionato né un report vuoto. Se almeno un modulo viene completato, i risultati validi restano disponibili e l'invio viene contrassegnato come richiedente attenzione. Anche un errore del solo report conserva il documento revisionato.

In un'esecuzione effettivamente diretta, anche quando un modello in un invio batch non supporta il batch, Maestro può riprovare in caso di errori temporanei di connessione, timeout, limiti di frequenza, indisponibilità o risposte non valide. Sono previsti al massimo tre tentativi aggiuntivi dopo il primo, con attese progressivamente più lunghe e nel rispetto dell'intervallo indicato dal provider. Il contatore viene conservato se l'applicazione si riavvia. Errori di autenticazione, autorizzazione, saldo, richiesta o contesto non validi, modello non disponibile, blocco dei contenuti, annullamento ed errori sconosciuti non vengono ritentati automaticamente.

Un errore temporaneo durante il solo controllo di un batch remoto non termina l'invio: l'ultimo errore resta visibile e il controllo prosegue con la normale pianificazione. La scheda temporanea scompare dopo un controllo riuscito. Maestro non cambia modello automaticamente.

In Impostazioni, nell'assistente per i prompt, nella generazione di regole di protezione, nella creazione di profili di formattazione e nell'assistente Orchestra, un rifiuto appare accanto al modulo che ha avviato l'operazione. Non si apre automaticamente alcuna finestra di errore e il testo inserito resta al suo posto. Una chiave rifiutata non viene salvata.

Risultati

La schermata dei risultati presenta immediatamente in alto il documento revisionato. Sotto, riunisce una sintesi e un riepilogo per ciascun modulo, con il numero di osservazioni. Fai clic su un modulo completato, oppure usa Invio o Spazio, per esaminare i commenti prima di scaricare il documento. Ne vengono mostrati dieci alla volta; usa Mostra altri 10 fino a raggiungere la fine. Diverse i moduli possono rimanere aperti contemporaneamente. I moduli senza commenti o con un errore non possono essere espansi. I commenti completi restano anche nel .docx; Maestro conserva formulazioni valide senza abbreviarle né aggiungere puntini di sospensione. Per separare l'analisi dalla proposta, Diagnosi: e Suggerimento editoriale: compaiono in grassetto e il testo sostitutivo proposto compare tra virgolette e in corsivo. Indicazioni come “Sostituisci il paragrafo con:” restano in stile normale. La formattazione non applica il suggerimento né modifica il suo contenuto salvato: la decisione rimane tua.

La Diagnosi deve essere concisa e diretta: identifica il problema senza ripetere l'estratto, aggiungere una premessa o estendere la motivazione. Il Suggerimento editoriale non è soggetto a questo limite stilistico e può essere lungo quanto necessario per offrire una formulazione completa utile alla tua decisione. Maestro conserva entrambe le parti per intero e non applica mai il suggerimento senza revisione umana.

Nella Sintesi editoriale, ogni passaggio conserva il nome editoriale del modulo, inclusi i segni diacritici. Le metriche sono identificate dal modulo che le ha calcolate; per esempio, Leggibilità: Flesch Reading Ease: ....

Gli indicatori contano commenti, moduli con commenti, moduli senza commenti e moduli completati. I tre conteggi dei moduli includono solo i moduli effettivamente completati; i moduli in attesa, non riusciti o annullati non sono classificati come con o senza commenti. Maestro non visualizza i vecchi contatori interni delle azioni.

Se l'orchestra ha applicato la Protezione dei dati sensibili, il Risultato include le Sostituzioni di pseudonimizzazione. La sezione inizialmente è compressa perché contiene valori originali. Usa Visualizza sostituzioni per verificare ogni valore riconosciuto dalle regole di espressione regolare, lo pseudonimo applicato, la categoria, la regola, l'espressione e i flag. Vengono mostrate venti associazioni alla volta; Mostra altre 20 consente di arrivare alla fine.

La mappa copre l'intera esecuzione, inclusi documenti elaborati, istruzioni e riferimenti. Un valore ripetuto compare una sola volta quando riutilizza lo stesso pseudonimo. La visualizzazione della mappa non esegue nuovamente le regole né modifica gli output, nei quali gli originali sono già stati ripristinati localmente. Se la mappa è stata rimossa o non può essere convalidata, l'avviso di indisponibilità non impedisce di ispezionare altri risultati. Cancella cronologia continua a rimuovere questa mappa.

I suggerimenti supportano la revisione editoriale. Esamina ogni modifica prima di pubblicare o distribuire il documento. Presta particolare attenzione a nomi, numeri, date, citazioni e affermazioni fattuali.

Un risultato può includere:

• Documento revisionato.
• Documento con commenti.
• Rapporto editoriale.
• Riepilogo degli avvisi.
• Costo stimato dell'operazione.

Apri documento utilizza l'applicazione predefinita del sistema. Visualizza rapporto apre una nuova finestra di Maestro contenente il testo completo e scorrevole. Se devi condividere o modificare la sintesi, usa Scarica come DOCX, scegli una destinazione e Maestro produrrà localmente il documento Word con lo stesso contenuto e senza una nuova chiamata AI.

In Impostazioni, puoi scegliere una cartella che riceve automaticamente una copia di ogni documento revisionato dalle nuove richieste. Maestro conserva anche il proprio file interno, così la Cronologia continua a funzionare. Il rapporto editoriale rimane disponibile nei Risultati e non viene copiato in questa cartella.

Se una copia ha già lo stesso nome, Maestro aggiunge un numero e conserva il file esistente. Se la cartella diventa indisponibile dopo l'invio, il documento interno rimane disponibile; Risultati visualizza un avviso e Apri documento utilizza la copia interna.

Come leggere il costo stimato

Il Costo stimato è un'approssimazione in dollari statunitensi basata sull'utilizzo di token salvato per ogni operazione di revisione o dell'assistente di creazione. Il valore viene mostrato con sei cifre decimali, ad esempio US$ 0.002000. Può differire dalla fattura del provider a causa di variazioni di prezzo, arrotondamenti, crediti, sconti o altri criteri di fatturazione.

La stima non include costi di strumenti indipendenti, come ricerca o recupero dei contenuti, né imposte e conversione di valuta. Il valore del costo non mescola regime di prezzi, modello, provider o identificatori remoti; i modelli utilizzati compaiono in una vista separata della Cronologia.

Gli stati indicano:

• US$ 0.002000: utilizzo e prezzi sono stati salvati; anche le revisioni non riuscite o annullate possono mostrare costi già sostenuti;
• US$ 0.000000: l'utilizzo è stato registrato in una modalità gratuita verificata;
• in attesa: la revisione non ha raggiunto uno stato terminale;
• prezzo non disponibile: mancano dati affidabili sull'utilizzo o sui prezzi;
• nessun utilizzo AI: l'esecuzione era dimostrabilmente locale.

Ogni documento ha la propria stima. In un invio con più file, Cronologia e Risultati non ripetono il totale della coda. Le revisioni precedenti rimangono disponibili senza essere modificate o rivalutate; quando un'esecuzione legacy non dispone di dati sufficienti, mostra prezzo non disponibile, mai un costo zero presunto.

Cronologia

La Cronologia organizza le revisioni e le operazioni precedenti per data, orchestra o proposta, Costo stimato e stato. Apri una revisione per riprendere il monitoraggio o accedere ai file disponibili. La riga dell'Assistente di creazione dell'orchestra utilizza l'icona scintillante, mostra quante chiamate AI sono state effettuate e non offre Apri, perché non è una revisione e non ha una pagina Risultato.

Le cronologie lunghe caricano le righe quando entrano nell'area visibile. Analogamente, il contenuto del rapporto editoriale viene preparato per la visualizzazione solo quando si apre la relativa finestra. Queste modifiche non riassumono, troncano o alterano i dati; impediscono solo che il contenuto fuori schermo rallenti la navigazione.

Usa Modelli in qualsiasi riga per ispezionare il provider e i modelli utilizzati da ciascun modulo e dal rapporto. Confermato dall'API significa che il provider ha restituito il nome del modello; configurato all'invio significa che la Cronologia lo ha ricostruito dalla configurazione salvata, come può accadere con processi meno recenti. Quando i due nomi differiscono, la finestra di dialogo conserva il modello configurato ed evidenzia quello confermato. Gli invii diretti mostrano anche i profili di servizio richiesto ed effettivo quando questi dettagli sono disponibili. I processi interamente locali mostrano Nessun utilizzo AI.

La finestra di dialogo può essere aperta con un clic, Invio o Spazio, e chiusa con Esc, il pulsante × o Chiudi. Nelle finestre strette, il costo passa a una riga sotto il nome del documento senza cambiarne il significato.

La cancellazione della cronologia è un'azione esplicita e confermata. Rimuove record e file operativi dalla directory dei dati di Maestro e non può essere annullata. Le copie recapitate nella cartella predefinita e gli altri file in tale cartella non vengono rimossi.

Cancella cronologia è disponibile solo quando non è in corso alcuna revisione o operazione transitoria. Questa protezione impedisce che la pulizia rimuova file ancora coinvolti in un invio. L'ispezione dei risultati e la navigazione nella Cronologia rimangono disponibili.

Impostazioni

La cartella dei testi revisionati appare in alto. Aprire la cartella mostra la destinazione dei DOCX completati. Quando disponibile, scegliere un’altra cartella cambia la destinazione degli invii successivi, senza spostare risultati precedenti.

Nelle opzioni di invio scegli i modelli predefiniti del rapporto e della revisione finale, la strategia per documenti lunghi e le notifiche. La lingua di revisione può seguire ogni documento o essere fissa, con una lingua di riserva se il rilevamento è incerto. La lingua dell’interfaccia è indipendente. Cambiarla non traduce risultati precedenti.

Le conferme di protezione dei dati e lingua sono facoltative e indipendenti. Disattivare una conferma applica la configurazione salvata senza disattivare il filtro di protezione.

Nelle opzioni dell’editor scegli il modello dell’assistente, se usare sempre il documento completo e se dare priorità alla rapidità. L’accelerazione dipende dal modello e può costare di più.

Nell’area prezzi consulta tabella e data di aggiornamento, aggiorna manualmente o attiva gli aggiornamenti automatici. L’indicazione del modello più economico considera solo modelli compatibili con chiavi convalidate e non cambia le scelte salvate.

Nell’area chiavi verifica e salva una credenziale o rimuovi la copia locale. Apri i file presso i fornitori per gestire i riferimenti remoti. La sezione sviluppo appare solo in quella modalità e contiene la selezione del catalogo da distribuire.

Scelta di un modello

I modelli più piccoli sono generalmente più veloci e meno costosi. I modelli più grandi tendono a gestire meglio istruzioni lunghe, ambiguità e contesti ampi.

Per scegliere:

1. Inizia con un modello economico.
2. Prova documenti rappresentativi.
3. Confronta qualità, tempo e costo.
4. Utilizza modelli più grandi solo per i moduli in cui il miglioramento è evidente.

I risultati possono variare tra provider e tra versioni dello stesso modello. Registra la configurazione utilizzata nei flussi di lavoro editoriali importanti.

Privacy e archiviazione

Maestro conserva localmente documenti di lavoro, risultati, cronologia, moduli, orchestre, profili di formattazione, URL e materiali di riferimento. Su macOS, questi dati vengono memorizzati per impostazione predefinita in ~/Library/Application Support/Maestro. Le chiavi restano nell'archiviazione sicura del sistema—il Portachiavi su macOS e le Credenziali di Windows su Windows—e non vengono mai visualizzate per intero.

La cartella di sistema Documenti—o la destinazione personalizzata selezionata in Impostazioni— riceve solo copie dei documenti *_REVISIONATO.docx. Caricamenti, esecuzioni, report, credenziali e altri dati operativi restano nella directory dei dati di Maestro.

Il contenuto lascia il computer solo per i provider richiesti dai moduli selezionati. Anche il materiale di riferimento allegato a un modulo viene inviato quando tale modulo viene eseguito. Quando la fonte è un URL, Maestro conserva l'indirizzo e la funzionalità nativa del provider accede alla pagina a ogni esecuzione. Nell'assistente per la creazione di un'Orchestra, documenti di esempio e materiali di supporto vengono inviati solo dopo consenso esplicito. Il provider riceve il testo estratto dai documenti di esempio, i byte dei file di supporto e gli URL forniti, inclusi eventuali dati personali, senza applicare la protezione configurata per le esecuzioni future; percorsi locali e nomi dei file restano locali. La chiamata che crea le regole di protezione riceve solo l'esempio annotato inserito nel proprio campo. Il record dei costi di questa operazione non contiene genere, criteri, riferimenti, testo di esempio, nomi di file o percorsi, prompt, moduli o risposta non elaborata del provider. Cancellando la cronologia si rimuovono i record e i file operativi corrispondenti, incluse le mappe di pseudonimizzazione e i derivati; moduli, orchestre, criteri, profili di formattazione e credenziali restano finché non li rimuovi.

Privacy dei provider

Maestro invia i dati direttamente utilizzando la chiave inserita dall'utente. Dopo l'invio, la conservazione e l'uso dei contenuti seguono i termini della piattaforma scelta, che possono cambiare. Evita dati personali, riservati o altrimenti protetti quando la policy del provider o il tuo piano non offrono una protezione adeguata.

• OpenAI API: Gli input e gli output non vengono utilizzati per addestrare i modelli per impostazione predefinita, a meno che tu non scelga esplicitamente di aderire. La piattaforma può conservare i dati secondo l'endpoint e i controlli dell'account. Consulta i controlli dei dati API.
• Anthropic API: Gli input e gli output commerciali non vengono utilizzati per l'addestramento per impostazione predefinita. La conservazione abituale è fino a 30 giorni, con eccezioni contrattuali, legali e di sicurezza. Consulta l'Anthropic Privacy Center.
• Gemini: Maestro usa il servizio a pagamento. Consulta le condizioni API Gemini prima di inviare contenuti riservati.
• DeepSeek: Non presumere assenza di conservazione o utilizzo limitato all'elaborazione. Verifica le condizioni correnti prima di inviare contenuti riservati: la condizioni della piattaforma DeepSeek.

Risoluzione dei problemi

L’elenco dei modelli è vuoto o manca un modello

Nelle impostazioni delle chiavi API, verifica e salva la chiave del fornitore. Gli elenchi mostrano solo modelli con chiave convalidata e compatibili con attività e modalità. Una chiave accettata non garantisce accesso a tutti i modelli né credito disponibile.

Se una vecchia configurazione richiede di scegliere un modello, selezionalo e salva. La precedente scelta automatica del più economico richiede ora una selezione esplicita.

Che cosa significa «più economico»?

L’indicazione confronta i modelli idonei con chiave convalidata e prezzi noti presenti nell’elenco. Segue prezzi e modalità senza cambiare la selezione. Non garantisce il costo finale del lavoro.

I prezzi non si sono aggiornati

Apri la tabella dei prezzi nelle impostazioni e controlla la data di aggiornamento. Verifica la connessione e aggiorna manualmente. In caso di errore, Maestro conserva l’ultimo catalogo valido. Aggiornare i prezzi non aggiunge modelli.

La chiave è stata rifiutata

Controlla il fornitore, gli spazi superflui e che la chiave sia ancora attiva. Apri la gestione delle chiavi dell’account corretto. Non includere chiavi nelle schermate o nelle richieste di assistenza.

Il fornitore ha rifiutato l’invio

Segui l’azione nella scheda di errore. Aggiungere credito riguarda un saldo insufficiente confermato; consultare fatturazione e limiti riguarda restrizioni finanziarie. Per limiti temporanei, attendi l’intervallo indicato. Una quota non specificata non dimostra mancanza di fondi: consulta il pannello prima di acquistare credito.

Dopo un timeout o una disconnessione, controlla cronologia e stato prima di inviare di nuovo. Il risultato potrebbe essere ancora in attesa. Segui un lotto accettato fino alla conferma del suo stato.

Non riesco a importare un modulo o un’orchestra

Consulta il riepilogo e verifica il tipo di pacchetto. Se un modulo integrato non è disponibile in questa edizione, duplicalo nella vecchia versione ed esporta la copia personalizzata. Cambiare l’estensione non basta.

Per pacchetti non validi o incompleti, esporta nuovamente dalla versione originale. I riferimenti importati sono copie locali; chiavi e collegamenti remoti del mittente non vengono trasferiti.

Non è stato possibile preparare un documento o PDF

Verifica che l’originale si apra e non richieda password. I PDF devono essere preparati prima della revisione. Leggi l’errore del file; gli altri documenti possono proseguire. Rimuovere dalla richiesta non elimina l’originale. Correggi il problema prima di aggiungerlo di nuovo.

Un modulo, rapporto o revisione finale non è riuscito

Apri il risultato e controlla la fase interessata e l’azione suggerita. Un errore parziale non significa che tutte le fasi siano fallite. Conserva i risultati completati e usa la ripresa disponibile per la fase in sospeso. Controlla lo stato prima di reinviare tutto.

Compare una conferma prima dell’invio

Controlla le opzioni di conferma della protezione dei dati e della lingua nelle impostazioni. Sono indipendenti. Disattivare la conferma non disattiva il filtro di protezione configurato.

L’app sembra ferma o non mi ha avvisato

Controlla l’avanzamento di ogni documento e le fasi che richiedono attenzione. Anche il fornitore determina l’attesa dei lotti. Attiva le notifiche di completamento e controlla i permessi del sistema.

Il documento non è nella cartella scelta

Apri il risultato. Se la destinazione non è disponibile, consulta l’avviso e il file conservato nell’archivio interno. Controlla la cartella dei testi revisionati in cima alle impostazioni. Cambiare destinazione non ricopia i lavori completati.

I suggerimenti non sono utili

Rivedi istruzioni e riferimenti, evita obiettivi contraddittori e prova un modello adatto. Valuta ogni commento prima di applicarlo; anche la revisione finale richiede il tuo giudizio.

Ho bisogno di altro aiuto

Visita maestroapp.site. Indica versione di Maestro, sistema operativo, azione tentata e messaggio visualizzato. Usa un esempio senza dati personali ed elimina chiavi, testi riservati e altri dati sensibili da schermate e dettagli tecnici.

Scorciatoie e navigazione

• ⌘K su macOS o Ctrl+K sulle altre piattaforme apre la Guida.
• ⌘1 o Ctrl+1 torna alla Dashboard.
• ⌘N o Ctrl+N apre Nuovo invio.
• Esc, il pulsante × e Annulla chiudono una finestra di dialogo senza salvare. Salva e Applica confermano le modifiche.

L'intera app può essere esplorata con la tastiera. Usa Tab e Shift+Tab per spostare il focus, Invio o Spazio per attivare i controlli e Pagina su, Pagina giù, Home e Fine per scorrere contenuti lunghi. Nella Guida, l'indice degli argomenti e l'articolo scorrono in modo indipendente. Il focus attivo è indicato visivamente.

Licenze dell'applicazione

Il codice originale di Maestro è proprietario e concesso in licenza, non venduto. Copyright © 2026 Pedro Duarte Blanco. Tutti i diritti riservati. I termini vigenti sono disponibili nel file LICENSE.

L'interfaccia è realizzata con Qt for Python. Qt, PySide6 e Shiboken6 sono utilizzati ai sensi della GNU Lesser General Public License versione 3 (LGPLv3). I testi completi di LGPLv3 e GPLv3 sono inclusi nella cartella LICENSES e gli avvisi sono in THIRD_PARTY_NOTICES.md.

I componenti di terze parti mantengono le rispettive licenze e i corrispondenti diritti degli utenti.

Informazioni su Maestro

Maestro è stato creato per organizzare revisioni editoriali complesse come un'orchestra: ogni modulo gestisce una dimensione del testo e il risultato preserva il giudizio umano.

Le informazioni su autore, versione, contatto e licenza sono disponibili nella pagina Informazioni.