Eval e acceptance per contractor AI nel B2B
Le demo AI impressionano; l'acceptance in produzione no. Se la definition of done del contractor è 'il chatbot risponde alle domande', erediterai allucinazioni, gap di ACL e nessun modo di regredire la qualità quando cambiano i prompt. Questa guida è per founder, product owner e lead eng che comprano lavoro AI custom. Copre golden set, soglie di eval, gap demo vs produzione, test ACL, runbook e linguaggio contrattuale. Si abbina a assunzione di software contractor, fit di prodotto AI, sicurezza AI e modelli di contratto.
Mindset di acceptance: quality bar, non vibes
Tratta le feature LLM come qualsiasi altro subsystem ad alto rischio: soglie misurabili, test automatici, security case e handover operativo. 'Sta bene in demo' non è un gate. Separa gli spike di research dai milestone di produzione. Gli spike possono esplorare; i milestone devono soddisfare criteri di eval, ACL, audit e runbook. Allinea la delivery a strategia di testing e production readiness.
- Scrivi l'acceptance prima che inizi il build
- Includi failure e abuse case, non solo happy path
- Richiedi run di eval riproducibili su un golden set fisso
- Gate del go-live sulle soglie, non sulle slide
Golden set che riflettono utenti reali
Costruisci un set versionato di input con outcome attesi: risposte più citazioni richieste per RAG, field extraction, classificazioni o traiettorie agent end-to-end. Copri persona e tenant che servi davvero. Includi vuoti, conflitti, injection avversarie e richieste out-of-scope. Gli esperti di dominio devono revisionare le label; gli engineer da soli perderanno sfumature di policy. Per lavoro RAG-heavy, segui le pratiche di evaluation in RAG in produzione. Per gli agent, scripta outage tool e reject di approvazione come in workflow agentic.
Soglie di eval e gate di release
Punteggia separatamente retrieval hit rate, correttezza delle citazioni, faithfulness, task success e tasso di azioni non sicure. Imposta minimi per environment: lo staging deve passare prima del traffico di produzione. Regredisci a ogni bump di prompt, modello, chunker, reranker o versione di grafo. Blocca i merge quando le soglie calano, come per integration test flaky. Pubblica chi può waiverare un gate e per quanto. I waiver permanenti sono il modo in cui le demo diventano debito di produzione.
- Definisci metriche e owner nello SOW
- Conserva i report di eval come artefatti di release
- Richiedi shadow o cohort limitata prima del cutover pieno
- Traccia costo per successo insieme ai quality gate
Demo vs produzione: chiudi i gap
Le demo spesso usano documenti curati, dati single-tenant, tool god-mode e nessun budget di latenza. La produzione serve ACL, audit, write idempotenti, osservabilità e runbook di support. Elenca esplicitamente gli shortcut di demo nel project plan e la data di paydown. Se uno shortcut resta al go-live, è rischio accettato con un owner, oppure non è done. Scope della prima vertical con prioritizzazione MVP e discovery via technical discovery.
Test ACL e security che i contractor devono passare
Tentativi automatici di retrieval e tool cross-tenant. Logging dei denial. Casi di prompt injection via documenti e ticket. Reject di schema su argomenti tool fuori range. Nessun service role condiviso che bypassa i permessi di prodotto. Principal legati a SSO per agent user-facing. Vedi sicurezza AI enterprise e SSO e identity. Tratta un test ACL fallito come ship blocker equivalente a un bug di data breach in una API normale.
Osservabilità, audit e runbook
L'handover include trace (run ID, ID di retrieval, tool, approvazioni), dashboard, alert e runbook: reindex, rollback di versione prompt/grafo, kill switch, outage vendor e risposta a spike di costo. Allinea i log a audit logging e le ops a osservabilità e SLA di support. Se solo il contractor sa interpretare i failure, non possiedi la feature.
- Documenta gli step on-call per incident AI
- Includi ownership di dati/corpus e cadenza di refresh
- Consegna l'eval harness e come estendere il golden set
- Registra setting del vendor modello e gestione dei secret
Linguaggio contrattuale che protegge entrambe le parti
Definisci i deliverable come sistemi che rispettano soglie, non ore di prompt tinkering. Indica environment, accesso ai dati, IP di prompt/grafi/eval set e confidenzialità dei corpora cliente. Il fixed price sta bene per MVP ben delimitati con gate chiari; il T&M sta bene per esplorazione con demo settimanali contro il golden set. Vedi fixed price vs time and materials. Includi change control quando qualità del corpus o API sono peggiori di quanto assunto in discovery (spesso il vero rischio di schedule). Bilancia con range di costo realistici e unit economics in mente.
Acceptance di human-in-the-loop e write path
Se la feature può scrivere sui system of record, l'acceptance include UX di approvazione, evidenze sulla card, comportamento di timeout, idempotenza e compensation su failure parziali. Draft-only può essere un milestone; le write non supervisionate richiedono bar più alti. Le aspettative di prodotto vivono in prodotti AI human-in-the-loop. Path ERP e denaro ereditano anche la disciplina di integrazione ERP: nessun agent ha un free pass sull'idempotenza.
Prossimi passi
Bozza di una checklist di acceptance di una pagina: size del golden set, metriche, test ACL, campi di audit, runbook e kill switch. Allega allo SOW prima del kickoff. Continua con data readiness, altre risorse, case study, contattami o contatti per rivedere le proposte dei contractor prima di finanziare un engagement solo-demo.
Review operativa prima del prossimo impegno
Prima di aumentare budget su ai contractor eval acceptance, allinea operatori, finance e customer success su cosa deve cambiare nel primo trimestre dopo il go-live. Senza quella lista condivisa, engineering consegna funzioni che supporto non sa spiegare e sales promette comportamenti non ancora su staging. Trasforma ogni milestone in demo osservabile: permessi reali, dati mascherati tipo produzione, integrazioni verso sandbox ERP o CRM. Le slide non catturano edge case nei flussi admin dove ruoli e approvazioni si incrociano. Registra decisioni e non-goal in un unico log accessibile a procurement e product. Quando arriva una change request, collegala al log così si vede se stai riaprendo un trade-off già chiuso o aggiungendo valore misurabile.
Valuta carico interno oltre alle ore contractor: review codice, UAT, security questionnaire e formazione operatori. Un preventivo basso con stakeholder part-time spesso costa più calendario di un senior con scope più stretto. Pianifica handover e runbook prima del lancio pilota. Se solo il fornitore sa fare rollback o interpretare alert, non hai consegnato capability ma dipendenza. Confronta metriche operative dopo quattro settimane: ticket supporto, tempo medio approvazione, errori riconciliazione. Se non migliorano, la priorità roadmap va rinegoziata prima di aggiungere moduli.
Per una lettura di fattibilità su priorità e rischi, contattami, esplora altre risorse o guarda contesti di delivery simili quando valuti integrazioni e compliance.
Allineamento stakeholder e procurement
Procurement valuta ai contractor eval acceptance con template pensati per commodity IT. Traduci milestone in outcome misurabili: tempo ciclo, errori evitati, audit superati. Altrimenti confronti preventivi incomparabili e vince chi promette date, non chi documenta rischi. Nomina un unico decision maker lato business con autorità su scope e priorità. Committee diffusi rallentano risposte e fanno sembrare lento il team engineering anche quando il codice procede. Condividi demo staging con finance prima dell'UAT esterno. Numeri e permessi sbagliati scoperti tardi costano più delle settimane extra in discovery.
Include customer success nelle review bisettimanali durante implementazioni lunghe. Imparano limiti reali del prodotto e smettono di promettere automazioni non ancora mergeate. Quando integrazioni terze slittano, comunica impatto su date con alternative: scope ridotto, fase due, workaround manuale temporaneo. Silenzio genera sfiducia più di una data spostata con motivo chiaro.
Checklist di validazione pre-go-live
Prima del go-live su ai contractor eval acceptance, verifica backup e restore testati, runbook incidenti, ownership on-call e path rollback documentato. B2B non perdona downtime silenzioso su batch notturni. Esegui test permessi con ruoli reali, non solo admin. ABAC e row-level rules rompono in edge case che unit test non coprono. Allinea metriche prodotto a definizioni finance: cosa conta come transazione completata, utente attivo, ordine chiuso.
- Restore da backup verificato negli ultimi 30 giorni
- Demo staging registrata per training operatori
- Change log con decisioni approvate dal business owner
- Integrazioni critiche con contract test verdi
Domande frequenti
Quanto grande deve essere il golden set per un MVP?
Abbastanza da coprire le persona core, casi vuoti/conflitto e alcuni input avversari: spesso dozzine di casi ben etichettati valgono più di centinaia di casi rumorosi. Fai crescere il set quando espandi lo scope.
Possiamo accettare solo su una demo live?
No. Richiedi report di eval riproducibili, test ACL e handover operativo. Le demo sono strumenti di comunicazione, non prova di production readiness.
Chi possiede l'IP dell'eval set?
Preferisci ownership del cliente su casi di business etichettati e outcome; licenzia o assegna codice di prompt/grafo come altro custom software. Scrivilo nel contratto.
E se il contractor vuole dati di produzione presto?
Usa tenant scrubbed o sintetici finché ACL e logging non sono provati. L'accesso in produzione deve seguire la stessa diligence di qualsiasi contractor di integrazione, con audit di ciò che è stato retrieved.