Files
ThothII/CONTEXT.md
T

2.9 KiB
Raw Blame History

Contesto di dominio di ThothII

Workflow

Workflow core — La parte condivisa del workflow NL→SQL che governa la sequenza delle fasi, il ciclo di vita delle sessioni, la revisione umana e la persistenza. Non è un processo distinto né un sistema estensibile di plugin.

Internal workflow module — Un insieme coeso di comportamento e conoscenza di dominio sviluppato e rilasciato insieme a ThothII. È isolato per rendere locali le modifiche, non per essere caricato dinamicamente o sostituito da implementazioni esterne.

Pi — Il runtime agentico concreto usato da ThothII per le elaborazioni che richiedono un modello. Segue le istruzioni del workflow e usa gli strumenti messi a disposizione dai moduli interni.

Admission — Il controllo che stabilisce se una domanda può entrare nel workflow NL→SQL oppure deve essere riformulata o rifiutata.

Disambiguation — La responsabilità di rendere esplicita e sottoporre a revisione l’interpretazione di una domanda ambigua prima della generazione SQL.

Evidence — La conoscenza di dominio curata e citabile usata per fondare l’interpretazione della domanda e le scelte effettuate durante il workflow.

Memory — La conoscenza riutilizzabile derivata da decisioni o sessioni precedenti e resa disponibile alle elaborazioni successive.

Datamart — L’attività finale già esistente che gestisce l’eventuale produzione del datamart dopo la generazione del SQL.

Paused session — Una sessione interrotta intenzionalmente ma resumibile. L’azione “Stop and save” mette la sessione in pausa; non la completa e non la marca come fallita.

Finalized session — Una sessione completata che non accetta ulteriori modifiche al proprio risultato.

Workspace scope — La dichiarazione di ciò che il database di un workspace rappresenta e delle domande alle quali è destinato a rispondere.

Catalogo dei metadati

Workspace Database — Il database associato a un workspace, considerato nella sua interezza fisica: tutte le tabelle, le colonne e le relazioni disponibili, anche quando solo un loro sottoinsieme è destinato al core di ThothII.

Metadata Catalog — Il contesto amministrativo che raccoglie e cura i metadati di un Workspace Database. Non definisce quali elementi partecipano al workflow SQL.

Database Profile — L'insieme curato di scope, descrizioni e metadati semantici associato a un Workspace Database.

Generated comment — Il testo descrittivo prodotto dall'AI per una tabella o una colonna. Rimane distinto dalla descrizione finché l'utente non ne richiede la copia.

Core Schema Selection — Il sottoinsieme di tabelle, colonne e relazioni di un Workspace Database reso disponibile al processo core di ThothII. È distinto dal Workspace scope, che descrive il dominio e le domande ammesse.

Publication — Una versione approvata e immutabile dei contenuti del Metadata Catalog resa disponibile ai suoi consumatori.