Approvazione umana
Approvazione umana delle azioni AI: decide il team, poi agisce l'agente
Contrassegna un'azione API o un passo di una procedura con Requires team approval e l'agente non la esegue più da solo. La richiesta attende nella pagina Approvals, con i suoi input esatti, finché qualcuno del tuo team non la approva o la rifiuta, e il visitatore vede l'esito in chat.
Visitatore: Il mio ordine 48213 è arrivato con il coperchio rotto. Vorrei un rimborso per quell'articolo.
Agente: Mi dispiace. Ho passato al nostro team una richiesta di rimborso per l'articolo dell'ordine 48213. Vedrai l'esito qui in chat. Nel frattempo posso aiutarti con qualcos'altro?
Visitatore: Sì, spedite anche in Austria?
Agente: Sì. Gli ordini verso l’Austria arrivano di solito entro 3-5 giorni lavorativi.
Agente: Buone notizie: il nostro team ha approvato la tua richiesta ed è stata eseguita.
Alcune azioni non dovrebbero partire solo sulla parola dell'AI
Un agente AI che può chiamare la tua API è utile perché fa delle cose: emettere un rimborso, cancellare un abbonamento, aggiungere un accredito, prolungare una prova. Sono però proprio le cose che vuoi far controllare a una persona, almeno all'inizio o sopra un certo importo. Senza un passaggio di verifica hai due scelte sbagliate: dare l'azione all'agente e sperare che non sbagli mai, oppure tenergliela lontana e far gestire ogni richiesta a mano al tuo team. L'approvazione del team mette una persona tra la decisione dell'agente e la tua API. L'agente raccoglie i dettagli nella conversazione, il tuo team approva o rifiuta con un clic e solo una richiesta approvata arriva ai tuoi sistemi.
Perché coinvolgere una persona nelle azioni AI
L'agente gestisce la conversazione, il tuo team ha l'ultima parola su ciò che cambia.
Niente parte solo sulla parola dell'agente
Quando l'agente chiama un'azione che richiede approvazione, alla tua API non viene inviato nulla. La chiamata viene salvata con i suoi input e attende il tuo team. Le richieste rifiutate o scadute non vengono mai eseguite.
Esattamente ciò che hai approvato, una volta sola
L'approvazione esegue l'azione con esattamente gli input mostrati nella pagina. All'AI non viene chiesto di nuovo nulla, quindi non può cambiare importo o numero d'ordine dopo la tua decisione, e una richiesta non viene mai eseguita due volte.
Il visitatore resta informato
L'agente dice al visitatore che la sua richiesta è passata al team e continua ad aiutarlo su tutto il resto. Quando decidi, l'esito compare in chat nella sua lingua: italiano, inglese, tedesco, francese o spagnolo.
Il tuo team viene avvisato
Chi può decidere riceve un'email con gli input e un link. Puoi anche ricevere un avviso Slack e il webhook action_approval.requested, e la conversazione entra nella Inbox come Open.
Si integra nelle tue procedure
Anche un passo di una procedura che chiama un'azione può attendere l'approvazione. Dopo l'approvazione la procedura riprende dal passo successivo; un rifiuto o una scadenza la interrompono.
Come configurare l'approvazione del team
Crea l'azione API
Crea l'azione nella scheda Actions, per esempio una chiamata di rimborso al tuo negozio o al tuo sistema di fatturazione, con input e autenticazione. Solo le azioni lato server possono richiedere approvazione; le azioni lato client e i pulsanti no.
Attiva Requires team approval
In 3. When the AI should use it attiva Requires team approval e scegli quando scade una richiesta in attesa: dopo 1 ora, 4 ore, 24 ore (predefinito) o 3 giorni. Nell'elenco l'azione mostra il badge Needs approval.
Aggiungila a una procedura, se vuoi
In un passo Call an action spunta Requires team approval per quel passo. Abbinalo a Ask the visitor to confirm first: il visitatore conferma e solo dopo la richiesta passa al tuo team.
Approva o rifiuta nella pagina Approvals
Le richieste in attesa compaiono nella pagina Approvals nella barra laterale, con un contatore. Ognuna mostra azione, agente, input, scadenza e un link alla conversazione. Approve la esegue; Reject accetta un motivo facoltativo che il visitatore vede.
L'approvazione nel dettaglio
Scadenza a tua scelta
Ogni azione o passo ha la propria scadenza: 1 ora, 4 ore, 24 ore o 3 giorni. Una richiesta su cui nessuno decide in tempo non viene mai eseguita e il visitatore viene informato che il team non ha potuto esaminarla in tempo.
Nessuna richiesta doppia
Una conversazione può avere fino a 3 richieste in attesa contemporaneamente. Se l'agente richiama la stessa azione con gli stessi input mentre una è in attesa, non viene creata una seconda richiesta.
Vale una sola decisione
Se due colleghi cliccano nello stesso momento, decide chi clicca per primo e l'altro vede “Already decided”. L'azione non viene mai eseguita due volte per una richiesta.
Rifiuta con un motivo
Reject chiede un motivo facoltativo fino a 500 caratteri. Il visitatore lo vede in chat dopo il messaggio che il team non ha potuto approvare la richiesta.
Le credenziali restano nascoste
Gli input il cui nome o valore sembra una credenziale, come api_key, password o un bearer token, compaiono come Hidden nella pagina, nelle email, in Slack e nei webhook. Header e autenticazione della tua azione non vengono mai salvati con una richiesta.
Chi può decidere
L'owner, gli admin e gli editor, e chiunque altro abbia un ruolo che può modificare le azioni dell'agente. I membri limitati ad alcuni agenti vedono solo le loro richieste, e i viewer non possono aprire la pagina.
Decisioni recenti e audit log
Recent decisions elenca le ultime 50, con chi ha deciso, quando, il motivo e il risultato. Ogni approvazione e rifiuto viene anche registrato nell'audit log.
Viene eseguita come l'avrebbe eseguita l'agente
Un'azione approvata parte dall'azione salvata, entro il suo timeout di 30 secondi, con il visitatore verificato e il contatto della conversazione per i segnaposto. Se nel frattempo l'azione è stata eliminata o disattivata, l'approvazione fallisce e il visitatore viene informato.
Domande frequenti
Che cos'è l'approvazione umana delle azioni AI?
È un passaggio di verifica tra la decisione dell'agente AI e i tuoi sistemi. Quando l'agente vuole eseguire un'azione contrassegnata con Requires team approval, come un rimborso, la chiamata viene salvata con i suoi input invece di essere inviata. Qualcuno del tuo team la approva o la rifiuta e solo una richiesta approvata viene eseguita. Spesso si parla di flusso human in the loop.
Quale piano mi serve?
L'approvazione del team fa parte dei piani Pro ed Enterprise. Con Free e Starter l'interruttore non si può attivare. Dopo un downgrade le azioni che lo hanno attivo lo mantengono, ma l'agente non le esegue dalla chat, e sulle richieste fatte prima del downgrade si può ancora decidere.
Quali azioni possono richiedere approvazione?
Qualsiasi azione API lato server e qualsiasi passo Call an action in una procedura. Un'azione con Requires team approval attende l'approvazione in ogni passo che la chiama, con la scadenza dell'azione. Le azioni lato client, che girano nel browser del visitatore, e i pulsanti non possono richiedere approvazione.
Cosa vede il visitatore mentre una richiesta attende?
L'agente gli dice, nella sua lingua, che la richiesta è passata al tuo team e che l'esito comparirà in chat. Nel frattempo può chiedere qualsiasi altra cosa. Una chat aperta mostra l'esito entro circa 15 secondi dalla tua decisione; altrimenti lo vede alla prossima apertura della chat.
L'AI può cambiare i dettagli dopo che ho approvato?
No. L'approvazione esegue l'azione salvata una volta, con esattamente gli input mostrati nella pagina Approvals. All'AI non viene chiesto di nuovo nulla e intoCHAT costruisce la richiesta in quel momento dall'azione salvata, quindi con il tuo endpoint e la tua autenticazione attuali.
Come viene avvisato il mio team?
Con un'email a tutti quelli che possono decidere su quell'agente; ognuno può disattivarla in Notifications (Approval requests). Per ogni agente partono fino a 30 email di richiesta all'ora. Puoi anche attivare l'avviso Slack Approval request, e i webhook inviano gli eventi action_approval.requested e action_approval.decided.
Cosa succede in una procedura mentre un passo attende?
Il passo resta quello corrente e l'agente continua ad aiutare con altre domande. Se la richiesta viene approvata e va a buon fine, la procedura riprende dal passo successivo al prossimo messaggio del visitatore. Se viene rifiutata, scade o l'azione fallisce, la procedura si interrompe. Se la procedura termina prima, la richiesta viene ritirata e non viene mai eseguita.
L'approvazione funziona nel Playground e nei test?
Nel Playground le richieste sono reali: compaiono nella pagina Approvals, avvisano il tuo team e l'approvazione esegue la tua azione vera. Nei test con clienti simulati non viene richiesto nulla; l'agente sente solo che la richiesta è stata fatta. In una chat temporanea un'azione che richiede approvazione non viene eseguita affatto.
L'agente chiede, il tuo team decide
Crea il tuo agente gratis, aggiungi la prima azione API, poi attiva Requires team approval con Pro e prova una richiesta nel Playground.
Crea il tuo agente gratisPiano gratuito, nessuna carta di credito.