Una traccia utilizzabile
Fase, versione, esito e categoria di errore vengono registrati. Decidete quali dati sono necessari per la diagnosi e come vengono protetti e conservati.
ENGINEERING / DESIGN NOTE 001
IA utile. Controllo esplicito.
Regole per tutto ciò che si può specificare. IA per il lavoro linguistico che beneficia dell’interpretazione. E un confine visibile tra preparazione e azione.
01 / ARCHITETTURA DI RIFERIMENTO
Un workflow prima di un agente autonomo.
- 01Validare l’input
- 02Recuperare il contesto approvato
- 03Interpretare o preparare
- 04Controllare l’output
- 05Chiedere alla persona autorizzata
- 06Agire e registrare
INPUT → PREPARAZIONE → AUTORITÀ → AZIONE
- 01 / REGOLE
Validare l’input
Controllare i campi obbligatori, i tipi consentiti e i permessi delle fonti. Rifiutare o trattenere il lavoro incompleto.
- 02 / SOURCES
Recuperare il contesto approvato
Usare un insieme di fonti delimitato. Tenere versioni dei documenti e riferimenti allegati al risultato.
- 03 / AI-ASSISTED
Interpretare o preparare
Estrarre, classificare, riassumere o redigere dove il lavoro linguistico aggiunge valore. Non inventare i fatti mancanti.
- 04 / REGOLE
Controllare l’output
Validare lo schema e i vincoli aziendali. Calcolare i numeri con logica deterministica.
- 05 / UMANO
Chiedere alla persona autorizzata
Mostrare che cosa è cambiato, le evidenze a supporto e l’azione che l’approvazione consentirà.
- 06 / CONTROLLED ACTION
Agire e registrare
Eseguire solo l’azione approvata. Registrare il risultato e gestire l’errore senza effetti duplicati.
Architettura di riferimento per un’implementazione delimitata. Ogni fase ha un percorso di errore; un prerequisito mancante trattiene l’elemento per il suo responsabile invece di proseguire per ipotesi.
02 / INTERFACCE STRUTTURATE
Una risposta utile ha un contratto.
Interfaccia illustrativa, non un’API in produzione. I riferimenti alle fonti, l’output proposto e il permesso di agire viaggiano separatamente. Una risposta del modello non può concedersi da sola un’approvazione.
Preparare non è autorizzare
Una bozza collegata alle fonti può comunque essere sbagliata. Validazione, revisione e autorità di agire restano passaggi separati.
{
"request_id": "SYN-EXAMPLE-01",
"source_refs": [
"approved-source:v3:section-2"
],
"proposed_action": "prepare_draft",
"result_status": "needs_review",
"approval": {
"required": true,
"granted": false
},
"external_action_allowed": false
}03 / CASI DI ACCETTAZIONE
Testare più del caso ideale.
- Input atteso
L'output concordato è prodotto e può essere rintracciato ai suoi input.
- Risultato ambiguo
Trattenere per la revisione; l’incertezza non diventa silenziosamente un’approvazione.
- Informazioni mancanti
Richiedere la fonte o il campo mancante e conservare lo stato incompleto.
- Input errato
Rifiutare tipi, valori o formati non validi prima di un’azione a valle.
- Integrazione non disponibile
Registrare l’errore e usare un percorso concordato di nuovo tentativo o escalation.
- Richiesta non sicura
Rifiutare le azioni al di fuori del workflow e dell’ambito dei dati consentiti.
- Evento duplicato
Impedire che un nuovo tentativo ripeta un’azione esterna con conseguenze.
- Modifica di fonte o istruzione
Rieseguire i casi di accettazione pertinenti prima di rilasciare la nuova versione.
Casi di riferimento per un piano di accettazione del cliente. I test esatti e le prove sono concordati per ogni implementazione.
04 / PROGETTAZIONE OPERATIVA
Qualcuno dovrà gestirlo domani.
Un responsabile designato
Qualcuno deve farsi carico di eccezioni, modifiche degli accessi e della decisione di riprendere. Una coda senza una persona responsabile non è un piano di ripristino.
Un cambiamento controllato
I casi interessati vengono ritestati quando cambiano modello, istruzione, fonte o integrazione. Una versione precedente funzionante e una procedura di ripristino esplicita restano disponibili.
05 / EVIDENZE VERIFICABILI
Provate voi stessi i confini.
Il Workflow Studio mostra arresti di approvazione locali, reset, eccezioni, dati strutturati e tracce di eventi. Integrazioni con i clienti, nuovi tentativi e monitoraggio operativo richiedono proprie evidenze di implementazione e accettazione.