Addestrare un agente AI con procedure in linguaggio naturale
Con Orygo AI addestri l’agente AI scrivendo procedure in italiano, come le spiegheresti a un collega: quando intervenire, cosa chiedere al cliente, quali controlli fare e quali azioni chiamare nei tuoi sistemi. Non servono codice né workflow builder. Ogni procedura si accende con un interruttore, si limita ai canali che scegli e si modifica cambiando una frase. L’AI engineer dedicato scrive le prime procedure con te e l’agente è online in 2–3 giorni lavorativi.
4 campi
per ogni procedura: nome, quando usarla, istruzioni, azioni collegate
6 canali
attivabili o escludibili per ogni procedura
90+
azioni richiamabili nel testo con @
2–3 giorni
lavorativi per andare online, procedure incluse
Di Davide Petruzzi, founder di Orygo AI · Aggiornato il
Cos’è una procedura in linguaggio naturale e perché sostituisce il workflow builder?
Una procedura di Orygo AI è un playbook scritto in linguaggio naturale per uno scenario preciso, per esempio “il cliente vuole restituire un prodotto”. Al posto di un diagramma a nodi da disegnare e mantenere, scrivi il comportamento atteso in poche righe, e l’agente AI lo segue adattandosi a come il cliente scrive davvero.
In ogni conversazione l’agente di Orygo AI riceve le procedure attive su quel canale e decide da solo quale applicare in base alla richiesta. Se il cliente cambia argomento a metà, passa alla procedura giusta senza ricominciare. Ogni procedura ha quattro campi.
| Campo | A cosa serve | Esempio |
|---|---|---|
| Nome | Identifica lo scenario | Traccia ordine |
| Descrizione e quando usarla | È il segnale che fa scattare la procedura: l’agente la legge per scegliere | “Il cliente vuole sapere dov’è il suo ordine” |
| Istruzioni | Il comportamento atteso, passo passo, in linguaggio naturale. Le azioni si citano con @ | “Chiedi numero d’ordine ed email, poi usa @Leggi ordine…” |
| Azioni collegate | I tool che l’agente è autorizzato a usare in quello scenario, e nessun altro | Leggi ordine, Tracking spedizione |
La differenza con un chatbot a flussi si vede soprattutto quando bisogna cambiare qualcosa.
| Workflow builder a nodi | Procedure Orygo AI | |
|---|---|---|
| Come si scrive | Si disegna un albero di blocchi, condizioni e risposte fisse | Si scrive un testo, come un’istruzione a un collega |
| Chi lo modifica | Chi ha costruito il flusso, spesso un tecnico | Chiunque nel team customer care o ecommerce |
| Cliente che esce dal percorso | Il flusso si blocca o torna al menu | L’agente segue la conversazione e cambia procedura se serve |
| Azioni nei sistemi | Un blocco di integrazione per ogni passaggio | Si citano con @ dentro il testo |
| Aggiornare una policy | Si ritoccano i nodi che la contengono | Si cambia una frase |
Da quali fonti di conoscenza impara l’agente AI di Orygo AI?
L’agente di Orygo AI unisce le procedure a tre fonti di conoscenza: il catalogo prodotti sincronizzato con lo store, le policy e condizioni di vendita, e i documenti e le FAQ del brand. Le procedure dicono come comportarsi, le fonti dicono cosa è vero, così l’agente risponde con dati aggiornati e non con frasi generiche.
Catalogo prodotti
Orygo AI legge il catalogo direttamente da Shopify, WooCommerce, PrestaShop, Magento, BigCommerce o Salesforce Commerce Cloud. L’agente cerca i prodotti in linguaggio naturale, come sullo storefront, e apre la scheda per SKU, handle, ID o slug. Si sceglie quanti risultati ricevere per ricerca, da 1 a 20 (10 di default). Le integrazioni.
Policy e condizioni di vendita
Spedizioni, resi, pagamenti e garanzie diventano FAQ dell’agente, divise per categoria. Una procedura può chiedere all’agente di leggere solo le FAQ di una categoria, per esempio “resi”, così la risposta su un rimborso cita la regola giusta e non una simile.
Documenti e FAQ
Guide taglie, schede tecniche e manuali si caricano come documenti di testo o PDF; le immagini in gallerie da mostrare in chat. Se la knowledge base non basta, l’agente può cercare sul web, ma solo se una procedura lo prevede e solo sui domini che approvi, per esempio il sito del brand.
Come si scrive una procedura? Tre esempi per un ecommerce
Una procedura efficace di Orygo AI descrive in poche righe cosa chiedere, cosa controllare, quale azione chiamare e quando passare a una persona. Questi tre esempi coprono i casi post-vendita più frequenti; le regole (giorni, soglie, team) sono di esempio e vanno sostituite con le policy del tuo store.
Gestire un reso
La procedura di reso di Orygo AI verifica che l’ordine rientri nella policy e prepara la richiesta per il team, che la approva con un clic.
Reso o cambio
Quando usarla: il cliente vuole restituire o cambiare un prodotto ricevuto.
- 1Chiedi numero d’ordine ed email, poi recupera l’ordine con @Leggi ordine.
- 2Se la consegna risale a più di 30 giorni fa, spiega con gentilezza che il reso non è più possibile e cita la policy con @FAQ resi.
- 3Se è entro i 30 giorni, chiedi quale prodotto e il motivo, poi proponi il cambio taglia prima del rimborso.
- 4Se il cliente conferma, avvia la richiesta con @Avvia reso e spiegagli i prossimi passi.
Gestire un prodotto danneggiato
Un prodotto danneggiato o mancante è un caso di escalation: l’agente di Orygo AI raccoglie le prove e passa la pratica al team con tutto già pronto.
Prodotto danneggiato o mancante
Quando usarla: il cliente dice che un prodotto è arrivato rotto, difettoso o non c’era nel pacco.
- 1Scusati per il disagio e recupera l’ordine con @Leggi ordine.
- 2Chiedi una foto del prodotto e dell’imballo, poi controllala con @Vista immagine e descrivi il danno nella nota.
- 3Non promettere rimborsi o sostituzioni.
- 4Se il team è in turno, passa la chat con @Trasferimento live al team Post-vendita, con tag “danneggiato”.
- 5Fuori orario, apri un @Ticket email e di’ al cliente che riceverà risposta via email.
Gestire un ritardo di spedizione
Per un ritardo la procedura di Orygo AI combina ordine e tracking del corriere, e apre un ticket solo quando il ritardo supera la soglia che decidi tu.
Ritardo di spedizione
Quando usarla: il cliente chiede perché l’ordine non è ancora arrivato.
- 1Chiedi numero d’ordine ed email e leggi l’ordine con @Leggi ordine.
- 2Se è spedito, leggi lo stato con @Tracking spedizione e riporta al cliente data e ultimo passaggio del corriere.
- 3Se è fermo da più di 5 giorni lavorativi, applica il tag “ritardo” con @Tag e apri un @Ticket email per il team logistica.
- 4Se il cliente è molto arrabbiato, passa a una persona.
I nomi delle azioni dopo la @ sono indicativi: nel pannello compaiono quelle attive sul tuo account. Il tracking passa da Qapla’ o ShippyPro: tracking ordini automatico.
Da dove si parte: le procedure già pronte
Nessuno parte da una pagina bianca. In fase di setup Orygo AI propone scenari già pronti e l’assistente li scrive, collegando anche le azioni:
- Cercare prodotti da descrizione, budget o uso
- Taglie, materiali, compatibilità e disponibilità
- Spedizioni, resi, pagamenti e policy
- Tracciare un ordine da numero ed email
- Cancellare un ordine, avviare un reso o un cambio
- Consigliare prodotti e gift finder
- Consigliare la taglia
- Raccogliere nome, email e richiesta di richiamata
Come decide l’agente AI quando passare il cliente a una persona?
In Orygo AI le escalation sono procedure dello stesso tipo, raccolte in una pagina dedicata: descrivi quando l’agente deve fermarsi e come passa la conversazione. Le analytics di Orygo AI misurano anche le escalation mancate, cioè i casi in cui il cliente andava passato a una persona e il passaggio non è avvenuto.
| Scenario | Passaggio consigliato |
|---|---|
| Il cliente chiede esplicitamente una persona | Trasferimento live se il team è in turno, altrimenti ticket email |
| Cliente frustrato o arrabbiato | Trasferimento live con nota interna di handover |
| Prodotto danneggiato o mancante | Ticket con foto, tag e team assegnato |
| Rimborso fuori policy | Ticket per l’approvazione del team |
| Problemi di pagamento o cambio indirizzo dopo la spedizione | Trasferimento live o ticket, secondo l’orario |
| Richieste wholesale | Ticket al team commerciale |
| Richieste legali o sulla privacy | Ticket silenzioso, senza risposta automatica |
Come si aggiorna una procedura dell’agente AI?
Per aggiornare una procedura di Orygo AI apri il testo, cambi la frase che non va e salvi: l’agente usa la nuova versione dalla conversazione successiva, senza rilasci né sviluppatori. Prima di pubblicarla puoi provarla nel playground, e dopo puoi misurarla su traffico reale.
[01]
Modifica il testo della proceduraPer esempio quando cambia la policy resi a gennaio.[02]
Scegli i canaliDi default vale ovunque, ma puoi escludere chat, email, WhatsApp, Instagram, Messenger o Amazon.[03]
Provala nel playground di testChatti come un cliente e guardi ragionamento e azioni di ogni risposta. Il playground.[04]
Accendila con l’interruttoreUna procedura stagionale, come quella dei saldi, si spegne con lo stesso interruttore.[05]
Controlla i risultatiL’analisi di sessione registra quali procedure l’agente ha seguito in ogni conversazione. Gli analytics di Orygo AI.[06]
Confronta due versioniCon un A/B test ogni variante può avere un set di procedure diverso, così misuri il comportamento e non solo il tono.
Le procedure lavorano anche nelle missioni proattive, come recupero carrello e riordino: ogni missione usa solo le procedure selezionate per lei, e solo le azioni che quelle procedure prevedono.
Che rapporto c’è tra procedure, azioni e integrazioni?
In Orygo AI le procedure dicono all’agente quando intervenire e come comportarsi, le azioni sono i tool che può chiamare, e le integrazioni collegano quei tool ai sistemi del negozio: catalogo, ordini, spedizioni, CRM e ticketing. Una procedura può usare solo le azioni che le colleghi.
La procedura “traccia ordine” chiede numero ed email, chiama l’azione ordine dello store collegato e, se il pacco è in transito, legge il tracking su Qapla’ o ShippyPro. Se il cliente è arrabbiato, un’escalation apre il ticket o passa la chat live con nota, team e tag, e il team ritrova il cliente in inbox con profilo e ordini già caricati.
Cosa fa l’AI engineer dedicato nell’addestramento?
Ogni cliente Orygo AI ha un AI engineer dedicato che scrive con il team le prime procedure, collega store e canali e testa l’agente sulle conversazioni reali prima del lancio. Dopo il go-live rivede le procedure ogni settimana su vendite e risoluzioni. Il lavoro è incluso nel prezzo, senza costo di setup.
Prima del lancio
Raccoglie policy, catalogo e le domande che i clienti fanno già, e le trasforma in FAQ e procedure per vendita, resi, ordini e taglie.
Al lancio
Prova l’agente nel playground sui casi limite, imposta escalation e canali, e lo mette online quando il team è pronto a subentrare.
Dopo il lancio
Legge le conversazioni, corregge le procedure che non risolvono e propone A/B test sulle varianti più promettenti.
Domande frequenti sull’addestramento dell’agente AI
Servono competenze tecniche per addestrare l’agente AI di Orygo AI?
No. Le procedure di Orygo AI si scrivono in italiano, come un’istruzione a un collega, e le azioni si richiamano digitando @ e il nome del tool. Il setup iniziale lo fa l’AI engineer dedicato; il team può poi modificare le procedure da solo.
Quanto tempo serve per addestrare l’agente AI di Orygo AI?
Con Orygo AI l’agente è online in 2–3 giorni lavorativi, procedure, collegamento dello store, test e go-live compresi. Una singola procedura si scrive o si modifica in pochi minuti e la modifica vale dalla conversazione successiva.
Come sceglie l’agente quale procedura applicare?
In ogni conversazione l’agente di Orygo AI riceve le procedure attive su quel canale, ciascuna con una descrizione di quando usarla. In base a quello che chiede il cliente decide da solo quale applicare; il nome e la descrizione della procedura sono quindi il campo più importante da scrivere bene.
Che differenza c’è tra una procedura e una FAQ?
Una FAQ di Orygo AI contiene un’informazione: per esempio, i resi sono gratuiti entro 30 giorni. Una procedura contiene un comportamento: cosa chiedere al cliente, quali controlli fare, quali azioni chiamare e quando passare la conversazione a una persona.
Posso usare procedure diverse su canali diversi?
Sì. Ogni procedura di Orygo AI vale di default su tutti i canali e si può escludere da chat, email, WhatsApp, Instagram, Messenger o Amazon. Una procedura di reso può lavorare solo in email, mentre la ricerca prodotto resta sul widget del sito.
Ordini, tracking, CRM, ticket e passaggio al team: le azioni che l’agente esegue nei tuoi sistemi, e come collegare i tuoi con un webhook.
Scopri azioni e tool AIColori, logo, pulsante, posizione e tono di voce: personalizza l’agente AI perché abbia l’aspetto e il modo di parlare del tuo brand. Scopri come.
Scopri design e tono di voceProva l’agente AI nel playground con le domande dei tuoi clienti, mettilo sotto stress sui casi limite e vai live tranquillo. Errori sotto lo 0,5%.
Scopri playground di testFAQ, documenti, PDF e cartelle di immagini da cui l’agente prende le risposte, su tutti i canali.
Scopri knowledge baseProtezione anti-bot con Cloudflare Turnstile, limiti di traffico per agente e avvisi quando le richieste bloccate aumentano.
Scopri sicurezzaConfronta due versioni dell’agente AI su traffico reale e scopri quale vende e risolve di più. Log, costo per risposta e risultati misurati.
Scopri a/B testVuoi vedere le procedure di Orygo AI sul tuo store?
Prenota una demo: scriviamo insieme due procedure sul tuo catalogo e sulle tue policy, per esempio reso e tracking, e le proviamo nel playground in diretta.