Il tuo team ha passato anni a redigere SOP: come elaborare una fattura, inserire un fornitore, reimpostare l'accesso di un utente, gestire un rimborso. Ora gli agenti IA stanno arrivando in ogni team operativo e anche loro hanno bisogno di istruzioni. La buona notizia è che non devi ripartire da zero. Una SOP ben scritta contiene già la maggior parte di ciò di cui un agente ha bisogno per svolgere un'attività in modo affidabile: lo scopo, i passaggi, le regole e, aspetto fondamentale, le eccezioni.

Questa guida per passare dalle SOP alle skill per agenti IA illustra come trasformare le SOP in skill utilizzando il formato SKILL.md. Scoprirai cos'è una skill per agenti, come ogni sezione di una SOP si mappa a una skill, come convertire la sezione delle eccezioni in guardrail, un esempio pratico, un metodo dettagliato passaggio dopo passaggio e la governance necessaria prima di consentire a un agente di eseguire un processo aziendale.

Cos'è una skill per agenti IA?

Una skill per agenti IA è un pacchetto di istruzioni che un agente IA può caricare quando un'attività lo richiede. Nel formato aperto Agent Skills, una skill è una cartella che contiene un file SKILL.md, oltre a script opzionali, documenti di riferimento e altre risorse. Il file SKILL.md inizia con un frontmatter YAML, in cui sono richiesti solo due campi: name e description. Il resto del file è composto da semplici istruzioni in formato markdown.

Le skill utilizzano la divulgazione progressiva (progressive disclosure). L'agente vede inizialmente solo il nome e la descrizione di ciascuna skill, carica il file SKILL.md completo quando un'attività vi corrisponde e apre gli eventuali file di riferimento solo quando ne ha effettivamente bisogno. Ciò mantiene efficienti le librerie di skill di grandi dimensioni. Il formato è stato originariamente sviluppato da Anthropic e rilasciato come standard aperto nel dicembre 2025, ed è ora supportato da numerose piattaforme per agenti.

Perché le SOP sono ottime skill per agenti IA?

Le SOP e le skill per agenti hanno molto in comune. Entrambe descrivono come eseguire un'attività specifica, passo dopo passo, secondo regole definite. Una buona SOP fornisce già:

• Uno scopo e un ambito chiari, che diventano la descrizione della skill e il suo trigger di attivazione.

• Passaggi numerati, che diventano le istruzioni dell'agente.

• Prerequisiti, che indicano all'agente di cosa ha bisogno prima di iniziare.

• Eccezioni, che diventano guardrail: cosa fare, o non fare, quando qualcosa va storto.

• Controlli e approvazioni, che diventano punti di controllo in cui un essere umano deve prendere una decisione.

• Un proprietario e una versione, che mantengono la skill regolamentata come qualsiasi altra procedura.

Trasformare le SOP in skill per agenti IA consente di riutilizzare il lavoro che la tua organizzazione ha già approvato, invece di dover scrivere prompt nuovi e non testati. Se le tue SOP sono lunghe, suddividile prima in parti a misura di singola attività; consulta come suddividere le SOP in articoli di knowledge base.

Da SOP a skill per agenti IA: come si mappa ogni sezione della SOP in SKILL.md?

Come trasformare le eccezioni delle SOP in guardrail per gli agenti?

La sezione delle eccezioni è la parte più preziosa di una SOP per un agente. È il punto in cui le persone più esperte hanno annotato cosa può andare storto e come intervenire. Per un agente, queste eccezioni diventano guardrail, e ciascuna di esse dovrebbe essere trasformata in una regola secondo una di queste tre modalità:

• Gestisci: "Se il totale della fattura differisce dall'ordine di acquisto per un importo inferiore alla tolleranza, prosegui e annota la discrepanza."

• Fermati ed escala: "Se le coordinate bancarie del fornitore differiscono dall'anagrafica fornitori, fermati. Non procedere con il pagamento. Invia il caso al responsabile della contabilità fornitori."

• Non farlo mai: "Non creare o modificare mai le coordinate bancarie dei fornitori."

I guardrail efficaci sono specifici, verificabili e prudenti. Dove la SOP raccomanda di "usare il buon senso", la skill dovrebbe di solito specificare "fermati e chiedi a un essere umano", almeno finché l'agente non è stato testato su casi reali. Aggiungi anche i guardrail che la SOP dà per scontati: quali sistemi l'agente può utilizzare, quali dati non deve esporre e quali azioni non possono essere annullate.

Esempio: trasformare una SOP di fatturazione in una skill

Ecco un esempio semplificato basato su una SOP per le fatture di contabilità fornitori. La SOP riguarda la verifica e corrispondenza (matching) tra fatture passive e ordini di acquisto, con eccezioni per variazioni di prezzo, documenti di trasporto/ricevute mancanti e modifiche alle coordinate bancarie.

---
name: match-vendor-invoice
description: Verifica la corrispondenza di una fattura fornitore con il relativo ordine di acquisto e l'entrata merci nell'ERP, segnalando eventuali eccezioni. Da utilizzare quando una fattura di contabilità fornitori richiede un riscontro a tre vie (three-way matching) prima del pagamento.
---
# Verifica di una fattura fornitore
SOP di origine: AP-014, versione 2.1. Proprietario: AP process owner.
## Prima di iniziare
- Sono necessari il PDF della fattura, il numero dell'ordine di acquisto e l'accesso in sola lettura all'ERP.
- Consulta references/tolerances.md per verificare le tolleranze attuali su prezzi e quantità.
## Passaggi
1. Estrai dalla fattura fornitore, numero fattura, data, importo e numero dell'ordine di acquisto.
2. Verifica che il numero di fattura non sia già stato registrato per questo fornitore.
3. Recupera l'ordine di acquisto e l'entrata merci dall'ERP.
4. Confronta quantità e prezzi riga per riga rispetto alle tolleranze.
5. Se tutto rientra nelle tolleranze, contrassegna la fattura come "pronta per la registrazione" e annota la corrispondenza.
## Guardrail
- Se la fattura è un duplicato, fermati e segnalala. Non registrarla.
- Se manca l'entrata merci, sospendi la fattura e invia una notifica all'ufficio acquisti.
- Se uno scostamento supera la tolleranza, sospendi la fattura e inviala all'addetto alla contabilità fornitori con i dettagli dello scostamento.
- Se le coordinate bancarie del fornitore in fattura differiscono dall'anagrafica fornitori, fermati ed escala la richiesta al responsabile della contabilità fornitori.
- Non modificare mai i dati dell'anagrafica fornitori. Non autorizzare mai i pagamenti.
## Punti di controllo umani
- Un addetto alla contabilità fornitori approva ogni fattura sospesa prima che venga registrata

---
name: match-vendor-invoice
description: Verifica la corrispondenza di una fattura fornitore con il relativo ordine di acquisto e l'entrata merci nell'ERP, segnalando eventuali eccezioni. Da utilizzare quando una fattura di contabilità fornitori richiede un riscontro a tre vie (three-way matching) prima del pagamento.
---
# Verifica di una fattura fornitore
SOP di origine: AP-014, versione 2.1. Proprietario: AP process owner.
## Prima di iniziare
- Sono necessari il PDF della fattura, il numero dell'ordine di acquisto e l'accesso in sola lettura all'ERP.
- Consulta references/tolerances.md per verificare le tolleranze attuali su prezzi e quantità.
## Passaggi
1. Estrai dalla fattura fornitore, numero fattura, data, importo e numero dell'ordine di acquisto.
2. Verifica che il numero di fattura non sia già stato registrato per questo fornitore.
3. Recupera l'ordine di acquisto e l'entrata merci dall'ERP.
4. Confronta quantità e prezzi riga per riga rispetto alle tolleranze.
5. Se tutto rientra nelle tolleranze, contrassegna la fattura come "pronta per la registrazione" e annota la corrispondenza.
## Guardrail
- Se la fattura è un duplicato, fermati e segnalala. Non registrarla.
- Se manca l'entrata merci, sospendi la fattura e invia una notifica all'ufficio acquisti.
- Se uno scostamento supera la tolleranza, sospendi la fattura e inviala all'addetto alla contabilità fornitori con i dettagli dello scostamento.
- Se le coordinate bancarie del fornitore in fattura differiscono dall'anagrafica fornitori, fermati ed escala la richiesta al responsabile della contabilità fornitori.
- Non modificare mai i dati dell'anagrafica fornitori. Non autorizzare mai i pagamenti.
## Punti di controllo umani
- Un addetto alla contabilità fornitori approva ogni fattura sospesa prima che venga registrata

---
name: match-vendor-invoice
description: Verifica la corrispondenza di una fattura fornitore con il relativo ordine di acquisto e l'entrata merci nell'ERP, segnalando eventuali eccezioni. Da utilizzare quando una fattura di contabilità fornitori richiede un riscontro a tre vie (three-way matching) prima del pagamento.
---
# Verifica di una fattura fornitore
SOP di origine: AP-014, versione 2.1. Proprietario: AP process owner.
## Prima di iniziare
- Sono necessari il PDF della fattura, il numero dell'ordine di acquisto e l'accesso in sola lettura all'ERP.
- Consulta references/tolerances.md per verificare le tolleranze attuali su prezzi e quantità.
## Passaggi
1. Estrai dalla fattura fornitore, numero fattura, data, importo e numero dell'ordine di acquisto.
2. Verifica che il numero di fattura non sia già stato registrato per questo fornitore.
3. Recupera l'ordine di acquisto e l'entrata merci dall'ERP.
4. Confronta quantità e prezzi riga per riga rispetto alle tolleranze.
5. Se tutto rientra nelle tolleranze, contrassegna la fattura come "pronta per la registrazione" e annota la corrispondenza.
## Guardrail
- Se la fattura è un duplicato, fermati e segnalala. Non registrarla.
- Se manca l'entrata merci, sospendi la fattura e invia una notifica all'ufficio acquisti.
- Se uno scostamento supera la tolleranza, sospendi la fattura e inviala all'addetto alla contabilità fornitori con i dettagli dello scostamento.
- Se le coordinate bancarie del fornitore in fattura differiscono dall'anagrafica fornitori, fermati ed escala la richiesta al responsabile della contabilità fornitori.
- Non modificare mai i dati dell'anagrafica fornitori. Non autorizzare mai i pagamenti.
## Punti di controllo umani
- Un addetto alla contabilità fornitori approva ogni fattura sospesa prima che venga registrata

L'esempio è puramente illustrativo; adatta i passaggi, le tolleranze e i punti di controllo alla tua SOP e ai tuoi sistemi. Per consultare la SOP completa su cui si basa questo esempio, vedi la guida alla SOP per l'elaborazione delle fatture passive.

Come trasformare le SOP in skill per agenti IA, passo dopo passo?

Passaggio 1: scegli la SOP giusta

Inizia con una SOP approvata, aggiornata e basata su regole per un'attività con input e output ben definiti, un numero gestibile di eccezioni e un basso costo legato a eventuali errori. Le attività ad alto volume e ben codificate sono ottime candidate iniziali; consulta come identificare le opportunità di automazione nei processi documentati.

Passaggio 2: conferma che la SOP sia aggiornata

Un agente eseguirà passaggi obsoleti senza alcuna esitazione. Controlla la versione della SOP, il proprietario e la data di revisione prima di convertirla, e correggi qualsiasi elemento che non corrisponda più al sistema effettivo; vedi controllo delle versioni delle SOP.

Passaggio 3: scrivi il nome e la descrizione

Assegna alla skill un nome chiaro e una descrizione che specifichi cosa fa e quando utilizzarla. La descrizione è la prima cosa che l'agente vede, ed è ciò che gli consente di stabilire se impiegare la skill al momento opportuno.

Passaggio 4: riscrivi i passaggi sotto forma di istruzioni

Trasforma ciascun passaggio della SOP in un'istruzione diretta che l'agente possa eseguire e che tu possa testare. Elimina i dettagli schermata per schermata non necessari all'agente e mantieni invece le decisioni e le regole che gli servono. Le SOP redatte con un modello di SOP coerente sono molto più facili da convertire, perché ogni procedura presenta le stesse sezioni nello stesso ordine.

Passaggio 5: converti le eccezioni in guardrail

Esamina la sezione delle eccezioni riga per riga, trasformando ciascuna in una regola di tipo "gestisci", "fermati ed escala" o "non farlo mai".

Passaggio 6: aggiungi punti di controllo umani

Indica ogni approvazione, azione irreversibile e valutazione discrezionale come un momento in cui l'agente deve passare il testimone a una persona.

Passaggio 7: sposta all'esterno il materiale di riferimento lungo

Mantieni snello il file SKILL.md. Inserisci policy, elenchi di codici e tabelle delle tolleranze in file di riferimento separati che l'agente aprirà solo se necessario.

Passaggio 8: testa con casi reali

Esegui la skill su esempi realistici, includendo ogni eccezione prevista dalla SOP, e confronta i risultati dell'agente con ciò che farebbe una persona esperta.

Passaggio 9: assegna una versione, un proprietario e mantieni la sincronizzazione

Collega ciascuna skill alla relativa SOP di origine e alla sua versione, assegna un proprietario e aggiorna la skill ogni volta che la SOP subisce modifiche.

Qual è il ruolo di Trupeer?

La trasformazione delle SOP in skill per agenti IA funziona al meglio quando la SOP stessa è accurata, aggiornata e completa, eccezioni comprese. Trupeer ti supporta in entrambe le fasi:

• Cattura la procedura reale: registra una persona esperta mentre svolge l'attività con lo screen recorder IA di Trupeer, commentando regole ed eccezioni, e Trupeer trasformerà la registrazione in una SOP dettagliata punto per punto.

• Genera documenti nella struttura richiesta: la funzionalità Skills di Trupeer raggruppa istruzioni personalizzate, regole di formattazione e struttura dei documenti in una risorsa riutilizzabile da applicare a una registrazione. Puoi configurarne una per produrre un output conforme alla struttura di SKILL.md ed esportarlo poi in Markdown.

• Mantieni tutto aggiornato: quando il processo cambia, aggiorna la registrazione o la SOP e rigenera l'output, in modo che la skill per l'agente e la SOP per gli utenti umani rimangano sempre perfettamente sincronizzate.

Di quale governance hanno bisogno le skill per gli agenti?

Prima che un agente esegua un processo aziendale a partire da una skill, definisci una governance di base:

• Utilizza esclusivamente SOP approvate, con un proprietario designato per ogni skill.

• Assegna agli agenti il livello minimo di autorizzazioni necessario, preferendo l'accesso in sola lettura ovunque possibile.

• Richiedi l'approvazione umana per pagamenti, modifiche ai dati e qualsiasi azione irreversibile.

• Registra le attività dell'agente tramite log, affinché le azioni possano essere revisionate e sottoposte ad audit.

• Installa solo skill affidabili, e revisiona attentamente gli script associati.

• Rivedi le skill quando le SOP cambiano, e dismetti le skill relative a procedure ritirate.

Per scoprire come gli agenti possono accedere al tuo patrimonio di conoscenze più in generale, leggi come integrare la tua knowledge base video con gli agenti IA tramite MCP.

Errori comuni nella trasformazione delle SOP in skill per agenti

• Convertire SOP obsolete, con il risultato che l'agente seguirà passaggi non più validi.

• Tralasciare le eccezioni, lasciando all'agente solo il percorso lineare ideale (happy path).

• Descrizioni vaghe, che portano a utilizzare la skill al momento sbagliato o a non usarla affatto.

• Inserire tutto in un unico file, anziché mantenere SKILL.md snello spostando i materiali di riferimento all'esterno.

• Saltare i punti di controllo umani per approvazioni e azioni irreversibili.

• Assenza di un proprietario, con conseguente disallineamento progressivo tra skill e SOP.

Checklist: da SOP a skill per agenti IA

• La SOP è approvata, aggiornata e ha un proprietario assegnato.

• La skill ha un nome chiaro e una descrizione che indica cosa fa e quando usarla.

• I passaggi sono riscritti come istruzioni dirette e verificabili.

• Ogni eccezione è un guardrail: gestire, fermarsi ed escalare, oppure non fare mai.

• Approvazioni e azioni irreversibili sono configurate come punti di controllo umani.

• Il materiale di riferimento lungo si trova in file separati.

• La skill è stata testata su casi reali, incluse le eccezioni.

• La skill rimanda alla versione della SOP di origine e ha un proprietario designato.

Domande frequenti

Cos'è un file SKILL.md?

È il file principale di una skill per agenti IA. Inizia con un frontmatter YAML contenente almeno un nome e una descrizione, seguiti dalle istruzioni markdown che l'agente esegue quando la skill viene richiamata.

Come si trasforma una SOP in una skill per agenti IA?

Si mappa il titolo della SOP nel nome della skill, il suo scopo nella descrizione, i suoi passaggi nelle istruzioni, le sue eccezioni nei guardrail e le sue approvazioni nei punti di controllo umani, per poi testare la skill e mantenerla allineata alla SOP.

Perché le eccezioni della SOP sono importanti per le skill degli agenti?

Le eccezioni descrivono cosa può andare storto e come rimediare. Trasformate in guardrail, indicano all'agente quando procedere, quando fermarsi ed escalare la situazione e cosa non deve fare in nessun caso.

Quali SOP dovrebbero essere convertite per prime in skill per agenti?

SOP approvate, aggiornate e basate su regole per attività ad alto volume con input e output ben definiti, eccezioni gestibili e un basso costo legato a eventuali errori.

Le skill per agenti IA sostituiscono le SOP?

No. La SOP rimane la procedura approvata per le persone e i revisori. La skill ne rappresenta una versione scritta per un agente, ed entrambe devono essere mantenute costantemente sincronizzate.

Le skill per agenti possono includere script?

Sì. Le skill possono includere script e altri file accanto a SKILL.md, ma è necessario revisionare attentamente qualsiasi codice incluso e concedere agli agenti solo gli accessi strettamente necessari.

Come si mantengono aggiornate le skill per agenti?

Collega ogni skill alla versione della sua SOP di origine, assegna un proprietario e aggiorna la skill ogni volta che la SOP o il sistema sottostante cambiano.

In che modo Trupeer aiuta a creare skill per agenti a partire dalle SOP?

Trupeer converte le registrazioni in SOP accurate, e la sua funzionalità Skills consente di applicare istruzioni e formattazioni riutilizzabili alle registrazioni, permettendo di generare output nella struttura desiderata ed esportarli in Markdown.

Trasforma le tue migliori SOP in skill eseguibili dai tuoi agenti

Le tue SOP racchiudono già il modo in cui il lavoro deve essere svolto, compreso cosa fare quando le cose non vanno come previsto. Trasforma quelle più adatte in skill per agenti IA, impostando guardrail a partire dalle eccezioni e coinvolgendo le persone nei punti decisionali chiave, mantenendo entrambi sincronizzati all'evolversi dei processi. Inizia gratuitamente con Trupeer.