Revisione umana

Cosa fa una Human review

Un Human review è un'azione di risposta. Quando il Flow lo raggiunge, l'Assistant si ferma e chiede una decisione ai colleghi indicati. Il Visitor legge un messaggio di attesa. Il Flow prosegue solo dopo l'approvazione del primo collega. Se un collega rifiuta la richiesta, oppure se nessuno risponde entro il tempo previsto, il Flow si interrompe con un messaggio che hai configurato.

La richiesta viene inviata tramite email dalla tua casella di posta Microsoft 365, oppure tramite Slack attraverso la connessione Slack dell'organizzazione. Entrambi riportano il titolo, il tuo messaggio, un riepilogo della conversazione e un link firmato a una pagina di decisione nella console.

Configura l'azione

1. Aggiungi Human review dalla palette o dal selettore delle azioni.
2. Inserisci un Title e un Message to the reviewer. Le variabili dei template funzionano in entrambi i casi.
3. Inserisci i revisori sotto Assigned to, come indirizzi email. Ogni indirizzo deve appartenere a un Member dell'Organization.
4. Seleziona il Channel.
   • Email: collega la tua casella di posta Microsoft 365 con Connect, quindi selezionala in Sent from. La richiesta viene inviata dal tuo account.
   • Slack: inserisci l'ID del canale o l'ID del membro. La connessione Slack dell'organizzazione deve avere lo scope chat:write.
5. Aggiungi almeno un Input che il revisore dovrà compilare: short text, long text, un menu a discesa o yes / no. Ogni input ha un id.
6. Imposta Expires after in ore. Il valore predefinito è 24.
7. Inserisci ciò che il Visitor legge while waiting e if rejected or expired.

Il nodo mostra Needs setup finché non sono stati impostati tutti i campi obbligatori. Publish rifiuta un Flow i cui revisori non sono Members o il cui mittente non è connesso.

Visualizza l'anteprima della richiesta

Sul canvas, seleziona il nodo e apri Run node. Il pannello mostra l'email o il messaggio Slack così come li leggerà il revisore. Da lì non viene inviato nulla.

Prendi una decisione su una richiesta

Il link apre una pagina nella console. Devi aver effettuato l'accesso. La pagina mostra il messaggio, la conversazione finora, gli input e Approve / Reject.

• Solo un assignee, oppure un Owner o un Admin, può decidere.
• La prima decisione chiude la richiesta. I visitatori successivi vedono chi ha preso la decisione.
• L'approvazione con un input obbligatorio vuoto viene rifiutata.

Una richiesta in sospeso viene visualizzata anche nel Inbox. Apri la conversazione per visualizzare il suo stato e gli input del revisore, oppure filtra l'Inbox per Human review → Pending reviews.

Cosa succede dopo la decisione

• Approved: le azioni successive all'esecuzione della revisione umana. Gli input del revisore sono disponibili come variabili di template, {{review.<id>}}, insieme a {{review.decidedBy}} e {{review.approved}}. La risposta viene aggiunta alla conversazione come il messaggio successivo dell'Assistente.
• Rejected o expired: al suo posto viene aggiunto il messaggio di interruzione.

La richiesta in sospeso mantiene le Flow actions, le Assistant settings, le Skills e le variabili estratte ammesse al momento dell'avvio. Le modifiche ordinarie si applicano alle nuove richieste. La disabilitazione o l'eliminazione del Flow, oppure l'annullamento della pubblicazione dell'Assistente, interrompe definitivamente il lavoro in sospeso. L'abilitazione o la nuova pubblicazione non riavviano tale lavoro. Le credenziali e le autorizzazioni correnti continuano ad applicarsi quando il Flow prosegue. Le credenziali di autenticazione inserite manualmente possono essere ruotate mentre una richiesta è in attesa. Le modifiche agli header delle richieste in formato libero o ai parametri di query interrompono l'esecuzione in modo sicuro. Questi campi possono contenere credenziali personalizzate, pertanto Ciele non conserva alcun valore non elaborato nella prosecuzione. Gli allegati originali e la prova di identità salvata non vengono conservati. Un'azione dipendente dall'identità richiede una nuova richiesta attended. Le richieste precedenti senza una continuazione salvata vengono interrotte con una spiegazione. Avvia una nuova richiesta per continuare.

Il Visitor vede il risultato la volta successiva in cui scrive o riapre la chat.

Anteprima

Nell'Anteprima, la richiesta viene simulata. Non viene inviato nulla. La trascrizione mostra la richiesta con i pulsanti Approve e Reject, e il Flow prosegue nella stessa chat. Una chat Teammate non ha Flow, quindi non arriva mai a una Human review.

API, CLI e MCP

Una chiave API non ha un indirizzo email, quindi può decidere solo quando il suo Role è Owner o Admin.