Documento riservato

Agent SDK Factory.

Da brief organizzativo ad agenti AI governati, verificabili e sovrani.

Leonardo Milan · PCC-ICF · Business Agility Coach · WikiCoaching AI Suite

Il punto di partenza

Il problema non è l'intelligenza.
È la disciplina.

L'AI generica promette «agenti». Spesso consegna un prompt mascherato: output non tracciabile, non riproducibile, senza prova di chi ha fatto cosa. Per chi tratta informazioni sensibili, non è accettabile.

La differenza che conta

LLM generico vs motore architetturale

LLM generico · «un prompt»

Veloce, ma opaco

  • Non riproducibile: stesso input → output diverso
  • Nessuna prova di esecuzione
  • Nessuna identità, nessun registro
  • Il rischio è invisibile finché non esce

Motore HALO · «una piattaforma»

Governato e tracciabile

  • Riproducibile e auditabile
  • Prova runtime per ogni output
  • Identità agente + capability registrata
  • Il rischio è gestito by design

Che cos'è

La Agent SDK Factory.

Il processo disciplinato che trasforma il brief di un'organizzazione in agenti AI governati, pronti per chi codifica. «Disciplina prima, agenti dopo»: non costruiamo un agente dove mancano dati, processo o governance pronti.

Il principio fondativo

Step 0-bis — AI-Ready Data Gate

Prima di qualsiasi agente, un cancello: la realtà è pronta per l'AI?

Dati

Fonti con titolarità chiara sul caso d'uso? Altrimenti → Data Readiness.

Processo

Mappato, o vive solo nella testa di una persona? Altrimenti → Process Readiness.

Governance

Sponsor con KPI scritti e responsabilità? Altrimenti → Governance Readiness.

Esito possibile: NO_BUILD — meglio un «no» onesto oggi che un agente che fallisce domani.

Il runtime

HALO — il motore neutro e governato

Gli agenti non girano «nel vuoto»: girano su un'infrastruttura con governance costituzionale.

Identità agente

ogni agente ha un nome e una responsabilità

Capability registrata

cosa può fare è dichiarato e provato

Evidence log

registro a sola aggiunta di ciò che è accaduto

Prova runtime

nessun «agent-led» senza evidenza reale

Routing governato

chi fa cosa è deciso e tracciato

Cost governor

tetto di spesa, sempre sotto controllo

Cosa consegniamo

I 5 artefatti — da ogni brief

1
Spec Agente
Carta d'identità su 1 pagina: scopo, input/output, 3 stop, verdetto Gate
Identità
2
Mappa Skill
Cosa si riusa dal catalogo · cosa serve di nuovo (gap onesto)
Riuso
3
Capability
Quali capability esistono già provate · quali mancano
Provato
4
Prompt Template
Lo scheletro conversazionale dell'agente
Scheletro
5
Fitness Test
Prove di validazione: input → output atteso (qualità misurata)
Qualità
Il processo

Sei fasi, una cucina universale

F0
Gate
Step 0-bis: si passa?
F1
Discovery
Use case · stakeholder · vincoli
F2
Disegno
Spec agente · orchestrazione
F3
Preparazione
Skill + capability (riuso/gap)
F4
Costruzione
Prompt + scaffold (no codice)
F5
Rilascio
Fitness test · handoff

+ F6 · Verifica longitudinale (a 6 e 12 mesi): l'agente regge nel tempo? È il test di antifragilità.

Perché per voi

Garanzie istituzionali

Provenienza provabile

Ogni output ha run_id, hash e registro: si dimostra chi ha fatto cosa.

Sovranità dei dati

Esecuzione controllata · il dato sensibile non lascia il perimetro.

Approvazione umana

Gate di approvazione su scrittura, registro, output cliente-facing.

Spesa governata

Cost Governor: tetto giornaliero, nessuna sorpresa.

Qualità by design

Tre ruoli separati, niente auto-promozione

1 · pianifica

Planner

Pianifica il lavoro: cosa fare, in che ordine.

2 · produce

Generator

Produce il risultato secondo il piano.

3 · valuta

Evaluator

Valuta in modo indipendente: la qualità non se la dà chi l'ha prodotta.

È la differenza tra «l'AI dice che è andata bene» e «è andata bene, ed è verificato».

Cosa vi proponiamo

Il percorso d'ingaggio

1
Kickoff
Inquadriamo bisogno e perimetro
2
Step 0-bis
3 interviste: Responsabile · IT · Sponsor
3
Primo agente
I 5 artefatti del vostro caso d'uso
4
Rilascio
Costruzione governata + fitness test

Modello: architetto-consulente al vostro fianco — voi restate proprietari del processo e del dato.

La credibilità

HALO non è una promessa: è un motore.

Esiste già ed è provato a runtime — governance, evidence log, validazione. Non un PowerPoint, ma un'infrastruttura operativa: gli agenti girano, lasciano traccia, si possono auditare. Voi non comprate un esperimento: comprate un metodo e un motore già in piedi.

Il prossimo passo

Una sessione Step 0-bis per qualificare il vostro primo caso d'uso.

Nessun impegno operativo: capiamo se ci sono le condizioni, e cosa servirebbe. Disciplina prima, agenti dopo.

Leonardo Milan · PCC-ICF · WikiCoaching AI Suite · agentica.wikicoaching.it