Files
ThothII/CONTEXT.md
T

62 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.