Panoramica
L'Analista geopolitico strutturale è uno strumento per condurre analisi geopolitiche rigorose seguendo il metodo strutturale, fase per fase. Ogni fase compone un aspetto dell'analisi (ammissibilità, parametri, classificazione, proprietà dello spazio, relazioni/attori, scenari, ecc.).
Che cosa fa l'applicazione
Dato un tema, ANGST sviluppa un'analisi geopolitica per fasi: ne verifica l'ammissibilità, fissa i parametri dell'analisi e costruisce passo dopo passo il quadro dello spazio, delle relazioni e degli attori, fino alle conclusioni, agli scenari e a un report finale. Ogni fase si appoggia sui risultati delle precedenti.
Non sei uno spettatore: puoi intervenire durante l'analisi, modificando alcuni dei parametri che l'applicazione propone, per orientare lo sviluppo e i risultati. I dettagli di ogni fase e dei parametri modificabili sono nelle sezioni seguenti.
Quando l'app si ferma dopo una fase, sei tu a decidere se proseguire, ottenere informazioni sullo stato corrente, o ricalibrare elementi precedenti.
In breve
- Scrivi qualcosa per proseguire alla fase successiva
- Usa slash-comandi (
/stato,/tipo,/concludi, ecc.) per azioni specifiche - Leggi le correzioni di P10 se suggerite, ma sono informative, non obbligatorie
- Il report finale (P13) può essere generato con
/concludi reportdopo P12, oppure subito con/concludida qualunque fase
/stato in qualsiasi momento per verificare dove sei
nella pipeline e quanti token hai consumato fino a quel punto.
Comandi disponibili
Fai click su questi comandi slash (/comando) in qualsiasi momento
durante l'analisi per eseguire azioni specifiche.
| Comando | Quando usarlo | Effetto |
|---|---|---|
/continua |
Dopo ogni fase | Prosegue alla fase successiva. Non è un vero comando: il pulsante invia la parola «continua», e scrivere qualunque altro testo ha lo stesso effetto (solo dopo P01 il testo che scrivi viene letto da P02 come tua preferenza). Dopo P13 e P14 non c'è altra fase |
/riformula [nuovo tema] |
Solo subito dopo P01 (esito di ammissibilità) | Propone un tema diverso e rifà l'ammissibilità (P01). Più avanti non è più disponibile: per ripartire da zero usa «Nuova analisi» oppure /abbandona |
/stato |
In qualsiasi momento | Mostra fase corrente, fasi completate, lacune dichiarate e totale token consumati |
/tipo |
Dopo P04 | Visualizza la classificazione corrente (tipo A, B, C.1, C.2, SOSPESO). Prima di P04 risponde che la classificazione non è ancora stata eseguita |
/riclassifica [tipo] [motivazione] |
Dopo P04, massimo 1 volta. Compare tra le azioni di P04 e di P10 (dove l'autoverifica può segnalare problemi sul tipo) | Cambia la classificazione se non sei d'accordo con il tipo assegnato. Devi scrivere
dopo il comando il tipo che vuoi (A, B,
C.1 o C.2, in maiuscolo) e la motivazione
(obbligatorie entrambe), per esempio /riclassifica B lo spazio è controllato di fatto
da un solo attore. L'applicazione non può rifiutare la tua scelta e terrà conto
della motivazione in tutte le fasi successive |
/concludi report |
Dopo P12 | Produci il report finale: genera il report narrativo assemblato (P13). È il comando che compare in azzurro nelle azioni di P12; funziona ancora anche il vecchio /report |
/concludi |
Da P01 a P12 | "Vai direttamente al report finale": esegue tutte le fasi successive una dopo l'altra, senza fermarsi
tra l'una e l'altra, fino al report (P13). Compare in azzurro tra le azioni di ogni fase. Una volta
avviato non puoi intervenire a metà (per esempio con /riclassifica); se una fase non
riesce o la quota finisce, si ferma lì e un nuovo /concludi riparte da quel punto. Prima di partire compare un popup di conferma («Concludere l'analisi?»), che avvisa che, se confermi, ANGST eseguirà in automatico tutte le fasi successive senza che tu possa intervenire sull'analisi, e che le fasi eseguite in una volta consumano token della tua quota |
/compara [caso] |
Dopo P11 | Confronta l'analisi con un altro caso (es: /compara geopolitica del Pacifico). Al momento non disponibile: non compare tra le azioni e, se lo scrivi, risponde «Comando non disponibile». |
/abbandona |
In qualsiasi momento | Azzera l'analisi corrente e ne inizia una nuova — stesso effetto del bottone "Nuova analisi", ma senza dover uscire dalla chat. Prima compare un popup di conferma («Abbandonare l'analisi?»): se confermi, l'analisi in corso è chiusa e non si può più proseguire. |
Avanzamento automatico
Se non usi un comando slash, scrivi un testo libero per proseguire alla fase successiva:
- Una frase, una domanda, un'osservazione
- Anche solo
continuaook - Fa avanzare la pipeline alla fase successiva — ma viene letto davvero dal modello solo il messaggio subito dopo P01 (quello che fa scattare P02: vedi la sezione P02 (Parametri dell'analisi)). In ogni altro punto è solo un segnale di "prosegui": qualunque cosa tu scriva, il suo contenuto non arriva alla fase successiva
continua o premi invio dopo aver letto l'output.
L'interfaccia: cosa vedi e cosa succede mentre l'app lavora
A sinistra c'è la barra laterale, a destra la chat in cui si svolge l'analisi. Questa sezione spiega che cosa mostra ogni blocco, come leggere i messaggi che compaiono mentre l'app aspetta il modello e che cosa trovi alla fine.
La barra laterale
| Dove | Cosa mostra |
|---|---|
| Intestazione, pallino con numero | Si accende per qualche secondo ogni volta che Gemini esegue una vera ricerca sul web; il numero conta le ricerche fatte dall'inizio della sessione. Se resta a zero, finora non è stata eseguita nessuna ricerca web (per esempio in modalità Certificata, che le esclude) |
| Modalità | Interruttore semi-automatica / automatica. In semi-automatica l'app si ferma dopo ogni fase e aspetta te; in automatica esegue tutto il percorso e mostra solo il risultato finale. Si sceglie prima del primo messaggio e non si cambia a metà analisi |
| Conoscenza | Compare solo se l'amministratore ha attivato la base certificata EIL: vedi la sezione Modalità di conoscenza |
| Ricerca approfondita | Interruttore, attivo di default a ogni nuova analisi (puoi spegnerlo prima del primo messaggio; la scelta vale solo per quell'analisi): prima di passare alla fase successiva prova a colmare con una ricerca web reale le lacune dichiarate. Quando l'amministratore ha attivato i «fatti di riferimento», lo stesso interruttore fa partire una ricerca web prima dell'introduzione (P03) che raccoglie fatti ed eventi datati, mostrati nella scheda dell'introduzione e usati come base dalle fasi successive: date e cifre devono venire da quei fatti, da ciò che scrivi tu o dalla base di conoscenza del metodo. I fatti non sono verificati manualmente: controllali. Nel report, prima della bibliografia, trovi il «Quadro dei fatti»: la tabella dei fatti con data, attori, fonti (con il numero della bibliografia) e livello di corroborazione, scritta dal sistema e non dal modello; i richiami [F1], [F2]… nel testo rinviano alle sue righe. Le fonti web della bibliografia sono quelle trovate dalla ricerca, con i dati letti dalla pagina (autore o ente, anno) quando la pagina li dichiara e con l'indicazione se il link risponde; le etichette «classificazione indicativa» (stampa, centro studi, media di Stato…) sono una stima del tipo di sito, non un giudizio. Le fonti web che il modello indica di sua iniziativa nelle fasi non compaiono più in bibliografia perché non sono verificate da una ricerca; il quadro dei fatti ne indica il numero. Una fonte «non verificata» o con «metadati incompleti» prova che la pagina esiste, non che dica ciò che l'analisi sostiene. Per i fatti recenti (degli ultimi dodici mesi) l'applicazione chiede anche una verifica indipendente: un fatto che non trova conferma in una fonte diversa non entra nell'analisi e un fatto per cui una ricerca indipendente indica una data diversa è segnalato come «contestato»; restano visibili nel quadro dei fatti, con la loro etichetta, ma il testo dell'analisi non li usa. È un controllo che riduce il rischio di date sbagliate, non lo elimina. Se nel testo di una fase compaiono date o cifre che non vengono né dai fatti né da ciò che hai scritto né dal metodo, la scheda le elenca come «Date non verificate» (e il report ne riepiloga l'elenco): sono dati che il modello ha scritto a memoria, da verificare prima di usarli. Vedi Lacune dichiarate |
| Percorso | Le fasi dell'analisi: grigie quelle non ancora raggiunte, in verde lampeggiante quella attuale, in verde fisso e più tenue quelle completate. P05 compare solo per i temi di tipo C; P0X raggruppa il ramo scelto (relazioni e attori per il tipo A, attore dominante per il tipo B) |
| Classificazione | Il tipo assegnato in P04 (A, B, C.1, C.2 o SOSPESO); «non ancora determinata» finché non è stato deciso |
| Lacune dichiarate | L'elenco accumulato lungo l'analisi, con le più gravi in cima. Su smartphone il numero compare sulla scheda «Lacune» |
| Token / Costo | Token di input e di output consumati dalla sessione (più pensiero, ricerche web ed EIL quando ci sono), il totale e il costo stimato. Aggiornati a ogni fase |
| Account | Quanti token e quanto budget hai consumato rispetto alla tua quota (o «illimitato»), con due barre |
| In fondo | ? Guida, 📋 I miei report (vedi Salvataggio e gestione dei report) e Nuova analisi, più la versione dell'applicazione. In alto trovi il tuo nome e il pulsante Esci |
Su computer puoi allargare o restringere la barra laterale trascinando il bordo verticale tra la barra e la chat: con una barra più larga le etichette delle fasi si leggono per intero. Su smartphone la barra diventa una fila di schede in basso (Percorso, Lacune, Token, Account, Altro) che aprono ciascuna il proprio pannello.
Mentre l'app aspetta: cosa significano i messaggi
Ogni fase richiede almeno una chiamata al modello e alcune ne richiedono molte: una fase può durare da pochi secondi a qualche minuto, e mentre l'app aspetta la casella di scrittura e i comandi sono disattivati. Per capire che sta lavorando, e su cosa, compaiono questi indicatori.
In modalità semi-automatica sotto l'ultimo messaggio appare una riga grigia con tre puntini che pulsano, il testo della fase in corso e un cronometro che parte da zero, per esempio:
Sto elaborando la fase P10 – Autoverifica… · 42 sSto verificando la richiesta: fase P01 – Ammissibilità…— il primo messaggio, quando l'app capisce se è un tema e se è ammissibileSto elaborando la fase P08 – Attori geopolitici (2/2)…— nel gruppo P07-P08 o P09a/b/c indica anche il passo (qui il secondo di due)Sto elaborando la fase P04 – Classificazione (riclassificazione indicata da te)…— dopo/riclassifica
Anche i comandi che producono una fase hanno il loro messaggio: /compara (P14), /riformula (di nuovo P01)
e il vecchio /report (P13). I comandi che non chiamano il modello, come /stato o /tipo,
rispondono subito con il semplice «elaborazione in corso». /concludi e /concludi report usano invece la barra
di avanzamento descritta qui sotto, perché eseguono più fasi in una sola richiesta.
Il blocco «Caratteri dello spazio» (P06) è il più lungo perché non è una sola chiamata ma tredici in sequenza: le dodici proprietà e poi la sintesi. L'app le esegue una dopo l'altra senza chiederti nulla e la riga cambia a ogni passo, con lo stesso cronometro che conta il tempo dell'intero blocco:
Sto elaborando la fase P06 – Caratteri dello spazio · proprietà 6/12: Mobilità…Sto elaborando la fase P06 – Caratteri dello spazio · sintesi trasversale delle 12 proprietà…— l'ultimo passo, che rilegge tutte le proprietà
In modalità automatica, e dopo /concludi, l'analisi gira in un'unica richiesta: al posto della riga compare una
barra di avanzamento con le tappe del percorso (le stesse del blocco «Percorso», da P01 a P14), che si colorano man mano. Durante il blocco P06 sotto la barra
compare la stessa riga del passo in corso («proprietà 6/12: Mobilità…»). Il titolo della barra dice cosa sta succedendo:
Analisi automatica in corso… oppure Completamento dell'analisi fino al report finale…. Alla fine i risultati compaiono tutti insieme.
Quota e limiti
- Il pannello Account confronta i tuoi consumi con la quota assegnata dall'amministratore. Oltre una soglia (di norma il 90%) compare l'avviso «Stai per esaurire la quota disponibile. Contatta l'amministratore per una ricarica»; a quota esaurita l'app non accetta altri messaggi finché l'amministratore non la ricarica.
- Se l'amministratore ha fissato un tetto per singola analisi (in token o in costo), sotto i totali compare un avviso quando ti avvicini («Stai per raggiungere il limite di sessione…») e, al 100%, «Limite di sessione raggiunto. Avvia una nuova analisi per continuare».
Alla fine dell'analisi
Dopo il report (P13) trovi, oltre alla bibliografia:
- il Grafo attori e relazioni, un diagramma ricavato automaticamente dai dati già raccolti (attori, ruoli, presa dello spazio, concorrenti citati) — non da un'ulteriore elaborazione del modello, quindi più povero della descrizione in prosa; passando il mouse su un attore si evidenziano i suoi collegamenti. È incluso nel report finale che puoi salvare;
- l'elenco Siti Web visitati, cioè le pagine trovate dalle ricerche web svolte durante l'analisi, senza duplicati. Compare solo in chat e non entra mai nei report salvati;
- in modalità automatica e dopo
/concludi, un avviso «Prima di concludere» che rimanda alla sezione Autoverifica per i limiti e i problemi rilevati.
Modalità di conoscenza
Se l'amministratore ha collegato la base di conoscenza certificata EIL (Evidence Intelligence Layer — un archivio di documenti caricati e verificati), in sidebar compare un selettore Conoscenza con quattro opzioni. Come la Modalità (automatica/semi-automatica), si sceglie prima del primo messaggio e non è più modificabile a metà analisi.
| Opzione | Da dove attinge l'analisi | Quando usarla |
|---|---|---|
| Web | Ricerca autonoma di Gemini sul web, come sempre. EIL non viene interrogato. | Il comportamento predefinito. Nessuna base documentale dedicata. |
| Certificata | Solo EIL. La ricerca web di Gemini è forzata spenta e la "Ricerca approfondita" è disattivata. Ciò che EIL non copre resta una lacuna dichiarata, non viene colmato a memoria. | Quando vuoi un'analisi che poggi esclusivamente su documenti verificati. Più conservativa: se EIL ha poco sul tema, il report avrà molte lacune. |
| Mista | EIL come fonte primaria; Gemini (web + conoscenza propria) interviene solo dove EIL tace. La "Ricerca approfondita" resta disponibile come rete di sicurezza sulle lacune. | L'equilibrio consigliato: parte dai documenti certificati, ma non si blocca su ciò che non c'è. |
| Mista integrata | Come Mista, più una ricerca Gemini di arricchimento per ogni macro-sezione: cerca attivamente elementi pertinenti che EIL non copre e li aggiunge, etichettati come non certificati. | Quando vuoi il quadro più completo possibile. Aumenta tempo e costo (una chiamata Gemini in più per sezione). |
Come EIL viene interrogato
Non una domanda per ogni fase, ma una per macro-sezione: una sull'inquadramento del tema (P03–P04), una sui caratteri dello spazio (P06), una sugli attori / sull'attore dominante (P07–P09). La stessa risposta viene riusata da tutte le fasi di quella sezione. Ogni interrogazione può richiedere qualche decina di secondi.
Da dove viene ogni informazione, nel report
Nelle modalità che usano EIL, il report finale distingue l'origine di ogni dato:
- le citazioni di documenti EIL portano il marcatore
[EIL]subito dopo la parentesi — es. (limes-13062026.pdf, n.d.) [EIL] — e in bibliografia hanno il chip 📚 documento certificato (EIL); - le fonti web trovate da Gemini restano
(Autore, Anno)senza marcatore, con l'indirizzo cliccabile in bibliografia; - ciò che non ha fonte è dichiarato nel testo come inferenza propria ("in base alla conoscenza pregressa"), e non compare in bibliografia.
Costo
Ogni interrogazione a EIL ha un costo (EIL usa Gemini al proprio interno per rispondere): compare come riga EIL nel pannello Token / Costo ed è già sommato al totale della sessione e alla tua quota. In Mista integrata si aggiunge anche il costo delle chiamate di arricchimento.
Quando la pipeline attende una tua scelta
L'app si ferma dopo ogni fase e attende il tuo input. Ecco cosa succede in ciascun punto:
P01 — Ammissibilità
Il tema proposto viene valutato. Se ammesso in quanto ritenuto suscettibile di essere affrontato in una prospettiva geopolitica (e quindi non di diverso approccio disciplinare), la pipeline ti chiede di continuare. Se rifiutato o riformulabile, suggerisce un'alternativa. In quel caso l'analisi non prosegue: scrivi in chat un nuovo tema (oppure clicca «✓ Accetta riformulazione», se proposta) e l'ammissibilità riparte da P01 sul nuovo tema. Il tema respinto non passa mai a P02.
P02–P05, P06, P07–P09, P11–P12
Al termine di ogni fase, digita qualcosa (comando slash o testo libero) per proseguire. L'output mostra i risultati della fase corrente in forma strutturata (chip colorati, tabelle, sezioni).
P10 — Autoverifica ⚠️
Questa è la fase critica: P10 revisiona tutta l'analisi precedente e segnala:
- Coerenza complessiva (soddisfacente / con riserve / problematica)
- Problemi rilevati (leader-centrismo, monocausalità, strutturale/contingente non distinti)
- Correzioni proposte per ogni problema
Vedi la sezione P10 (Autoverifica) per capire come interpretare e applicare le correzioni.
P13 — Report
Dopo P12, fai click su /concludi report per generare il report narrativo assemblato.
Se non hai già cliccato su /concludi report, la pipeline ti suggerirà di farlo.
P14 — Comparazione (opzionale)
Dopo P11, puoi usare /compara [descrizione] per confrontare la tua analisi
con un altro caso. Non è obbligatorio; P13 si genera in ogni caso.
Al momento non disponibile: non compare tra le azioni e, se lo scrivi, risponde «Comando non disponibile».
Fase P01: Ammissibilità
P01 è il gate d'ingresso della pipeline: prima di avviare l’analisi l’applicazione si preoccupa di verificare che il tema proposto sia davvero trattabile con il metodo geopolitico strutturale. È l'unica fase che può interrompere l'analisi (esito RESPINTO) invece di limitarsi a segnalare un problema e proseguire.
Se il tema è ammesso, accanto all'esito e al rendimento atteso trovi i limiti di generalizzabilità: in una o due frasi, fin dove è lecito estendere le conclusioni dell'analisi ad altri casi, aree o periodi. Li propone ANGST; non si modificano.
Fase P02: Parametri dell'analisi
Subito dopo che P01 ammette il tema, P02 fissa il perimetro e l'impostazione dell'analisi: dove guardare, quanto in profondità, e su quale arco temporale. Sono le decisioni che condizionano tutte le fasi successive — un perimetro tracciato male o un solo fattore causale individuato qui si trascinano fino al report finale.
Puoi accettarli così, oppure correggerli
Il riepilogo che compare in chat si intitola «Parametri di impostazione», con sotto una breve nota: «ANGST li assegna in base alle proprie risultanze ma l’utente li può modificare orientando così lo sviluppo e i risultati dell’analisi.» I valori non sono quindi definitivi: sono la proposta di ANGST, e sei tu a decidere se tenerla o cambiarla.
Sotto il riepilogo dei parametri di impostazione trovi un pulsante
"✏️ Modifica parametri". Se i valori ti convincono, non serve toccarlo:
scrivi qualcosa (o usa /continua) per proseguire, come faresti normalmente.
Se invece qualcosa non ti convince, il pulsante apre un modulo dove correggere ogni valore
scegliendolo da un elenco — non devi indovinare come si scrive un valore
valido, scegli tra quelli proposti.
Il perimetro che scegli in P02 orienta le fasi successive
La delimitazione del perimetro geografico (strettamente circoscritta allo spazio indicato, oppure estesa agli spazi esterni collegati) non è solo un'etichetta: ANGST la usa per formulare la domanda di ricerca (P03), per stabilire se lo spazio è dominato o conteso (P04) e come guida per l'analisi dello spazio (P05 e le dodici proprietà di P06). Gli attori e le pressioni che stanno fuori dal perimetro non cambiano la classificazione, ma vengono comunque segnalati tra gli indizi contrari e le zone grigie; il perimetro guida l'analisi senza impedirle di considerare ciò che sta fuori quando serve. Per questo conviene scegliere con cura prima di proseguire: una volta passati a P03 non si può più cambiare.
Taglio ristretto: l'ambito su cui concentrare l'analisi
ANGST propone sempre un taglio tematicamente ampio. Se invece vuoi concentrare l'analisi su un ambito preciso, apri "✏️ Modifica parametri" e scegli il taglio tematicamente ristretto: compare un box in cui indichi l'ambito, in uno solo dei due modi.
- Scegli dalla lista (uno o più ambiti): economico, militare e della sicurezza, diplomatico, politico-istituzionale, energetico, tecnologico, cibernetico e digitale, ambientale e climatico, demografico e migratorio, culturale e identitario, religioso, giuridico, logistico e dei trasporti, sanitario, informativo e comunicativo, alimentare e idrico.
- Scrivi l'ambito con parole tue (da 3 a 300 caratteri).
Non puoi usare lista e testo insieme: scegliendo un modo, l'altro si disattiva. L'ambito che indichi orienta tutte le fasi successive, dall'introduzione al report finale: le proprietà dello spazio vengono comunque analizzate per intero, ma l'ambito è il riferimento per decidere quali contano di più e cosa approfondire; gli attori e le relazioni degli altri ambiti restano nell'analisi quando sono determinanti, e il report dichiara l'ambito scelto tra le premesse e i limiti. Come per il perimetro, va scelto prima di passare a P03.
Puoi modificare, scegliendo da una lista:
- la delimitazione del perimetro geografico (come interpretare la descrizione);
- gli ambienti coinvolti (terrestre, marittimo in superficie o in profondità, aerospaziale, extra-atmosferico, digitale — anche più di uno);
- le scale coinvolte (globale, macroregionale, regionale, statuale, sub-statuale, locale — anche più di una);
- il taglio (tematicamente ampio, oppure ristretto con approfondimento sugli ambiti più rilevanti);
- la scala temporale di ciascun fattore causale in profondità storica, e se è invariante.
La descrizione del perimetro e i fattori causali stessi (nome e punto di partenza) restano campi di testo libero: puoi riscriverli, ma non sono "a scelta" — nel modulo trovi comunque un pulsante per aggiungere o togliere un fattore causale.
I fattori causali che aggiungi o modifichi vengono elaborati obbligatoriamente. Ogni fattore che inserisci tu (o che riscrivi rispetto alla proposta di P02, anche solo nel punto di partenza, nella scala temporale o nell'invariante) compare con l'etichetta «Fn · da elaborare» e l'analisi deve trattarlo in P07 (relazioni tra gruppi, per i temi di tipo A), in una delle liste dei fattori basici, accessori, strutturali o contingenti — la lista la sceglie il modello e ne dà una breve motivazione — e nelle conclusioni (P11), tra gli elementi strutturali o contingenti. I fattori proposti da P02 che non tocchi non sono obbligatori. Elaborare non vuol dire confermare: se nel caso concreto il fattore è marginale o l'effetto non è riscontrato, l'analisi lo dichiara (la voce comincia con «Fn · marginale» o «Fn · non riscontrato»), senza inventare nessi causali. Le valutazioni possibili sono: determinante, concorrente, marginale, non riscontrato. Puoi aggiungere o modificare al massimo 8 fattori. Per i temi di tipo B, in cui P07 non c'è, i fattori compaiono solo nelle conclusioni.
/abbandona e ricominciare l'analisi.
Fase P03: Introduzione
P03 costruisce la cornice introduttiva dell'analisi, prima ancora della classificazione (P04): perché il tema merita uno studio strutturato, quale domanda guiderà l'analisi, e — quando è già formulabile — un'ipotesi di partenza. Riceve in input l'esito di P01 e i parametri di P02.
Fase P04: Classificazione
P04 è il cuore decisionale della pipeline: assegna il tipo (A, B, C.1, C.2 o SOSPESO) da cui dipende l'intero ramo successivo — se il tema è di tipo C, la pipeline devia prima su P05 (Spazializzazione); da lì in poi, e per i tipi A/B fin da subito, il tipo effettivo decide se si procede verso P07/P08 (ramo A) o P09a/b/c (ramo B).
L'analisi di uno Stato specifico è sempre di tipo B (per esempio «geopolitica della Francia» o «della Turchia»), anche se lo Stato ha regioni contese, minoranze o attori esterni che lo condizionano: queste circostanze si registrano come indizi contrari e zone grigie, non cambiano il tipo. L'unica eccezione è lo Stato fallito o destabilizzato (nessun governo che controlli di fatto il proprio territorio), per il quale vale la regola generale, di norma tipo A. Se il tema è invece una porzione dello Stato (una regione, un confine, una città) il tipo resta quello dell'accertamento sostanziale. Anche P01 ammette un tema di questo genere e non lo dichiara «riformulabile» per genericità.
/riclassifica, una sola volta per analisi, per imporre tu il tipo
(A, B, C.1 o C.2) con una motivazione obbligatoria — vedi la
sezione P10 (Autoverifica) per la strategia completa.
Fase P05: Spazializzazione
P05 esiste solo per i temi classificati tipo C in P04 — uno spazio non pre-individuato, come un settore merceologico o un fenomeno sociale. Il suo compito è ricostruire un vero perimetro spaziale a partire da un oggetto di studio che inizialmente non ne ha uno esplicito, e infine ricondurre il tema al tipo A o B, sbloccando così le fasi successive (P06 in poi).
Fase P06: Caratteri dello spazio
P06 non è una singola chiamata ma una catena di dodici sotto-fasi, una per ciascuna proprietà strutturale dello spazio, seguite da una sintesi trasversale (P06_sintesi). Il frontend le presenta come un unico passo della pipeline, ma tecnicamente sono tredici richieste separate .
Posizione assoluta: dove si trova lo spazio
La prima proprietà apre sempre con una breve localizzazione dello spazio: dove si trova e in quale ambiente (terrestre, marittimo, aereo, digitale…). Poi descrive solo le caratteristiche della geografia fisica — clima, rilievo, acque, coste, rischi naturali — che hanno un effetto sul potere in quello spazio, non un elenco di tutto ciò che esiste. È l'unica delle dodici proprietà che non può mai essere giudicata trascurabile: è il punto di partenza dell'analisi.
Estensione: anche il volume, non solo la superficie
Quando analizza quanto è esteso uno spazio, l'applicazione considera anche il suo volume. Una superficie marittima, per esempio, ha uno spazio aereo sopra e una colonna d'acqua, un fondale e un sottosuolo sotto; una superficie terrestre ha il sottosuolo e lo spazio aereo. Per ognuno indica se lo considera parte dello spazio analizzato e se chi controlla la superficie controlla anche quel volume. Lo fa anche se non l'hai selezionato tra gli ambienti nei parametri iniziali: li riporta come proiezioni dello spazio, senza cambiare quei parametri.
Tiene conto anche della grandezza assoluta dello spazio (superficie, profondità, larghezza), perché ha effetti politici in entrambe le direzioni: una grande dimensione pesa sulla politica interna ed estera, una dimensione ridotta sui flussi e sul controllo dell'area. Indica l'ordine di grandezza con la sua fonte e l'effetto che ne discende per quello spazio specifico.
Posizione relativa: ciò che sta vicino
Oltre al quadro regionale, l'applicazione valorizza ciò che si trova a ridosso dello spazio (un porto, un grande polo industriale o urbano, una base, un confine) e che lo condiziona per pura vicinanza. Per ogni prossimità importante indica chi la esercita, quale vincolo o opportunità produce e quanto è ineludibile. Le distanze riportate hanno una fonte; se una vicinanza non si riesce a verificare, viene dichiarata come lacuna e non presunta.
La posizione relativa non è un dato permanente: l'analisi indica da quando e per effetto di che cosa uno spazio è collocato così e perché oggi ha, o non ha, valore politico, prendendo come riferimento del passato i fattori di profondità storica di P02. Se in passato la condizione era diversa, dice com'era e che cosa è cambiato; se non è cambiata, lo dice e spiega perché. Date ed eventi specifici compaiono solo se hanno una fonte: altrimenti il passato è descritto in termini strutturali o dichiarato come lacuna. Il nesso tra ieri e oggi sta nell'inferenza principale, che è ciò che le fasi successive leggono.
Risorse: il valore dipende da chi guarda
Il valore di una risorsa è relativo in due sensi: da attore ad attore (la stessa risorsa vale cose diverse per attori diversi) e per lo stesso attore in tempi diversi (un attore disinteressato a uno spazio può interessarsene quando cambiano il prezzo del suo coinvolgimento o le sue necessità). Per ogni risorsa che conta l'analisi dice quindi per chi è tale, che valore ha per ciascuno e come cambia nel tempo, con i fattori di profondità storica di P02 come riferimento del passato. Distingue inoltre le risorse dalle poste in palio: una risorsa è una posta in palio solo se almeno due attori sono interessati a controllarla, se il controllo dell'uno ostacola quello dell'altro (una rivalità, non un accordo o un beneficio condiviso) e se la competizione è già visibile o ha una condizione concreta che la farebbe nascere; tutte le poste in palio generano competizione, non tutte le risorse. Nella scheda «Caratteri dello spazio», sotto Risorse, compare l'elenco con il chip «posta in palio». Gli attori citati qui sono un elenco di lavoro: l'analisi degli attori vera viene dopo.
Delimitazione: solo per spazi continui
La delimitazione riguarda le frontiere dello spazio, quindi ha senso solo se lo spazio è continuo. Se invece è un insieme di aree o nodi non contigui legati da relazioni funzionali (una filiera, una rete), non c'è una frontiera da analizzare e la proprietà ha peso nullo (non rilevante), con la motivazione. Se lo spazio è continuo solo in parte (per esempio un territorio con exclave o un arcipelago), la delimitazione è trattata soltanto per le porzioni continue, in poche righe. La continuità è fisica, non politica: confini contestati o incerti non rendono lo spazio discontinuo, sono anzi l'oggetto della delimitazione.
Classificazione delle proprietà dello spazio: il peso
Ogni proprietà ha un peso: alto, medio, basso o nullo. Il peso dice quanto la proprietà conta, rispetto alle altre, per capire chi ha il potere sullo spazio e perché è conteso, e decide anche quanto si scrive:
| Peso | Cosa significa | Come si scrive |
|---|---|---|
| alto | È tra le poche proprietà (di norma 3-4, al massimo 5 su 12) che reggono la lettura dei rapporti di potere sullo spazio. Prova: togliendola, cambierebbe la risposta alla domanda di ricerca oppure chi risulta avere potere o perché lo spazio è conteso | Analisi piena, con inferenza e con il motivo per cui conta |
| medio | Contribuisce in modo reale al quadro ma non lo spiega da sola: togliendola, la lettura cambierebbe nei dettagli, non nella sostanza. È il valore di partenza | Analisi piena, con inferenza |
| basso | Precisa un quadro che altre proprietà spiegano già: l'effetto c'è, ma è secondario o ripetuto altrove | Testo di 2 o 3 frasi e una sola inferenza breve |
| nullo | Nessun effetto, per uno di due motivi. (a) Nessun effetto sul potere in questo caso: applicando le domande della proprietà non emerge nulla di rilevante. (b) Non applicabile: manca un requisito strutturale (per esempio la continuità fisica per la Delimitazione, almeno due porzioni distinguibili per l'Articolazione interna — che è nulla anche quando la Composizione ha giudicato omogenea la distribuzione degli elementi —, una rete di spostamenti interni per la Mobilità in uno spazio molto limitato; per la Scalarità, il fatto che tutti gli attori coinvolti hanno la stessa scala d'azione: se invece coprono almeno tre scale diverse la Scalarità conta almeno come «medio»). Un confine contestato o incerto non rende una proprietà «non applicabile» | Solo la motivazione, specifica per questo caso, che dice se è il caso (a) o il caso (b) |
Il peso si assegna in due momenti. Durante l'analisi ogni proprietà viene giudicata da sola e riceve un peso iniziale. Alla fine di P06 le dodici sono confrontate tra loro e ricevono il peso finale, quello che vedi accanto a ogni proprietà: al massimo cinque (di norma tre o quattro) hanno peso alto. Il confronto serve perché valutata da sola quasi ogni proprietà sembra importante.
Le proprietà di peso alto sono le più rilevanti e sono quelle su cui il report si concentra; quelle di peso basso o nullo sono trascurabili e il report non dedica loro uno spazio proprio. Con questo criterio non si vedranno più dodici proprietà tutte di peso alto: se un tema le tocca tutte, il confronto indica comunque quali contano di più.
Spazi molto piccoli. La Mobilità misura il movimento dentro lo spazio, quindi conta tanto meno quanto più lo spazio è piccolo, mentre l'Accessibilità (i punti di passaggio verso l'esterno) conta tanto di più. Per una piazza, un quartiere o un isolotto la Mobilità ha peso nullo (non c'è una rete di spostamenti interni che conti) e l'Accessibilità ha peso almeno medio, di norma alto; per uno spazio contenuto, come un'isola piccola o una valle, la Mobilità è al più bassa e l'Accessibilità almeno media. La dimensione è quella dello spazio come lo hai delimitato nel perimetro di P02 (se lo estendi al quartiere intorno, vale l'insieme). Un luogo piccolo ma attraversato da un flusso (un valico, un ponte, un porto) fa eccezione: il flusso si analizza in Accessibilità e la Mobilità non è forzata a nullo, ma resta bassa.
Fase P07: Relazioni tra gruppi
P07 apre il ramo di tipo A (spazio senza attore dominante): analizza come i gruppi umani coinvolti si relazionano tra loro, prima ancora di descrivere i singoli attori (che arriva dopo, in P08). Riceve in input parametri, classificazione e la sintesi di P06.
Fase P08: Attori geopolitici
P08 completa il ramo di tipo A: mappa i singoli attori dello spazio, il loro peso e le loro narrazioni, sulla base delle relazioni già descritte in P07. La tassonomia delle categorie, i ruoli e la visibilità sono descritti in dettaglio nella sezione Attori: categorie, ruoli, visibilità — qui trovi come la fase li usa.
Fasi P09a/b/c: il ramo dell'attore dominante
Quando il tipo effettivo è B (uno spazio sottoposto al controllo di un attore dominante), la pipeline segue tre fasi in sequenza invece di P07/P08: coesione interna, intensità della presa, fattori di forza per la proiezione esterna. Tutte e tre si concentrano sullo stesso attore, identificato per primo in P09a.
P09a — Coesione interna
Prima cosa: identifica e nomina l'attore dominante (nome_attore). Poi
vaglia sistematicamente tutti e dodici i piani della coesione interna —
storico, demografico, istituzionale, immigratorio, mediatico, sociale,
politico_ideologico, geografico, etnico, religioso, culturale, infrastrutturale — un
validatore impone che compaiano tutti e dodici nell'array piani_coesione,
anche quelli dichiarati non pertinenti. Per ognuno: pertinente sì/no e, se sì,
un'analisi con valutazione (fattore di coesione / divisione / neutro). Chiude con
valutazione_complessiva (alta/media/bassa) e un'
inferenza_principale.
Fase P10: Autoverifica
P10 è la revisione critica dell'intera analisi. Legge tutte le fasi precedenti e identifica incoerenze, pregiudizi, assunzioni non fondate.
Cosa segnala P10
- Coerenza complessiva: soddisfacente / con riserve / problematica
- Fattori strutturali vs contingenti: sono chiaramente distinti?
- Leader-centrismo: l'analisi dipende troppo da un singolo attore?
- Monocausalità: si assegna troppo peso a una sola causa?
- Problemi rilevati: lista di problemi specifici con gravità (alta/media/bassa)
- Lacune non dichiarate: a differenza delle lacune viste durante l'analisi (vedi sezione Lacune dichiarate), qui P10 rilegge tutto il lavoro già fatto e segnala mancanze che avrebbero dovuto essere dichiarate prima e non lo sono state — un controllo a posteriori, non una dichiarazione nel momento in cui si scrive
Come applicare una correzione
Quando P10 suggerisce una correzione (es: "Riconsiderare i fattori basici di P07: la conflittualità non è sufficientemente radicata in fattori strutturali"), il suggerimento è informativo, non esecutivo.
/riclassifica [tipo] [motivazione] una sola volta, scrivendo il tipo che
vuoi assegnare (A, B, C.1 o C.2, in maiuscolo) e perché (es.
/riclassifica B il dominio è solo formale, nella sostanza nessuno lo controlla davvero).
Tipo e motivazione sono obbligatori. La pipeline ricomincerà da P05 con il tipo che hai
scelto e ripeterà tutte le fasi successive. È una tua decisione: l'applicazione non la
rifiuta e non la mette in discussione, anche se il metodo avrebbe deciso diversamente
(eventuali riserve vengono registrate e mostrate). La tua motivazione guida tutte le fasi
successive, e il report finale dichiara che la classificazione è stata imposta da te.
Nuova analisi) se il problema è critico,
oppure procedere comunque verso P11/P12/P13.
Strategia consigliata
- Leggi attentamente il riepilogo di P10
- Se sono presenti problemi di gravità alta in P04, considera
/riclassifica - Per problemi in fasi successive, continua comunque verso P11/P12/P13
- Nel report finale (P13), i limiti metodologici saranno documentati
/riclassifica può essere usato
una sola volta per analisi. Usalo solo se il tipo di classificazione è
significativamente sbagliato secondo te. Il tipo che indichi viene applicato sempre: non
è una richiesta di rivalutazione, ma una scelta che il sistema non può rifiutare. Dopo
averla usata non ne hai un'altra a disposizione.
Fase P11: Conclusioni
P11 chiude la parte analitica della pipeline: rilegge introduzione, sintesi di P06, il ramo completato (P07/P08 o P09a/b/c) e l'autoverifica di P10, e ne trae le conclusioni. È l'ultima fase prima degli scenari (P12) e del report (P13).
Fase P12: Scenari
P12 costruisce gli scenari futuri a partire dalle conclusioni di P11. È, per esplicita scelta del metodo, la fase con i vincoli più stringenti di tutta la pipeline .
Fase P13: Report narrativo
P13 non produce nuova analisi: assembla in prosa continua tutto ciò che
le fasi precedenti hanno già stabilito. Va invocata esplicitamente col comando
/concludi report dopo P12 — non parte da sola. È l'unica fase il cui output non è
pensato per essere letto come un messaggio strutturato in un certo formato, ma come testo narrativo leggibile.
Fase P14: Comparazione (opzionale)
P14 non fa parte del percorso lineare: si invoca col comando
/compara [descrizione del caso] dopo P11, per confrontare l'analisi appena
condotta con un altro caso proposto da te. Non è mai obbligatoria — P13 si genera
comunque senza passare da qui.
I tre divieti, verificati prima di tutto
Prima di procedere al confronto vero e proprio, P14 verifica esplicitamente tre
condizioni di ammissibilità — se anche una sola è violata, la comparazione viene
rifiutata (ammissibilita.ammessa = false), con motivazione e, quando
possibile, una proposta alternativa di confronto tra singoli aspetti omologhi invece che
tra i due casi nella loro interezza:
| Divieto | Cosa verifica |
|---|---|
| Categorie diverse | Gli attori protagonisti appartengono alla stessa categoria geopolitica — non basta la stessa categoria politologica: uno stato globale e uno stato minore non sono termini omogenei |
| Livelli di controllo diversi | I due spazi sono sottoposti allo stesso livello di controllo (entrambi contesi, o entrambi dominati) |
| Ambienti geopolitici diversi | I due casi appartengono allo stesso ambiente geopolitico (terrestre, marittimo, aerospaziale, extra-atmosferico, digitale…) |
Se la comparazione è ammessa
Il confronto procede aspetto per aspetto (mai i due casi nella loro
interezza): per ciascun aspetto, caso_principale vs
caso_confronto, le differenze_rilevanti e
un'inferenza. Chiude con variazioni_locali_emerse (differenze
che illuminano aspetti non visibili in una singola analisi) e
nuove_chiavi_lettura.
dichiarazione_limite_soggettivo, per rendere esplicito che è comunque un
giudizio interpretativo, non un calcolo oggettivo.
Lacune dichiarate
Durante l'analisi vedi comparire, nella sidebar "Lacune dichiarate", elementi che il modello segnala come mancanti invece di inventarli. Questa sezione spiega da dove nascono, cosa significano davvero, e come usarle.
Da dove nascono
Ogni fase riceve, tra le sue regole permanenti (lo stesso blocco iniettato in ogni fase, vedi Fonti e bibliografia), questa istruzione letterale:
In pratica: quando il modello dovrebbe affermare un dato preciso ma non ha una fonte verificabile a sostegno, l'alternativa all'inventare (o all'affermarlo comunque, senza basi) è dichiarare esplicitamente cosa manca. Ogni lacuna ha due parti:
| Campo | Cosa contiene |
|---|---|
cosa_servirebbe |
Che informazione mancherebbe per colmare il punto (es. "dato demografico aggiornato al 2025", "testo integrale dell'accordo non reso pubblico") |
impatto_sulla_analisi |
Quanto quella mancanza pesa sulle conclusioni — testo libero scritto dal modello, non un valore da un elenco fisso (vedi più sotto perché questo conta) |
In quali fasi possono comparire
Solo le fasi che devono affermare fatti verificabili hanno un campo lacune
nel proprio schema: P03 (Introduzione), P05
(Spazializzazione), ogni sotto-fase di P06 (le 12 proprietà strutturali)
più P06_sintesi, P07 (Relazioni), P08
(Attori), P09a/P09b/P09c (coesione, presa, fattori di forza — solo tipo
B, attore dominante).
Non compaiono in P01, P02, P04, P12, P13, P14. Sono fasi di setup,
classificazione, generazione di scenari o assemblaggio — P04, ad esempio, esprime
l'incertezza in altro modo, con il campo confidenza (alta/media/bassa),
non con lacune.
Due campi diversi, spesso confusi con le lacune
P10 e P11 hanno campi che sembrano lacune ma non lo sono, nello stesso senso:
| Fase | Campo | Cosa rappresenta davvero |
|---|---|---|
| P10 — Autoverifica | lacune_non_dichiarate_rilevate |
Audit a posteriori: il modello rilegge tutto il lavoro già fatto e segnala mancanze che avrebbero dovuto essere dichiarate prima (con il meccanismo qui sopra) e non lo sono state — non è una dichiarazione nel momento in cui si scrive, è un controllo di qualità retrospettivo |
| P11 — Conclusioni | lacune_rimaste_aperte |
Sintesi finale: semplice elenco di frasi, quello che resta irrisolto una volta arrivati alle conclusioni — un riepilogo per il lettore, non una nuova dichiarazione puntuale |
Come vengono raccolte e mostrate
Il server cerca ricorsivamente un array lacune ovunque si trovi nell'output
di ogni fase (a seconda della fase può essere alla radice o annidato, come per le fonti —
vedi Fonti e bibliografia) e lo accumula per l'intera
sessione. La sidebar mostra sempre il totale accumulato fino a quel
momento, non solo quelle dell'ultima fase completata.
Le lacune in sidebar sono ordinate per gravità stimata, dedotta dal
testo di impatto_sulla_analisi cercando parole chiave comuni in italiano
(es. "critico", "significativo" → gravità alta; "marginale", "trascurabile" → gravità
bassa) — quelle ad alto impatto salgono in cima con un bordo rosso e ⚠, quelle a basso
impatto scendono con un bordo grigio.
impatto_sulla_analisi è testo libero scritto dal modello, non un valore
strutturato tra alternative fisse — non c'è modo di leggerne la gravità con certezza
meccanica. Una lacuna il cui testo non contiene nessuna delle parole chiave riconosciute
resta "non specificato" e mantiene l'ordine di arrivo: leggi comunque il testo per intero
prima di dare peso alla posizione in lista.
Dove le trovi
- Sidebar "Lacune dichiarate" durante l'analisi, sempre aggiornata al totale reale
- Scrivendo
statoin chat, che riporta comunque l'elenco completo accumulato - Nei documenti salvati ("Salva chat" e "Salva report finale"): una sezione dedicata elenca tutte le lacune dichiarate, nello stesso ordine per gravità della sidebar
Come interpretarle
impatto_sulla_analisi
(non solo la sua posizione in lista) per decidere se vale la pena colmarla — ad esempio
fornendo tu stesso l'informazione mancante nel messaggio successivo, prima che la pipeline
prosegua oltre il punto in cui servirebbe.
Fonti e bibliografia
Ogni fase può citare fonti a sostegno delle proprie affermazioni. Alla fine dell'analisi (P13), tutte le fonti raccolte lungo il percorso confluiscono in una bibliografia unica, allegata al report.
Da dove vengono raccolte
Non solo alla fine: dopo ogni singola fase, l'app cerca ricorsivamente
un array fonti ovunque si trovi nell'output — a seconda della fase può essere
alla radice, oppure annidato (es. dentro ogni indizio di P04, dentro ogni proprietà di P06,
dentro ogni attore di P08) — e lo accumula in una lista di sessione. Alla fine, quella lista
diventa la bibliografia completa.
La regola che genera le fonti
Ogni fase riceve, oltre alle sue istruzioni specifiche, un identico blocco di regole permanenti. Due riguardano direttamente le fonti:
- Nessun fatto senza fonte: il modello non può asserire dati specifici (cifre, date, citazioni, assetti attuali) senza una fonte verificabile o fornita da te. Se non ce l'ha, deve dichiarare una lacuna invece di inventare.
-
Ogni affermazione "accertata" richiede una fonte: se il tipo di
un'informazione è
informazione_accertatama non c'è una fonte reale a supporto, il modello scriveinferenza_propria— un modo per segnalare "questo è un mio ragionamento, non un dato verificato". Anche il valore "Analista" con anno assente ("n.d.") ha lo stesso significato.
Inferenza propria e
Analista (n.d.) non sono fonti verificabili dal lettore — sono etichette che
il modello usa quando non ne ha una vera. La bibliografia finale le esclude automaticamente,
insieme ai duplicati (stesso autore, titolo e URL).
Da dove viene, davvero, ogni fonte
Ogni fonte dichiara una provenienza, uno dei quattro valori seguenti:
| Provenienza | Etichetta mostrata in bibliografia | Cosa significa in pratica |
|---|---|---|
ricerca_web_attiva |
🌐 verificata via ricerca web | Il modello dichiara di averla trovata cercando sul web |
fornita_da_utente |
fornita dall'utente | L'hai indicata tu nel testo scritto in chat |
file_conoscenza |
da file di conoscenza del metodo | Riferita ai file metodologici interni dell'app (usati per guidare il ragionamento, non come fatti da citare — vedi sotto) |
documento_allegato |
da documento allegato | Valore previsto dallo schema, ma l'app non ha oggi una funzione per allegare documenti: in pratica non compare |
eil_certificato |
📚 documento certificato (EIL) | Un documento della base di conoscenza certificata EIL (vedi la sezione Modalità di conoscenza). Compare solo nelle modalità Certificata / Mista |
eil_elaborazione |
📚 elaborazione interna (EIL) | Una sintesi interna di EIL (voce wiki / evidence): non entra in bibliografia come fonte, resta solo contesto |
ricerca_web_attiva
vengono dalla sua conoscenza pregressa, non da una verifica in tempo reale, e la bibliografia le
etichetta «non verificata». Vanno trattati come affermazioni da controllare tu stesso,
non come citazioni già verificate. La ricerca web reale parte solo per i «fatti di riferimento» (una ricerca prima dell'introduzione, se l'amministratore li ha attivati),
per la «Ricerca approfondita» (colma le lacune dichiarate, entro il tetto di ricerche per analisi fissato dall'amministratore; con tetto 0 non lo fa) e, in modalità «Mista integrata»,
per l'arricchimento EIL; richiede l'accesso a internet attivo — è attivo di default e torna
su "attivato" quando l'utenza «admin» rilancia l'app (apre una nuova analisi o riprende quella in corso; non riaprendo la pagina di
configurazione, che invece mostra lo stato reale). Gli altri utenti non lo cambiano: se l'amministratore lo spegne, resta spento finché non lo rilancia lui. Quindi, per evitare
il costo aggiuntivo del grounding per le analisi in corso, l'amministratore deve spegnerlo di
proposito dopo ogni suo rilancio. Anche con la ricerca riuscita non dare per scontato ogni risultato: verifica comunque le
fonti che contano davvero per la tua analisi.
I file di conoscenza (knowledge/*.md) sono invece un caso diverso: vengono
caricati per davvero nelle istruzioni della fase, ma sono guide sul metodo
(come ragionare), non fatti sul tema analizzato — una regola permanente vieta esplicitamente
al modello di citare come dato gli esempi contenuti in quei file.
Quanto è autorevole ogni fonte — il campo natura
Sotto ogni voce della bibliografia trovi una o più etichette (es. fonte
primaria, fonte secondaria — verificare, oltre alla
provenienza vista sopra): sono due campi diversi e indipendenti. La provenienza dice
da dove il modello l'ha presa; natura dice quanto
dovresti fidartene — la stessa gerarchia di autorevolezza descritta in dettaglio nel
file di metodo knowledge/06-fonti-e-retorica.md, che ogni fase consulta
prima di accettare una fonte.
| Etichetta in bibliografia | Campo natura | Cosa significa |
|---|---|---|
| fonte primaria | primaria |
Massima autorevolezza: riviste scientifiche peer-reviewed (in particolare Fascia A ANVUR o indicizzate su Scopus/Web of Science), libri e collettanee accademiche, atti di convegni ed enciclopedie scientifiche (es. Treccani), manuali universitari di settore, rapporti e banche dati di organizzazioni intergovernative (ONU, UE, NATO, Banca Mondiale, FMI, OCSE...) e think tank riconosciuti (ISPI, IAI, SIPRI, RAND Corporation, Chatham House, CSIS...), siti e archivi ufficiali di questi enti. |
| fonte secondaria — verificare | secondaria_verificata |
Autorevolezza minore, da usare con circospezione e possibilmente previo riscontro incrociato con una fonte primaria: recensioni su riviste di settore o blog accademici, resoconti non ufficiali di convegni, contenuti audio/video di canali indipendenti o divulgativi (solo se le tesi esposte sono riscontrabili altrove in fonti primarie), articoli di stampa internazionale o nazionale di comprovata reputazione (es. Foreign Affairs, Le Monde Diplomatique, Financial Times, The Economist) — distinguendo sempre un reportage fattuale da un editoriale d'opinione. |
natura valido: una regola permanente
vieta al modello di aggiungere queste fonti a fonti[], nemmeno come voce
secondaria. Se l'unica informazione disponibile su un punto viene da una fonte di
questo livello, il modello deve dichiarare una lacuna invece di
citarla — coerente con la regola "nessun fatto senza fonte".
Il formato della citazione cambia in base al tipo di fonte
Ogni fonte dichiara anche un campo tipo_fonte, che determina quali dettagli
compaiono nella citazione stile APA — non è lo stesso identico formato per tutte le voci:
Campo tipo_fonte | Dettagli aggiuntivi mostrati |
|---|---|
rivista_scientifica |
Volume ed eventuale fascicolo tra parentesi, pagine (es. Rivista di Studi Politici, 12(3), 45-67) — se presenti nella fonte |
libro |
Edizione tra parentesi e luogo di pubblicazione, se presenti (es. L'analisi geopolitica (3ª ed.). Carocci, Roma) |
sito_web |
Nessun dettaglio aggiuntivo nel corpo della citazione, ma se la fonte dichiara una data di consultazione il link viene introdotto da "Consultato il [data], da:" invece del generico "Disponibile su:" (vedi sotto) |
rapporto_istituzionale, articolo_stampa, altro |
Formato generico: autore, anno, titolo in corsivo, editore — nessun campo specifico aggiuntivo |
Volume, fascicolo, pagine, edizione, luogo di pubblicazione e data di consultazione sono tutti campi facoltativi: se il modello non li valorizza, la citazione ricade comunque nel formato generico corretto per quel tipo, senza campi vuoti o mancanti visibili.
Il link alla fonte
Quando una fonte ha un URL, compare in coda alla citazione preceduto da "Disponibile su:" (o "Consultato il [data], da:" per i siti web con data di consultazione dichiarata, vedi sopra). Il testo del link normalmente è l'indirizzo stesso — con un'eccezione:
vertexaisearch.cloud.google.com/grounding-api-redirect/...), non l'URL
reale della pagina. L'app prova a risolverlo lato server prima di mostrarlo; se ci
riesce, vedi l'indirizzo vero per intero. Se il redirect sopravvive (risoluzione fallita
o non disponibile su quel server), il link resta comunque funzionante al click, ma il
testo mostrato diventa la dicitura fissa "Link alla fonte" invece della stringa di
redirect, illeggibile e poco utile da mostrare per intero.
Citazioni in-text e numerazione
Nel testo del report, le affermazioni che derivano da una fonte specifica sono accompagnate da una citazione tra parentesi quadre e in corsivo, del tipo [Autore, Anno, N] — dove N è il numero della voce corrispondente qui in bibliografia (mostrato anch'esso tra parentesi quadre davanti a ogni voce, riferimento metodologico compreso, che è sempre la voce numero 1). Quando un'affermazione è confermata da più fonti indipendenti, compaiono insieme nella stessa parentesi, es. [Rossi, 2021, 3; Bianchi, 2022, 5] — un modo semplice per distinguere a colpo d'occhio un dato corroborato da più fonti da uno sorretto da una sola. Una parentesi nel testo che non corrisponde esattamente a una voce della bibliografia resta tonda, non quadra: non è una citazione, solo un inciso del testo.
Orientamento dichiarato
Quando una fonte esprime un punto di vista riconoscibile — un think tank vicino a un
determinato governo, un editoriale schierato, un canale che rappresenta gli interessi
di un attore specifico — il modello può valorizzare il campo facoltativo
orientamento_dichiarato. In bibliografia compare come nota a margine sotto
la citazione (es. "Orientamento dichiarato: vicino al governo di X"): non è un
giudizio di valore dell'app, serve solo a segnalarti che quella fonte non è neutra "per
definizione" e va letta tenendone conto — coerente con la regola di pluralismo delle
prospettive del report finale.
Come si arriva alla bibliografia finale
- Ogni fase completata contribuisce le proprie fonti alla lista di sessione
- A P13, i link di redirect da ricerca web (grounding) vengono risolti all'URL reale, dove possibile (vedi sopra)
- La lista completa viene deduplicata (stesso autore+titolo+URL, senza distinguere maiuscole)
- Le voci segnaposto (
Inferenza propria,Analista) vengono escluse - Viene aggiunto un riferimento fisso, sempre presente: Boria, E. — L'analisi geopolitica (il testo metodologico su cui si basa l'intero approccio)
- L'elenco finale è ordinato alfabeticamente per autore
- Ogni voce riceve il numero progressivo mostrato tra parentesi quadre (il riferimento metodologico è sempre il numero 1) — lo stesso numero usato nelle citazioni in-text del report
Attori: categorie, ruoli, visibilità
Nella sezione P08 — Attori geopolitici del report (ramo di tipo A,
multi-attore), ogni riga della tabella descrive un attore con quattro campi: Nome,
Categoria, Ruolo e Visibilità. Sono
tre vocabolari chiusi (il modello sceglie da un elenco fisso, non inventa etichette),
definiti nel file di metodo knowledge/04-attori.md che la fase usa per
costruire il proprio prompt.
Categoria — la tassonomia degli undici attori
Undici categorie, classificate per orizzonte d'azione, obiettivo reale e grado di istituzionalizzazione. Non è un dettaglio formale: la categoria condiziona cosa quell'attore può realisticamente ottenere e quali vincoli subisce — ignorarla porta a giudicare le mosse di un attore con il metro di un altro.
| Categoria | Cosa persegue tipicamente |
|---|---|
potenza_globale | Egemonia estesa anche oltre i propri confini formali, proiettata sia direttamente (presenza militare) sia indirettamente (dipendenza economica, sudditanza politica) |
organizzazione_internazionale_universale | Gestire pacificamente l'ordine vigente promuovendo la cooperazione — capacità in genere bassa, dipende dagli stati membri che la finanziano |
colosso_transnazionale_privato_lucro | Profitto da un'attività economica; sottostà (almeno formalmente) alle leggi statali |
entita_transnazionale_privata_no_profit | Proselitismo: il numero di aderenti è la sua misura di potenza, per portare avanti battaglie ideali |
movimento_contestazione_radicale | Rovesciare, corrompere o intralciare il modello e l'autorità dominanti; tipicamente non istituzionalizzato, rischia la repressione |
potenza_regionale | Acquisire influenza e status nella propria area, spesso approfittando del disordine internazionale |
organizzazione_internazionale_regionale | Integrare e stabilizzare un'area per rafforzarne coesione e status |
raggruppamento_umano_non_politicizzato | Etnie, civiltà, nazioni: rafforzare la coesione interna e diffondersi, spinte da un forte richiamo identitario |
ente_pubblico | Contribuire al funzionamento dello stato — capacità in genere bassa, molto variabile tra modelli accentrati e decentrati |
realta_ufficiale_anti_statale | Partiti regionalisti, movimenti localistici: difendere interessi e identità locali contro l'autorità centrale |
entita_non_istituzionalizzata | Poteri mediatici, logge, lobby, movimenti d'opinione, gruppi terroristici: interessi di parte, spesso perseguiti in modo occulto |
Ruolo — oltre dominatore e dominato
Il metodo mette in guardia esplicitamente dal farsi attrarre dalle due figure "idealtipiche" di dominatore e dominato: molti attori reali ricadono in posizioni intermedie. Nel tipo A, inoltre, nessun attore può essere classificato «dominatore»: lo spazio è, per definizione, senza attore dominante. L'attore più forte si descrive con il controllo de facto e con l'intensità del controllo, non con il ruolo; se un attore sembra davvero dominare lo spazio, la fase lo dichiara tra le lacune (la classificazione di tipo A potrebbe essere da rivedere) e non lo chiama dominatore. Un validatore impone che nell'elenco compaia almeno un ruolo non polarizzato, proprio per impedire che l'analisi collassi sui due estremi.
| Ruolo | Significato |
|---|---|
dominatore | Non assegnato nelle analisi di tipo A (per definizione nessun attore domina lo spazio): non è tra i ruoli ammessi in questa fase; compare solo nelle analisi salvate prima e come nodo dell'attore dominante nel grafo di tipo B. Significava: esercita il controllo effettivo sullo spazio o sulla situazione contesa |
dominato | Subisce quel controllo |
mediatore | Si frappone tra i poli, senza essere parte del controllo o della contesa |
coinvolto_indirettamente | Non è un polo della contesa, ma ne è comunque toccato |
beneficiario_passivo | Trae vantaggio da un assetto di potere che non ha contribuito a determinare |
garante | Assicura la tenuta di un equilibrio tra altri attori, senza essere lui stesso uno dei poli |
guastatore | Agisce per alterare o disturbare un equilibrio esistente tra altri attori |
Visibilità — non è la stessa cosa del peso reale
Alta, media o bassa: quanto un attore è esposto/riconoscibile pubblicamente — non quanto conta davvero. Il metodo segnala un rischio specifico: la copertura mediatica dà risalto in base a ciò che colpisce il pubblico, non in base all'importanza politica reale, per cui attori a bassa visibilità (reti informali, lobby, apparati poco trasparenti) rischiano di restare fuori da un'analisi che parte dai soggetti più evidenti. Per questo un validatore impone che nell'elenco compaia almeno un attore a visibilità bassa: è una spinta a cercarli attivamente, non un dettaglio decorativo.
Salvataggio e gestione dei report
L'app ti permette di salvare l'intera chat di analisi e il report finale in formato HTML, gestendoli su server: scaricare, rinominare, eliminare.
Salvataggio automatico
Non devi ricordarti di salvare: alla fine di ogni fase la chat dell'analisi viene salvata da sola, e alla fine del report (P13) viene salvato da solo anche il report finale. Sotto «📋 I miei report» compare l'orario dell'ultimo salvataggio.
- Per ogni analisi c'è un solo file di chat e un solo report finale: a ogni fase il file viene aggiornato, non ne nascono di nuovi. Una nuova analisi ha i suoi file.
- I file hanno nomi come
chat_<tema>_del_<data>.htmlereport_finale_<tema>_del_<data>.html(data e ora del primo salvataggio) e compaiono nell'elenco di «I miei report», dove puoi scaricarli, rinominarli (il file continua a essere aggiornato) o eliminarli (se lo elimini, il salvataggio successivo lo ricrea). - I file che salvi tu a mano con «💾 Salva chat» e «💾 Salva report finale» sono distinti e non vengono mai sovrascritti.
- Se riprendi un'analisi interrotta («Riprendi l'analisi») il salvataggio riparte dalla fase successiva e aggiorna lo stesso file; la chat salvata contiene i risultati di tutte le fasi, ma non i messaggi che avevi scritto prima dell'interruzione.
- Se il salvataggio non riesce compare «Salvataggio automatico non riuscito»; al salvataggio successivo il report viene ritentato.
Nomi dei file, limiti e apertura
- I file sono sempre
.html. Se rinomini un report, la pagina ti conferma il nome effettivo («✓ Rinominato: …»): lettere, cifre, spazi e i simboli. _ - ( )restano, ogni altro carattere diventa «_», un nome che comincia con il punto perde il punto e, se manca, viene aggiunto «.html». - Limiti per utente: ogni report pesa al massimo 2 MB (un report normale è di 100–150 KB), puoi avere al massimo 300 report e 100 MB in tutto (l'amministratore può cambiare questi limiti). Se ne superi uno compare l'avviso con il motivo — «Il report è troppo grande…», «Hai raggiunto il numero massimo di report salvati: elimina quelli che non ti servono» oppure «Lo spazio per i report è esaurito…» — e il file non viene salvato: elimina i report che non ti servono e riprova. Se succede durante il salvataggio automatico compare «Salvataggio automatico non riuscito».
- Un report si apre come pagina statica, senza script: testo, tabelle e collegamenti funzionano (i collegamenti esterni si aprono in una scheda normale), mentre pulsanti o funzioni interattive eventualmente presenti nel file non fanno nulla.
Accesso alla gestione report
Nel sidebar sinistro, clicca il pulsante 📋 I miei report per aprire la modalità di gestione. Qui trovi:
- Due pulsanti di salvataggio rapido
- Elenco di tutti i report già salvati
- Azioni per ciascun report (scarica, rinomina, elimina)
Tipi di report
L'app ti permette di salvare due cose diverse:
1. Chat di analisi completa (analisi_del_[data].html)
- Contiene tutta la conversazione (messaggi dell'utente e risposte del sistema)
- Utile per documentare l'intero processo di analisi
- Formattato come pagina HTML leggibile
- Pulsante: 💾 Salva chat
2. Report finale (nome proposto: report_finale_analisi_del_[data].html)
- Contiene i risultati di tutte le fasi completate, una sezione per fase in ordine, con un indice delle fasi in testa, il tema analizzato e la classificazione
- In coda, le lacune dichiarate; se l'analisi è arrivata a P13, anche il grafo attori e relazioni e la bibliografia
- Non include i pannelli «Azioni disponibili», il JSON tecnico, i chip dei token né l'elenco «Siti Web visitati»: è un documento pulito, pensato per essere letto o condiviso
- La sezione P02 si intitola «Parametri dell'analisi» e riporta i parametri definitivi, con gli stessi nomi dei campi della chat; non contiene il pulsante «Modifica parametri» (che in un file statico non funzionerebbe)
- Più ordinato e compatto della chat completa, che invece conserva anche i tuoi messaggi
- Pulsante: 💾 Salva report finale (disponibile dopo almeno una fase completata)
Nome del file
Quando premi un pulsante di salvataggio, l'app ti chiede il nome del file in una finestra di dialogo, già compilata con un nome proposto che contiene data e ora (fuso orario italiano):
Puoi accettarlo o scriverne uno tuo (per esempio report_Hormuz_agosto.html); se annulli, non viene salvato nulla.
Il nome viene reso sicuro dal server: / e \ diventano spazi, i caratteri insoliti diventano _,
l'estensione .html viene aggiunta se manca, e se nella tua cartella esiste già un file con quel nome
ne viene creato uno nuovo con un numero: nome (2).html, nome (3).html…
Azioni sui report
⬇ Scarica
Scarica il file HTML nel tuo computer. Puoi aprirlo in qualsiasi browser senza necessità di connessione internet.
✏ Rinomina
Rinomina il file con un nome personalizzato. Esempi:
analisi_Stretto_di_Hormuz.htmlreport_geopolitica_Pacifico.html2026_Q3_area_MENA.html
L'estensione .html viene aggiunta automaticamente se omessa.
✕ Elimina
Elimina definitivamente il file dal server. Richiede conferma. Non è possibile recuperare un file eliminato, quindi usa con cautela.
Informazioni metadata
Per ciascun report salvato, puoi vedere:
- Tipo: analisi | report_finale
- Dimensione: in KB
- Data di salvataggio: GG/MM/AAAA HH:MM
- Token e costo dell'analisi che ha prodotto il documento (per esempio 412.000 tok · $0.4944), nella valuta e al listino in vigore al momento del salvataggio: restano quelli anche se in seguito i prezzi cambiano. Non compaiono per i file salvati prima che questa informazione venisse registrata.
Il nome del file nella lista è un link: lo apre in una nuova scheda del browser, senza scaricarlo.
Come usare i report HTML
I file HTML salvati sono documenti autoportanti e professionali:
- Scarica il file dal pannello report
- Apri nel browser (o condividi per email)
- Stampa in PDF (Ctrl+P) se hai bisogno di un formato statico
- Modifica con un editor HTML se vuoi personalizzarlo ulteriormente
Dove vengono archiviati
I file vengono salvati nel server backend, in una cartella personale (storage/reports/<tuo utente>_<id>/).
Ogni utente vede e gestisce solo i propri report: nessun altro account può elencarli, aprirli, rinominarli
o eliminarli (gli amministratori possono solo consultarli e scaricarli, vedi la sezione dedicata della guida amministratore).
Rimangono disponibili finché non li elimini.
Registrazione e cambio password
Per avere un account su ANGST si compila un modulo online di richiesta accesso; la stessa pagina serve anche a cambiare la password o a recuperarla se l'hai dimenticata.
Apri il modulo di richiesta accesso (
registrazione.html, nello stesso sito in cui stai usando ANGST). Per cambiare o recuperare la password
vai direttamente al modulo «Cambia o recupera la password».
Come richiedere un account
- Apri la pagina di richiesta accesso (titolo «Modulo di richiesta accesso alla applicazione ANalisi Geopolitica STrutturale (ANGST)»).
- Scrivi il tuo Nome, la tua Email/Username e una Password di almeno 8 caratteri (il bottone Mostra la rende leggibile mentre scrivi). La username per entrare in ANGST sarà questa email: scrivi un indirizzo che usi davvero, perché è lì che arriveranno le comunicazioni.
- Clicca Invia. La richiesta non crea ancora l'account: resta in attesa finché un amministratore la accetta o la rifiuta.
- Quando la richiesta viene accettata ricevi una email di conferma con il link per entrare nell'applicazione. L'email non contiene la password: è quella che hai scelto tu. Controlla anche la casella Spam o posta indesiderata.
- Se scrivi un indirizzo già presente, la pagina avvisa che quell'email è già stata utilizzata: hai già una richiesta o un account, quindi non serve ripetere la richiesta.
- Se un campo non è valido (nome mancante, email non corretta, password troppo corta) il messaggio compare sotto il campo. Troppi tentativi ravvicinati dalla stessa rete fanno comparire «Troppi tentativi»: riprova più tardi.
Cambiare la password
Nella pagina di richiesta accesso clicca «Hai già una richiesta o un account? Cambia o recupera la password»: si apre il modulo «Cambia o recupera la password». Funziona sia se la tua richiesta è ancora in attesa sia se hai già un account.
- Scrivi la tua Email/Username, la password corrente e la nuova password (da 8 a 72 caratteri, diversa dalla corrente).
- Clicca Cambia password. La pagina mostra «La password corrente ti è stata inviata via email. Controlla anche la casella Spam o posta indesiderata».
Senza la password corrente non si cambia nulla: conoscere un indirizzo email non basta per prendere l'account di un'altra persona.
Se hai dimenticato la password
- Nello stesso modulo scrivi solo la tua Email/Username.
- Clicca «Ho dimenticato la password: inviamene una nuova via email». Se l'indirizzo corrisponde a un account, l'applicazione genera una password nuova, che sostituisce la precedente, e la manda a quell'indirizzo.
- La pagina mostra sempre lo stesso messaggio — «Se l'indirizzo corrisponde a un account, la password ti è stata inviata via email…» — anche se hai sbagliato a scrivere l'indirizzo o se l'account è di un amministratore: per sicurezza non dice se un indirizzo esiste. Se dopo qualche minuto non arriva nulla (guarda anche nello Spam), controlla di aver scritto l'indirizzo giusto e riprova.
- Entra con la password ricevuta. Se vuoi, cambiala subito con una tua, come sopra.
Da tenere a mente
- Il link nell'email di conferma (
registrazione.html#password) apre direttamente il modulo per cambiare o recuperare la password. - Per sicurezza i tentativi sono limitati (pochi all'ora per indirizzo email): se compare «Troppi tentativi», riprova più tardi.
- Le password degli amministratori non si reimpostano da qui: le reimposta un altro amministratore.
- Conserva l'email con la password in un posto sicuro e non inoltrarla. Se il login è bloccato per troppi tentativi sbagliati, vedi le Domande frequenti.
Domande frequenti
Che cosa succede se non digito nulla?
L'app rimane in attesa. Digita qualcosa (anche solo "continua") o fai click su un comando per proseguire alla fase successiva.
Posso tornare indietro a una fase precedente?
No, tranne con /riclassifica che ricomincia da P04.
Se hai bisogno di riconsiderare fasi precedenti, devi resettare l'analisi
(pulsante "Nuova analisi") e ricominciare dal principio.
Cosa significa "Tipo SOSPESO"?
Se in P04 la classificazione non è chiara (né A né B), il tipo rimane SOSPESO. P06 (Caratteri dello spazio) fornisce ulteriori indizi per risolverlo in P06_sintesi. Se rimane indeterminato, si usa A come fallback.
Le lacune dichiarate bloccano l'analisi?
No. Le lacune (dati mancanti, fonti non disponibili, ipotesi non testate) si registrano lungo il percorso, senza mai bloccare il flusso — vedi la sezione Lacune dichiarate per il dettaglio completo su come nascono, dove trovarle e come interpretarle.
Cosa fare se P10 segnala molti problemi?
Leggi la gravità di ciascun problema. Se ci sono problemi alti in P04,
considera /riclassifica [tipo] [motivazione] — tipo e motivazione sono
obbligatori e il tipo che indichi viene applicato sempre. Per problemi in
fasi successive, procedi verso il report finale (P13) che documentarà i limiti
metodologici.
Posso salvare l'analisi? Cosa succede se ricarico la pagina?
L'analisi è salvata sul server, collegata alla tua sessione (che dura 2 ore di inattività, vedi
«Per quanto tempo resto collegato?»). Se ricarichi la pagina, la riapri da un'altra scheda o torni
dalla pagina Amministrazione, non viene più azzerata: la chat compare con la scelta
«Riprendi l'analisi» o «Nuova analisi». «Riprendi» ricostruisce tutte le fasi già completate
dallo stato salvato e ti riporta al pannello di quella corrente: prosegui con /continua.
Se il blocco «Caratteri dello spazio» era a metà, riparte dalla proprietà successiva senza rifare le altre.
«Nuova analisi» la azzera (e non si recupera dalla pagina). Passate le 2 ore di inattività, dopo un nuovo
accesso, o con «Nuova analisi», l'analisi non è più raggiungibile da qui: salva comunque il report
(comando /concludi report, oppure «Salva report finale» a fine analisi) per conservarlo.
La barra dell'analisi automatica è ferma da minuti: è bloccata?
Probabilmente no. Quando ci sono molte analisi in corso insieme, il servizio di intelligenza artificiale
consente solo un certo numero di richieste e di testo al minuto: le chiamate in eccesso aspettano il
proprio turno. In questo caso, sotto la barra compare l'avviso «In coda per il limite di richieste
di Gemini» con i secondi di attesa e la fase interessata: l'analisi riprende da sola, non serve
fare nulla né ricominciare. Lo stesso avviso (con un testo diverso) compare se il servizio chiede di
rallentare e il sistema ripete la richiesta dopo qualche secondo. L'avviso sparisce appena la fase riparte.
Se invece il servizio non è disponibile (per esempio per un problema di abbonamento), l'analisi si ferma
subito con un messaggio che ti chiede di contattare l'amministratore, e potrai proseguire con
/continua quando sarà ripristinato.
Come accedo? Cosa devo scrivere nel campo «Email/Username»?
Nella pagina di accesso il primo campo si chiama Email/Username: la tua username è l'indirizzo email con cui hai chiesto l'accesso (lo stesso che ti è stato scritto nell'email di conferma). Nel secondo campo va la password che hai scelto nel modulo di richiesta.
Compare «Troppi tentativi di accesso»: che cosa devo fare?
Per proteggere gli account, dopo 10 password sbagliate in 15 minuti per lo stesso Email/Username l'accesso si blocca: compare «Troppi tentativi di accesso. Riprova tra N minuti.» e il blocco vale anche se questa volta la password è giusta. Aspetta il tempo indicato e riprova, senza insistere (i tentativi durante il blocco non lo allungano). Se non ricordi la password, usa nel frattempo «Ho dimenticato la password» (vedi la domanda seguente). Quando entri, il conteggio riparte da zero.
Il blocco dura al massimo 15 minuti e passa da solo. Se hai urgenza non devi fare altro che chiedere all'amministratore: può sbloccare subito tutti gli accessi. Non è un problema dell'account: la password e i dati restano come prima.
Come cambio la password, o la recupero se l'ho dimenticata?
Apri la pagina di richiesta accesso (registrazione.html) e scegli
«Hai già una richiesta o un account? Cambia o recupera la password»: si apre un modulo, intitolato «Cambia o recupera la password», con cui cambiare la password
oppure, se l'hai dimenticata, ricevere una nuova via email. Funziona sia se la tua richiesta è ancora in attesa di approvazione sia se hai già un account.
- Cambia password: scrivi la tua Email/Username, la password corrente e la nuova (almeno 8 caratteri, diversa dalla corrente).
- Ho dimenticato la password: scrivi solo l'Email/Username e clicca il secondo bottone. L'applicazione genera una password nuova, che sostituisce la precedente, e te la manda per email.
- In entrambi i casi l'email con la password arriva all'indirizzo dell'account. Con «Cambia password» la pagina mostra «La password corrente ti è stata inviata via email. Controlla anche la casella Spam o posta indesiderata»; con «Ho dimenticato la password» mostra sempre «Se l'indirizzo corrisponde a un account, la password ti è stata inviata via email…», anche se hai sbagliato a scrivere l'indirizzo (per sicurezza la pagina non dice se un indirizzo ha un account): se non arriva nulla, controlla di aver scritto l'indirizzo giusto e guarda nello Spam. Conservala e non inoltrare l'email.
- Per motivi di sicurezza i tentativi sono limitati (pochi all'ora per indirizzo): se compare «Troppi tentativi», riprova più tardi. Le password degli amministratori non si reimpostano da qui.
Per quanto tempo resto collegato?
Il collegamento dura 2 ore di inattività. Finché la pagina dell'analisi è aperta e l'hai usata di recente, l'applicazione lo rinnova da sola ogni 5 minuti: puoi fermarti anche a metà analisi senza dover rifare il login. Se la sessione scade lo stesso (per esempio dopo molte ore di inattività) compare in alto una barra rossa con il pulsante Accedi di nuovo; dopo l'accesso l'analisi in corso non viene ripresa automaticamente.
Quale modello usa questa app?
Un modello Gemini di Google con output strutturato (JSON conforme agli schemi di ogni fase). Quale modello esattamente lo sceglie l'amministratore nella configurazione del server e può cambiare nel tempo: se ti serve saperlo, chiedilo a chi gestisce l'app.
I dati della mia analisi vengono inviati da qualche parte?
I dati vengono inviati a Google Gemini API per l'elaborazione (tema, parametri, contesto dello spazio, ecc.). Non vengono archiviati su server terzi oltre Google Cloud. Se l'amministratore ha attivato la base certificata EIL (modalità Certificata o Mista), le domande di inquadramento sono inviate anche a EIL. L'analisi in corso resta salvata sul server dell'applicazione e viene cancellata da sola dopo un periodo di conservazione stabilito dall'amministratore; per la diagnostica l'amministratore può consultare i log tecnici dell'analisi, che contengono il testo del tema. Il costo mostrato in sidebar è una stima calcolata nel browser dai token; lo stesso calcolo, fatto dal server con lo stesso listino, è quello che scala la tua quota.
Ricerche web. Se la «Ricerca approfondita» è accesa e l'amministratore ha attivato i «fatti di riferimento», prima dell'introduzione l'applicazione fa alcune ricerche sul web tramite Google Search (con Gemini): le domande di ricerca nascono dal tema, dal perimetro e dall'ambito che hai indicato e quindi ne contengono parti. Le ricerche eseguite sono elencate nella scheda dell'introduzione. Non partono in modalità «Certificata» né con la «Ricerca approfondita» spenta. Il testo delle pagine trovate non viene conservato: restano i fatti estratti, gli indirizzi e i nomi dei siti. Se l'amministratore lo ha consentito, il server dell'applicazione apre anche le pagine delle fonti, solo per leggerne titolo, autore o ente e data (i siti visitati vedono l'indirizzo del server, non il tuo).
Posso fare più analisi contemporaneamente?
Le schede e le finestre dello stesso browser condividono la sessione, e quindi la stessa analisi: non sono indipendenti. Aprire la pagina in una seconda scheda mostra la scelta «Riprendi l'analisi» / «Nuova analisi»; scegliere «Nuova analisi» azzera quella in corso anche nella prima scheda. Per due analisi in parallelo usa browser o profili diversi (ognuno ha la propria sessione) oppure utenti diversi.
/stato
per verificare lo stato corrente della pipeline.