Guida alla revisione
Come applicare i principi Blueprint a una funzione reale o al design di un agente prima del lancio.
La revisione in tre domande
Prima di lanciare qualsiasi funzione agentica, chiedi: (1) Ogni azione distruttiva o visibile esternamente è bloccata dall'approvazione esplicita dell'utente? (2) Un utente può vedere cosa sta facendo l'agente senza leggere i log? (3) Se l'agente produce un output sbagliato, c'è un percorso per annullare, ritentare o riparare?
Checklist del cluster
Delegazione: hai definito cosa l'agente può decidere autonomamente? Visibilità: ogni azione asincrona mostra progresso visibile? Fiducia: le azioni rischiose sono bloccate? Orchestrazione: la pipeline degrada con grazia quando un sotto-agente fallisce?
Usare lo strumento di audit MCP
validate_agent_architecture (Pro/Teams) accetta la descrizione della tua implementazione e restituisce una revisione strutturata allineata ai quattro cluster. Imposta private_session=true per saltare la registrazione lato server.
Lista di revisione — tutti i principi
Per ogni principio: il tuo feature lo rispetta? Segna quelli che richiedono attenzione.
Progettare per la delega piuttosto che per la manipolazione diretta
Progettare esperienze attorno all'assegnazione del lavoro, l'espressione dell'intento, l'impostazione dei vincoli e la revisione dei risultati, piuttosto che richiedere agli utenti di eseguire manualmente ogni passaggio.
Domanda di revisione: Il prodotto rimane strutturalmente manuale, con l'IA che funziona solo come sovrapposizione piuttosto che come capacità operativa.
Assicurarsi che il lavoro in background rimanga percepibile
Quando il sistema opera in modo asincrono o al di fuori del focus immediato dell'utente, dovrebbe fornire segnali persistenti e proporzionati che il lavoro sta continuando.
Domanda di revisione: L'utente non può determinare se il compito è attivo, ritardato, bloccato o fallito.
Allineare il feedback al livello di attenzione dell'utente
Il sistema dovrebbe calibrare la profondità e la frequenza del feedback in base al fatto che l'utente sia attivamente impegnato, monitorando passivamente o temporaneamente assente.
Domanda di revisione: Il sistema diventa eccessivamente opaco o inutilmente oneroso.
Applicare la divulgazione progressiva all'agenzia del sistema
Fornire per impostazione predefinita le informazioni minime necessarie, consentendo agli utenti di ispezionare ulteriori dettagli quando è richiesta fiducia, comprensione o intervento.
Domanda di revisione: Il sistema viene percepito come una scatola nera opaca o come un registro tecnico eccessivamente esposto.
Sostituire la magia implicita con modelli mentali chiari
Il prodotto dovrebbe aiutare gli utenti a comprendere cosa il sistema può fare, cosa sta facendo attualmente, cosa non può fare e quali condizioni governano il suo comportamento.
Domanda di revisione: Gli utenti attribuiscono un livello di agenzia, affidabilità o competenza che il sistema non possiede effettivamente.
Esporre uno stato operativo significativo, non la complessità interna
Presentare lo stato del sistema in linguaggio e strutture rilevanti per l'utente, piuttosto che esporre dettagli interni di basso livello che non supportano l'azione o la comprensione.
Domanda di revisione: Il sistema oscura lo stato importante o sovraccarica l'utente con meccaniche irrilevanti.
Stabilire fiducia attraverso l'ispezionabilità
Gli utenti dovrebbero essere in grado di esaminare come è stato prodotto un risultato quando la fiducia, la responsabilità o la qualità della decisione sono importanti.
Domanda di revisione: Il sistema richiede fiducia senza fornire una base per essa.
Rendere espliciti i passaggi, le approvazioni e i blocchi
Quando il sistema non può procedere, la ragione dovrebbe essere immediatamente visibile, insieme a qualsiasi azione richiesta dall'utente o da un'altra dipendenza.
Domanda di revisione: I compiti si fermano silenziosamente, creando confusione e erodendo la fiducia.
Rappresentare il lavoro delegato come un sistema, non solo come una conversazione
Dove il lavoro coinvolge più passaggi, agenti, dipendenze o attività concorrenti, dovrebbe essere rappresentato come un sistema strutturato piuttosto che solo come un flusso di messaggi.
Domanda di revisione: Il lavoro complesso è ridotto a una narrativa non strutturata e diventa difficile da governare.
Ottimizzare per la guida, non solo per l'inizio
Il sistema dovrebbe supportare gli utenti non solo nell'avvio dei compiti, ma anche nella guida, nel perfezionamento, nella riprioritizzazione e nella correzione del lavoro mentre è in corso.
Domanda di revisione: L'unico controllo disponibile diventa la ripetizione o il riavvio, che è inefficiente e spesso operativamente non sicuro.
Also in this section