Aggiunta di attività utente
Un'attività utente consiste in una o più interazioni basate sulla chat per raccogliere input e visualizzare risultati all'interno di un flusso di lavoro agenziale. Supporta l'interazione a metà flusso, consentendo agli utenti di visualizzare e rispondere alle informazioni direttamente nell'interfaccia della chat. Ad esempio, l'approvazione di una richiesta, la scelta da un elenco, la risposta a domande di follow-up o la segnalazione di un problema.
Per aggiungere un'attività utente a un flusso di lavoro agenziale:
Nel generatore di flussi di lavoro, fare clic su "Aggiungi elementi del flusso
".Dai nodi Flow, clicca e trascina "Attività utente" su una linea di collegamento.
Per un video dimostrativo su come aggiungere attività utente, consultare "Creazione di un flusso di lavoro autonomo con attività utente in watsonx Orchestrate " nella sezione Video.
Aggiunta di interazioni
È possibile utilizzare le interazioni per raccogliere informazioni dall'utente o visualizzare informazioni all'utente nella chat o all'interno di un modulo. Le interazioni possono apparire nelle attività multi-turno degli utenti o all'interno dei moduli. Il tipo di interazione scelto determina il widget dell'interfaccia utente visualizzato all'utente.
Tipi di interazione disponibili
La tabella seguente riassume tutti i tipi di interazione, le esperienze che supportano e il widget dell'interfaccia utente visualizzato all'utente.
Tipo di interazione |
Descrizione |
Disponibile in |
Widget dell'interfaccia utente |
|---|---|---|---|
Scelta booleana |
Raccogliere le risposte affermative o negative |
Multigiro e forma |
Multi-turn: pillole (pulsanti); Forma: casella di controllo o pulsante di opzione |
Scelta singola |
Seleziona un'opzione da un elenco |
Multigiro e forma |
Elenco a discesa o tabella |
Scelta multipla |
Raccogli più selezioni |
Modulo |
Elenco a discesa o tabella |
Testo |
Raccogliere un input di testo |
Multigiro e forma |
Campo testo |
Numero |
Raccogliere un input numerico |
Multigiro e forma |
Campo Numero |
Data |
Raccogliere un input di data |
Multigiro e forma |
Selettore data |
Intervallo di date |
Raccogli la data di inizio e la data di fine |
Modulo |
Selezione intervallo di date |
Caricamento file |
Raccogli uno o più file |
Multigiro e forma |
Controllo caricamento file |
Elenco (input) |
Raccogliere più valori inseriti dall'utente |
Modulo |
Tabella |
Elenco (output) |
Visualizza un elenco di valori |
Multigiro e forma |
Elenco puntato o tabella |
Messaggio |
Visualizza un messaggio di testo |
Multigiro e forma |
Testo semplice, Markdown o HTML |
Download del file |
Visualizza un file scaricabile |
Multigiro e forma |
Link di download |
Campo |
Visualizza un singolo valore in un modulo |
Modulo |
Campo |
Questo riepilogo fornisce una visione unificata dei tipi di interazione tra interazioni e moduli multi-turn e aiuta a comprendere il widget dell'interfaccia utente visualizzato per ciascun tipo.
I file caricati tramite un modulo non vengono eliminati e al momento non esiste alcun meccanismo che consenta di rimuoverli automaticamente dopo un determinato periodo di tempo. Non è possibile accedere ai file caricati in precedenza in alcun modo, né tramite l'API né tramite l'interfaccia utente. Anche l'accesso al file stesso ha una scadenza della firma, il che impedisce la disponibilità a lungo termine dell' URL e scaricabile.
Aggiunta di interazioni multigiro
Per aggiungere un'interazione multi-turn all'attività dell'utente:
Clicca sulla linea di collegamento nell'attività dell'utente.
Selezionare Raccogli dall'utente per raccogliere informazioni. È possibile scegliere tra i seguenti tipi di interazione:
Scelta booleana, Data, Caricamento file, Numero, Scelta singola e Testo.
Selezionare Presenta all'utente per visualizzare le informazioni. È possibile scegliere tra i seguenti tipi di interazione:
Download file, elenco e messaggio.
Per l'interazione dei messaggi, se desideri che le parentesi graffe appaiano come testo normale, sostituiscile con doppie parentesi graffe. Ad esempio, {{customer_id}} viene visualizzato come {customer_id} nel messaggio di output e il testo all'interno delle doppie parentesi graffe viene trattato come testo normale, non come variabile.
Aggiunta di interazioni basate sui moduli
I moduli supportano gli stessi tipi di interazione delle interazioni multi-turn. Includono anche alcuni tipi di interazione disponibili solo nei moduli, come la selezione multipla e l'inserimento di elenchi. È possibile aggiungere queste interazioni selezionando Raccogli dall'utente o Presenta all'utente durante la configurazione dei campi del modulo.
Per informazioni dettagliate su come configurare ciascun tipo di campo, consultare le sezioni Raccogliere dall'utente e Presentare all'utente nella documentazione relativa ai moduli.
Oltre alle interazioni a livello di campo, i moduli supportano regole dinamiche che determinano il comportamento dei campi in base agli input dell'utente. Le regole dinamiche consentono di mostrare o nascondere i campi, modificare le etichette dei campi o inserire i valori nei campi in modo dinamico man mano che gli utenti compilano il modulo. Per informazioni sulle regole dinamiche e sul comportamento dei moduli dinamici, consultare la sezione Moduli dinamici.
Modifica delle interazioni
Per modificare un'interazione nell'attività dell'utente:
Fare clic sull'interazione.
Passa il mouse sul nome e clicca su «Modifica
».Inserisci il nuovo nome e premi Invio.
Eliminazione delle interazioni
Per eliminare un'interazione nell'attività dell'utente:
Fare clic sull'interazione.
Seleziona "Elimina
".
Il titolo di questo nodo viene visualizzato all'utente nella chat.
Configurazione delle variabili per le interazioni
Per configurare le variabili per la raccolta dalle interazioni dell'utente:
Configura un nodo di interazione a scelta singola per raccogliere l'input a scelta singola dall'utente.
Fai clic sulla variabile
e seleziona la variabile per acquisire un dato a scelta singola dall'utente. Per creare un'opzione personalizzata, è possibile fare clic sull'espressione
e inserire un'espressione Python che restituisca le opzioni tra cui l'utente potrà scegliere.
Per configurare le variabili per la visualizzazione delle interazioni dell'utente:
Configura un nodo Interazione testo per visualizzare un testo nella chat.
Inserire il testo da visualizzare nel messaggio di uscita. Se desideri inserire nel tuo messaggio il valore di una variabile, clicca su «variabile»
e seleziona la variabile dall'elenco.
Configura un nodo di interazione Elenco per visualizzare un elenco nella chat.
Fare clic sul campo Seleziona origine.
Fai clic sulla variabile
e seleziona quella che fornisce l'elenco dei valori da visualizzare nella chat. Per creare un elenco personalizzato, puoi fare clic sull'espressione
e inserire un'espressione di tipo " Python " che generi un elenco.
Configura un nodo di interazione Download file per visualizzare un file scaricabile nella chat.
Fare clic sul campo Seleziona origine.
Fai clic sulla variabile
.Selezionare una variabile che fornisce il file da scaricare.
Moduli nelle attività degli utenti
È possibile utilizzare i moduli nelle attività degli utenti per raccogliere e presentare più informazioni in un unico turno di conversazione. Ad esempio, in un flusso di lavoro agenziale per la prenotazione di un volo, un modulo può raccogliere date di viaggio, destinazioni, preferenze di classe e altri dettagli. La chat può quindi visualizzare un elenco di voli disponibili in base alle indicazioni dell'utente.
Aggiunta di moduli
Per aggiungere un modulo a un'attività utente in un flusso di lavoro agenziale:
Clicca sulla linea di collegamento nell'attività dell'utente.
Seleziona Aggiungi un modulo. Viene visualizzata una finestra di dialogo per aggiungere un modulo.
Clicca qui
e inserisci il nome del modulo. Per impostazione predefinita, nelle impostazioni generali del modulo, l'interruttore a levetta Istruzioni, utilizzato per aggiungere istruzioni che vengono visualizzate in una chat per l'utente, è disattivato. Se si preferisce fornire istruzioni all'utente, impostare l'interruttore su on.Nella sezione Azione primaria è possibile configurare il pulsante Azione primaria per il modulo.
Il pulsante di azione primaria rappresenta l'azione principale dell'utente per completare il modulo. Per impostazione predefinita, l'azione principale è Invia, ma è possibile rinominarla in base alle proprie esigenze.
Nella sezione Azioni aggiuntive è possibile aggiungere ulteriori pulsanti di azione per il modulo.
Per fornire più di un'azione di completamento, selezionare il pulsante Aggiungi azione aggiuntiva nel campo Azioni aggiuntive. Viene visualizzato un campo di immissione in cui è possibile inserire un nome per l'azione aggiuntiva.
Ogni pulsante Azione aggiuntiva crea un ramo separato nel flusso di lavoro, che viene visualizzato sotto il modulo come percorsi separati etichettati con i nomi delle azioni, accanto al ramo dell'azione primaria esistente.
È possibile aggiungere elementi di flusso a ciascun ramo di azione aggiuntiva per definire la logica del flusso di lavoro per quell'azione.
È possibile aggiungere fino a tre pulsanti di azione aggiuntivi a un modulo. Quando viene definita più di un'azione aggiuntiva, i pulsanti vengono raggruppati in un menu a discesa Azioni nel modulo.
Nella sezione Annulla è possibile configurare il pulsante Annulla per il modulo.
È possibile inserire del testo per rinominare il pulsante Annulla.
Per rimuovere il pulsante Annulla dal modulo, disattiva l'interruttore a levetta.
Passa il mouse sul campo "Aggiungi" o sull'icona "Aggiungi"
, quindi seleziona "Raccogli dall'utente" o "Mostra all'utente" per aggiungere campi (tipi di interazione dell'utente) al modulo.
È possibile aggiungere campi per raccogliere informazioni dagli utenti, presentare informazioni agli utenti in una chat e definire regole dinamiche per controllare il comportamento dei campi in base agli input degli utenti. Per ulteriori informazioni, consultare le sezioni "Raccolta dati dall'utente ", "Presentazione all'utente " e "Moduli dinamici".
Raccogliere dati dall'utente
Per raccogliere informazioni dagli utenti in un modulo, è possibile aggiungere uno dei seguenti campi:
Booleano
Le opzioni booleane consentono all'utente di specificare un'opzione booleana in una chat. È possibile aggiungere campi booleani a un modulo per passare i dati specificati dall'utente ai nodi a valle, che vengono poi utilizzati dal flusso di lavoro agenziale. Per aggiungere un campo booleano a un modulo:
Nella finestra di dialogo del modulo, fare clic su "Aggiungi campo" oppure sull'icona "
Aggiungi".Seleziona Raccogli dall'utente.
Selezionare Boolean.
In Generale > Etichetta, inserire il testo di questo campo che viene visualizzato dall'utente in una chat.
In Aspetto > Visualizza come, selezionare il modo in cui i campi booleani vengono visualizzati in una chat, come una singola casella di controllo o come pulsanti di opzione.
Nelle opzioni Etichetta vera e Etichetta falsa per i pulsanti di opzione, è possibile modificare il testo visualizzato all'utente in una chat per le opzioni booleane.
In Comportamento, è possibile specificare un valore iniziale per il campo booleano utilizzando una variabile, un'espressione o le opzioni di mappatura automatica. Il valore iniziale viene utilizzato come valore predefinito nella chat e aiuta gli utenti a completare rapidamente un modulo. Gli utenti possono accettare o modificare questo valore.
Se si desidera specificare un valore iniziale per true o false, chiudere la mappatura automatica e specificare un valore.
Un campo booleano è stato aggiunto al modulo. L'esempio seguente mostra come viene visualizzato nella chat.

Data/ora
È possibile aggiungere un campo data e ora a un modulo per raccogliere la data, l'ora o entrambe. Questo campo supporta scenari di flusso di lavoro quali la selezione di date di inizio, date di fine, scadenze o orari di promemoria. Il valore selezionato dall'utente nella chat viene registrato e utilizzato dal flusso di lavoro dell'agente.
Per aggiungere un campo data e ora a un modulo:
Nella finestra di dialogo del modulo, fare clic su "Aggiungi campo" oppure sull'icona "
Aggiungi".Seleziona Raccogli dall'utente.
Seleziona data e ora.
In Generale > Etichetta, inserisci il testo che verrà visualizzato dall'utente nella chat.
Attiva l'opzione "Date multiple " per consentire agli utenti di selezionare più di una data. Altrimenti, disattiva l'interruttore. L'opzione " Date multiple " è disponibile solo se il tipo di campo è "Data".
Impostare l'interruttore Required su on per rendere obbligatoria la selezione di questo campo in una chat. Altrimenti, impostare l'interruttore su off.
In "Tipo di input ", seleziona il tipo di dati che desideri raccogliere. È possibile scegliere tra "Data ", "Ora " o "Data e ora ", a seconda del valore che l'utente deve inserire.
In "Comportamento ", attiva l'opzione " Valore iniziale" per definire un valore predefinito per il campo data o ora. È possibile impostare il valore iniziale utilizzando una variabile o un'espressione per tutti i tipi di input. Se il tipo di dato è "Data ", è possibile utilizzare anche la mappatura automatica. Gli utenti possono accettare o modificare il valore iniziale nella chat.
In "Comportamento ", attivare l'opzione " Intervallo di immissione " per definire l'intervallo valido per il campo data, ora o data e ora. I campi "Inizio" e "Fine" variano a seconda del tipo di input selezionato. È possibile definire i valori iniziale e finale utilizzando una variabile o un'espressione per tutti i tipi di input. Se il tipo di dato è "Data ", è possibile utilizzare anche la mappatura automatica.

Data/Intervallo di tempo
È possibile aggiungere a un modulo un campo per l'intervallo di data e ora, in modo che l'utente possa specificare un valore iniziale e un valore finale in una chat. Il tipo di intervallo può essere una data o un'ora. Questi valori forniti dall'utente possono essere utilizzati dal flusso di lavoro agentico in contesti quali le richieste di ferie, la pianificazione o qualsiasi flusso di lavoro che richieda un intervallo definito.
Per aggiungere un campo con intervallo di data e ora a un modulo:
Nella finestra di dialogo del modulo, fare clic su "Aggiungi campo" oppure sull'icona "
Aggiungi".Seleziona Raccogli dall'utente.
Seleziona l'intervallo di date e ora.
In Generale > Etichetta, inserisci il testo che verrà visualizzato dall'utente nella chat.
Impostare l'interruttore Required su on per rendere obbligatoria la selezione di questo campo in una chat. Altrimenti, impostare l'interruttore su off.
Nel campo " Tipo di intervallo ", seleziona l'intervallo che l'utente deve specificare. È possibile scegliere tra "Data" o "Ora", a seconda del valore che l'utente deve inserire.
Nella sezione Aspetto, inserisci le etichette per i campi di inizio e fine che vengono visualizzati all'utente nella chat. I campi dell'etichetta disponibili dipendono dal tipo di intervallo selezionato.
In "Comportamento ", attivare l'opzione "Valore iniziale" per definire i valori predefiniti di inizio e fine per la data o l'ora field.You e può impostare i valori di inizio e fine utilizzando una variabile o un'espressione per tutti i tipi di intervallo. Se il tipo di campo è "Data ", è possibile utilizzare anche la mappatura automatica. Gli utenti possono accettare o modificare i valori iniziali nella chat.
Attivare l'opzione "Limiti intervallo data" o "Limiti intervallo ora" per definire l'intervallo valido per il campo data o ora. I campi "Inizio" e "Fine" variano a seconda del tipo di intervallo selezionato. È possibile definire i valori iniziale e finale utilizzando una variabile o un'espressione per entrambi i tipi di intervallo. Se il tipo di campo è "Data ", è possibile utilizzare anche la mappatura automatica.
Al modulo è stato aggiunto un campo per la selezione di data e intervallo di tempo. L'esempio seguente mostra come viene visualizzato il campo dell'intervallo di date nella chat.

Caricamento file
È possibile aggiungere un campo di caricamento file a un modulo. Questo campo è utile per i flussi di lavoro agenziali in cui gli utenti possono caricare file in una chat, ad esempio per l'elaborazione di documenti, la collaborazione, la generazione di sommari e altro.
Per aggiungere un campo di caricamento file a un modulo:
Nella finestra di dialogo del modulo, fare clic su "Aggiungi campo" oppure sull'icona "
Aggiungi".Seleziona Raccogli dall'utente.
Selezionare Carica file.
In Generale > Etichetta, inserire il testo di questo campo che viene visualizzato dall'utente in una chat.
Per consentire il caricamento di più file, impostare l'interruttore Consenti più file su on. Per rendere obbligatoria la selezione di questo campo in una chat, impostare l'interruttore Required su on.
In Aspetto > Istruzioni, è possibile inserire le istruzioni per aiutare l'utente a caricare i file oppure fare clic su Genera istruzioni per generare automaticamente le istruzioni in base alle dimensioni e al tipo di file selezionati in Comportamento.
Nell'opzione Etichetta pulsante, è possibile specificare un'etichetta per il campo di caricamento dei file.
In Comportamento, è possibile specificare i tipi di file supportati che l'utente può caricare e il limite massimo di dimensioni dei file.
Se l'opzione "Consenti più file" è attivata, è possibile specificare i limiti per il caricamento dei file. Per specificare i limiti di caricamento dei file, attiva l'opzione " Limiti di caricamento dei file " e inserisci il numero minimo e massimo di file.
Al modulo è stato aggiunto un campo per il caricamento dei file. L'esempio seguente mostra come viene visualizzato nella chat.

Elenco
È possibile aggiungere un campo elenco a un modulo quando è necessario raccogliere un elenco di informazioni da un utente. Gli elementi dell'elenco possono essere tipi di dati primitivi, come stringhe o date, oppure tipi di dati oggetto, come i dettagli di un volo.
Per aggiungere un campo elenco a un modulo:
Nella finestra di dialogo del modulo, fare clic su "Aggiungi campo" oppure sull'icona "
Aggiungi".Seleziona Raccogli dall'utente.
Selezionare l' elenco.
In Generale > Etichetta, inserire il testo di questo campo che viene visualizzato dall'utente in una chat.
Nella variabile Origine è possibile specificare un'origine per l'elenco utilizzando una variabile o un'espressione.
Se si specifica una variabile sorgente che è un elenco di oggetti, è possibile scegliere di visualizzare i dati sotto forma di tabella. Nella sezione Aspetto, clicca su Modifica elementi per configurare la modalità di visualizzazione degli elementi dell'elenco agli utenti. Quando si fa clic su "Modifica elementi ", si apre una finestra di dialogo dedicata in cui è possibile gestire gli elementi.
Nella sezione Modifica elementi è possibile:
Riorganizza gli elementi : trascina il
per modificare l'ordine di visualizzazione.Controlla la visibilità : clicca sull'icona Visibilità per nascondere singoli elementi.
Modifica delle etichette : modifica il testo nella colonna "Etichetta elemento" per personalizzare la visualizzazione di ciascun elemento agli utenti.
Metti in ordine le etichette : clicca su "Metti in ordine le etichette" per formattare automaticamente tutte le etichette.
Reimposta etichette : fare clic su "Reimposta etichette" per ripristinare tutti i valori delle etichette a quelli originali della variabile di origine.
Nella sezione Comportamento è possibile configurare le modalità di interazione degli utenti con l'elenco.
Imposta l'opzione Consenti aggiunte su On se desideri che gli utenti possano aggiungere elementi all'elenco. Imposta l'opzione Consenti eliminazione su On se desideri che gli utenti possano rimuovere elementi dall'elenco.
Scelta multipla
È possibile aggiungere un campo a scelta multipla a un modulo per raccogliere più di un'opzione da un elenco in una chat. Le opzioni specificate dall'utente vengono poi utilizzate dal flusso di lavoro agenziale. Questo campo è utile per i flussi di lavoro agenziali in cui gli utenti possono selezionare più opzioni in una chat, ad esempio più reparti per un rapporto, più categorie per un'attività e altro.
Per aggiungere un campo a scelta multipla a un modulo:
Nella finestra di dialogo del modulo, fare clic su "Aggiungi campo" oppure sull'icona "
Aggiungi".Seleziona Raccogli dall'utente.
Selezionare la scelta Multi.
In Generale > Etichetta, inserire il testo di questo campo che viene visualizzato dall'utente in una chat.
Impostare l'interruttore Required su on per rendere obbligatoria la selezione di questo campo in una chat. Altrimenti, impostare l'interruttore su off.
Nel campo " Variabile di origine " è possibile specificare un'origine per l'elenco utilizzando una variabile o un'espressione.
Se si specifica una variabile sorgente che è un elenco di oggetti, che definisce i dati, è possibile scegliere se visualizzare i dati come elenco a discesa o come tabella. Per scegliere un tipo di visualizzazione, in Aspetto > Visualizza come, seleziona Menu a tendina o Tabella.
Se selezioni l'opzione a discesa, imposta il nome visualizzato per ciascuna voce dell'elenco utilizzando una variabile o un'espressione.
Se selezioni l'opzione Tabella, fai clic su Modifica colonne per configurare la modalità di visualizzazione delle colonne agli utenti. Quando si fa clic su "Modifica colonne ", si apre una finestra di dialogo dedicata in cui è possibile gestire gli elementi.
Nella sezione Modifica elementi è possibile:
Riorganizza gli elementi : trascina il
per modificare l'ordine di visualizzazione.Controlla la visibilità : clicca sull'icona Visibilità per nascondere singoli elementi.
Modifica delle etichette : modifica il testo nella colonna "Etichetta elemento" per personalizzare la visualizzazione di ciascun elemento agli utenti.
Metti in ordine le etichette : clicca su "Metti in ordine le etichette" per formattare automaticamente tutte le etichette.
Reimposta etichette : fare clic su "Reimposta etichette" per ripristinare tutti i valori delle etichette a quelli originali della variabile di origine.
Nell'opzione Testo segnaposto è possibile specificare il testo che viene visualizzato dall'utente quando l'elenco a discesa è vuoto.
In Comportamento, è possibile specificare un valore iniziale per l'elenco utilizzando una variabile, un'espressione o le opzioni di mappatura automatica. Il valore iniziale viene utilizzato come valore predefinito nella chat e aiuta gli utenti a completare rapidamente un modulo. Gli utenti possono accettare o modificare questo valore. È anche possibile specificare
Se si desidera specificare un valore particolare da utilizzare come valore iniziale, chiudere la mappatura automatica e inserire il valore.
Per limitare il numero di elementi che un utente può selezionare nell'elenco, specificare il numero minimo e massimo di opzioni utilizzando l'opzione "Limite di selezione ". Ad esempio, specifica i limiti di selezione nel caso in cui un utente debba selezionare un minimo di 2 elementi e un massimo di 5 elementi.
Un campo a scelta multipla è stato aggiunto al modulo. L'esempio seguente mostra come viene visualizzato nella chat.

Numero
È possibile aggiungere un campo numerico a un modulo per raccogliere input numerici dagli utenti in una chat. L'input numerico viene quindi utilizzato dal flusso di lavoro agenziale. Ad esempio, gli utenti possono specificare gli ID dei biglietti, la quantità di articoli, il numero di giorni e altro in una chat.
Per aggiungere un campo numerico a un modulo:
Nella finestra di dialogo del modulo, fare clic su "Aggiungi campo" oppure sull'icona "
Aggiungi".Seleziona Raccogli dall'utente.
Selezionare il numero.
In Generale > Etichetta, inserire il testo di questo campo che viene visualizzato dall'utente in una chat.
Impostare l'interruttore Required su on per rendere obbligatoria la selezione di questo campo in una chat. Altrimenti, impostare l'interruttore su off.
In Tipo di input, specificare il tipo di numero intero o decimale.
In Aspetto, è possibile aggiungere il testo di aiuto per il campo numero. Impostare l'interruttore Testo ausiliario su on per aggiungere il testo ausiliario. Altrimenti, impostare l'interruttore su off.
In Behavior, è possibile specificare un valore iniziale per il numero utilizzando una variabile, un'espressione o le opzioni di mappatura automatica. Impostare l'interruttore Valore iniziale su on per aggiungere un valore iniziale. Altrimenti, impostare l'interruttore su off. Il valore iniziale viene utilizzato come valore predefinito nella chat e aiuta gli utenti a completare rapidamente un modulo. Gli utenti possono accettare o modificare questo valore.
Se si desidera specificare un valore particolare da utilizzare come valore iniziale, chiudere la mappatura automatica e inserire il valore.
Si può anche specificare un intervallo per il campo numerico, ad esempio un utente può scegliere un numero compreso tra 10 e 20. Per aggiungere un intervallo, impostare l'interruttore Intervallo di ingresso su on. Altrimenti, impostare l'interruttore su off. È possibile specificare il valore minimo e il valore massimo di un intervallo utilizzando una variabile, un'espressione o le opzioni di mappatura automatica. Per specificare un valore particolare da utilizzare come valore minimo o massimo, chiudere la mappatura automatica e inserire il valore.
Al modulo è stato aggiunto un campo numerico. L'esempio seguente mostra come viene visualizzato nella chat.

Scelta singola
È possibile aggiungere un campo a scelta singola a un modulo per raccogliere un'opzione da un elenco in una chat. L'opzione specificata dall'utente viene quindi utilizzata dal flusso di lavoro agenziale. Questo campo è utile per i flussi di lavoro agenziali in cui gli utenti possono selezionare una singola opzione in una chat, come ad esempio un reparto, un'organizzazione e altri.
Per aggiungere un campo a scelta singola a un modulo:
Nella finestra di dialogo del modulo, fare clic su "Aggiungi campo" oppure sull'icona "
Aggiungi".Seleziona Raccogli dall'utente.
Selezionare la scelta Singola.
In Generale > Etichetta, inserire il testo di questo campo che viene visualizzato dall'utente in una chat.
Impostare l'interruttore Required su on per rendere obbligatoria la selezione di questo campo in una chat. Altrimenti, impostare l'interruttore su off.
Nel campo " Variabile di origine " è possibile specificare un'origine per l'elenco utilizzando una variabile o un'espressione.
Se si specifica una variabile sorgente che è un elenco di oggetti, che definisce i dati, è possibile scegliere se visualizzare i dati come elenco a discesa o come tabella. Per scegliere un tipo di visualizzazione, in Aspetto > Visualizza come, seleziona Menu a tendina o Tabella.
Se selezioni l'opzione a discesa, specifica il nome di ciascuna voce dell'elenco in "Imposta il nome visualizzato per ciascuna voce dell'elenco utilizzando una variabile o un'espressione".
Se selezioni l'opzione Tabella, fai clic su Modifica colonne per configurare la modalità di visualizzazione delle colonne agli utenti. Quando si fa clic su "Modifica colonne ", si apre una finestra di dialogo dedicata in cui è possibile gestire gli elementi.
Nella sezione Modifica elementi è possibile:
Riorganizza gli elementi : trascina il
per modificare l'ordine di visualizzazione.Controlla la visibilità : clicca sull'icona Visibilità per nascondere singoli elementi.
Modifica delle etichette : modifica il testo nella colonna "Etichetta elemento" per personalizzare la visualizzazione di ciascun elemento agli utenti.
Metti in ordine le etichette : clicca su "Metti in ordine le etichette" per formattare automaticamente tutte le etichette.
Reimposta etichette : fare clic su "Reimposta etichette" per ripristinare tutti i valori delle etichette a quelli originali della variabile di origine.
Nell'opzione Testo segnaposto è possibile specificare il testo che viene visualizzato dall'utente quando l'elenco a discesa è vuoto.
In Aspetto, è possibile aggiungere un testo segnaposto che viene visualizzato da un utente in una chat quando l'elenco è vuoto.
In Comportamento, è possibile specificare un valore iniziale per l'elenco utilizzando una variabile, un'espressione o le opzioni di mappatura automatica. Il valore iniziale viene utilizzato come valore predefinito nella chat e aiuta gli utenti a completare rapidamente un modulo. Gli utenti possono accettare o modificare questo valore.
Se si desidera specificare un valore particolare da utilizzare come valore iniziale, chiudere la mappatura automatica e inserire il valore.
Al modulo è stato aggiunto un campo a scelta singola. L'esempio seguente mostra come viene visualizzato nella chat.

Testo
È possibile aggiungere un campo di testo a un modulo per raccogliere dati testuali da un utente in una chat. Il testo specificato dall'utente viene poi utilizzato dal flusso di lavoro agenziale. Ad esempio, gli utenti possono inserire risposte a commenti o feedback, descrizioni di problemi o attività e altro in una chat.
Per aggiungere un campo di testo a un modulo:
Nella finestra di dialogo del modulo, fare clic su "Aggiungi campo" oppure sull'icona "
Aggiungi".Seleziona Raccogli dall'utente.
Selezionare il testo.
In Generale > Etichetta, inserire il testo di questo campo che viene visualizzato dall'utente in una chat.
Impostare l'interruttore Required su on per rendere obbligatoria la selezione di questo campo in una chat. Altrimenti, impostare l'interruttore su off.
In Tipo di input, è possibile specificare il tipo di testo a riga singola o a più righe.
In Aspetto, è possibile aggiungere un testo segnaposto e un testo di aiuto per il campo di testo. Impostare l'interruttore Testo segnaposto su On per aggiungere un testo segnaposto e l'interruttore Testo di aiuto su On per aggiungere un testo di aiuto. Altrimenti, impostare l'interruttore su off.
In Comportamento, è possibile specificare un valore iniziale per il campo di testo utilizzando una variabile, un'espressione o le opzioni di mappatura automatica. Il valore iniziale viene utilizzato come valore predefinito nella chat e aiuta gli utenti a completare rapidamente un modulo. Gli utenti possono accettare o modificare questo valore.
Se si desidera specificare un valore iniziale particolare, chiudere la mappatura automatica e inserire il valore.
È possibile specificare un'espressione regolare (regex) per definire il formato consentito. Per specificare un'espressione regolare, attiva l'opzione di convalida Regex e inserisci l'espressione regolare. Il campo nel modulo accetta solo testo che corrisponda al modello da te definito. Nel campo " Messaggio di errore Regex " è possibile specificare il messaggio di errore per la convalida.
Per ulteriori informazioni sulla mappatura dei dati nei flussi di lavoro agenziali, vedere Mappatura dei dati.
Un campo di testo è stato aggiunto al modulo. L'esempio seguente mostra come viene visualizzato nella chat.

Mostrare all'utente
Per visualizzare le informazioni all'utente in un modulo, è possibile utilizzare uno dei seguenti tipi di dati:
Campo
È possibile aggiungere un campo a un modulo per visualizzare i dati agli utenti in una chat.
Per aggiungere un campo a un modulo:
Nella finestra di dialogo del modulo, fare clic su "Aggiungi campo" oppure sull'icona "
Aggiungi".Selezionare Presenta all'utente.
Selezionare il campo.
In Generale > Etichetta, inserire il testo del campo che viene visualizzato dall'utente in una chat.
In Generale > Origine, è possibile specificare l'origine dei dati utilizzando una variabile o un'espressione.
Elenco
È possibile aggiungere un elenco a un modulo per visualizzare più informazioni in un flusso di lavoro agenziale. Ad esempio, è possibile visualizzare priorità, stati e altre informazioni in una chat in modo organizzato per l'utente.
Per aggiungere un elenco a un modulo:
Nella finestra di dialogo del modulo, fare clic su "Aggiungi campo" oppure sull'icona "
Aggiungi".Selezionare Presenta all'utente.
Selezionare l' elenco.
In Generale > Seleziona l'origine dell'elenco di scelta, specificare un'origine per l'elenco utilizzando una variabile o un'espressione.
Se si specifica una variabile sorgente come oggetto array, che definisce i dati, si può scegliere di visualizzare i dati come tabella. È possibile personalizzare le colonne da visualizzare nell'elenco Colonne.
Per modificare le etichette delle colonne selezionate, fare clic su Modifica etichette colonne e specificare le etichette per ogni elemento. È anche possibile fare clic su Riordina etichette per formattare automaticamente le etichette.
Messaggio
È possibile aggiungere un messaggio a un modulo per visualizzare le informazioni in un flusso di lavoro agenziale. Ad esempio, è possibile visualizzare l'esito di un flusso di lavoro agenziale in una chat per aiutare gli utenti a comprendere il risultato.
Se desideri che le parentesi graffe appaiano come testo normale in un messaggio da visualizzare, sostituiscile con doppie parentesi graffe. Ad esempio, {{customer_id}} viene visualizzato come {customer_id} nel messaggio di output e il testo all'interno delle doppie parentesi graffe viene trattato come testo normale, non come variabile.
Per aggiungere un messaggio a un modulo:
Nella finestra di dialogo del modulo, fare clic su "Aggiungi campo" oppure sull'icona "
Aggiungi".Selezionare Presenta all'utente.
Selezionare il messaggio.
In Generale > Messaggio di uscita, inserire il messaggio. È anche possibile utilizzare una variabile nel messaggio.
File
È possibile aggiungere un campo file a un modulo per consentire agli utenti di scaricare il file generato in un flusso di lavoro agenziale. Ad esempio, gli utenti possono scaricare i rapporti o qualsiasi altro file in una chat.
Per aggiungere un campo per il download di file a un modulo:
Nella finestra di dialogo del modulo, fare clic su "Aggiungi campo" oppure sull'icona "
Aggiungi".Selezionare Presenta all'utente.
Selezionare Download di file.
In Generale > Etichetta, inserire il testo di questo campo che viene visualizzato dall'utente in una chat.
In Generale > File sorgente, è possibile specificare il file sorgente utilizzando una variabile o un'espressione.
Un flusso di lavoro agenziale definisce un insieme di attività e controlli collegati tra loro, progettati per raggiungere uno scopo o un obiettivo aziendale specifico. Scopri di più sul flusso di lavoro agentico.
Moduli dinamici
I moduli dinamici consentono a un unico modulo di adattarsi a diversi casi d'uso senza dover duplicare i campi o creare moduli separati. I campi reagiscono in modo dinamico alle interazioni dell'utente con il modulo e modificano il proprio comportamento in base ai dati inseriti. Anziché mostrare tutti i campi contemporaneamente, il modulo si aggiorna man mano che l'utente effettua le selezioni, in modo da visualizzare solo i campi, le etichette e i valori pertinenti.
Il comportamento dinamico viene definito utilizzando regole dinamiche. Le regole dinamiche vengono configurate visivamente nel generatore di flussi di lavoro e non richiedono l'uso di script o logiche personalizzate. Le regole si applicano all'interno di un modulo e determinano in che modo un campo influisce sul comportamento degli altri campi. I moduli dinamici adattano la raccolta dei dati in base alle informazioni fornite dall'utente, quali la località, la categoria, il ruolo o le risposte precedenti.
Un modulo può contenere più regole dinamiche. Un singolo campo può essere regolato da più di una regola, e ogni regola viene valutata in modo indipendente. Le regole dinamiche si applicano solo ai campi a valle. Il campo controllato deve trovarsi dopo il campo trigger. Questo ordine garantisce un comportamento prevedibile ed evita le dipendenze circolari.
È possibile inserire regole dinamiche tra i campi nella definizione del modulo e configurarle per gestire diversi tipi di regole, tra cui etichette dinamiche, visibilità e selezione progressiva. Il comportamento delle regole viene configurato tramite le proprietà delle regole.
I moduli dinamici supportano i seguenti tipi di regole:
Etichetta dinamica
Le regole dinamiche delle etichette controllano il testo dell'etichetta visualizzato per un campo condizionale. Queste regole consentono allo stesso campo di visualizzare testi diversi in base all'input dell'utente, supportando così una terminologia specifica per il contesto all'interno di un unico modulo.
Le regole dinamiche delle etichette consentono di definire più regole per lo stesso campo e ogni regola può includere più condizioni. Quando le condizioni sono soddisfatte, viene applicata l'etichetta definita nella regola. È inoltre possibile definire un'etichetta alternativa per i casi in cui le condizioni non sono soddisfatte.
Visibilità
Le regole di visibilità determinano se un campo condizionale viene visualizzato o nascosto in base al valore di un campo trigger. Queste regole servono a ridurre la complessità dei moduli, visualizzando i campi solo quando sono rilevanti.
Una regola di visibilità valuta una o più condizioni e determina lo stato di visibilità del campo condizionale. Le condizioni possono essere combinate all'interno di una singola regola, consentendo di definire il comportamento di visibilità per diversi scenari di input. Le regole di visibilità determinano solo se un campo viene visualizzato o meno e non modificano le etichette o i valori dei campi.
Selezione progressiva
Le regole di selezione progressiva determinano come vengono popolati i valori del menu a tendina per un campo condizionale. Queste regole recuperano i valori in modo dinamico eseguendo uno strumento quando il valore del campo di attivazione cambia.
Anziché utilizzare condizioni, le regole di selezione progressiva si basano sull'output di uno strumento selezionato. Lo strumento viene configurato nel generatore di flussi di lavoro e fornisce i valori che popolano il campo a discesa. Quando il campo di attivazione cambia, lo strumento viene eseguito nuovamente e le opzioni disponibili vengono aggiornate.
Aggiunta di regole dinamiche a un modulo
Per aggiungere regole dinamiche a un modulo:
Nella finestra di dialogo del modulo, fare clic su "Aggiungi campo" oppure sull'icona "
Aggiungi".Seleziona "Regole dinamiche ".
Seleziona un tipo di regola:
Etichetta dinamica
Visibilità
Selezione progressiva
Nelle proprietà della regola:
Inserisci un nome.
Seleziona un campo di attivazione evento.
Selezionare uno o più campi condizionali.
Al modulo viene aggiunta una regola dinamica. La regola è stata creata, ma non definisce ancora il comportamento.
Ogni regola dinamica è composta dalle seguenti proprietà:
Trigger evento
Il trigger dell'evento indica il campo la cui modifica del valore determina la valutazione della regola. Quando il valore del campo di attivazione dell'evento selezionato cambia, la regola viene eseguita e applica il proprio comportamento ai campi condizionali selezionati.
Una volta aggiunta e configurata una regola, la relazione viene riportata nel campo di attivazione. Le proprietà del campo di attivazione includono una sezione "Attivazioni evento" che elenca tutte le regole attivate da quel campo.
Per ogni voce elencata nella sezione "Trigger evento ", è possibile vedere quale campo condizionale è interessato e selezionare "Modifica regola " per aprire direttamente la configurazione della regola.
Questa funzionalità consente di controllare e modificare il comportamento delle regole direttamente dal campo di attivazione, senza dover aprire la regola dinamica nel modulo.
Campi condizionali
I campi condizionali sono campi a valle il cui comportamento è regolato da una regola dinamica. Questi campi vengono selezionati dall'elenco dei campi che compare nel modulo dopo il trigger dell'evento. Selezionando un campo tra i campi condizionali si specificano i campi che possono essere controllati dalla regola. La selezione di un campo condizionale non determina di per sé il comportamento; stabilisce solo la partecipazione del campo alla regola.
Campi condizionali selezionati
L'elenco dei campi condizionali selezionati mostra i campi attualmente associati alla regola. Ogni campo in questo elenco rappresenta un campo condizionale su cui la regola può agire. Per ogni campo condizionale selezionato è disponibile l'opzione "Aggiungi regola ". Selezionando "Aggiungi regola" si apre la finestra di configurazione specifica della regola, in cui è possibile definire il comportamento di quel campo, come le modifiche all'etichetta, le impostazioni di visibilità o la configurazione della fonte dei valori.
Configurazione delle regole dinamiche relative alle etichette e alla visibilità
Le regole dinamiche relative alle etichette e alla visibilità vengono configurate seguendo la stessa procedura. Entrambi i tipi di regola utilizzano delle condizioni per determinare il comportamento di un campo condizionale quando cambia il valore del campo di attivazione.
Per configurare un'etichetta dinamica o una regola di visibilità in un modulo:
Selezionare la regola dinamica per l 'etichetta dinamica o la regola di visibilità.
Nelle proprietà della regola, nella sezione Campi condizionali selezionati, seleziona Aggiungi regola.
Nelle impostazioni del campo "Condizionale":
Configurare la condizione predefinita nella sezione " If".
Per aggiungere altre condizioni, seleziona "Aggiungi condizione".
Configurare l'esito della regola:
Per una regola di etichettatura dinamica, specificare il testo dell'etichetta nella sezione "Then".
Per una regola di visibilità, specificare nella sezione "Then " se il campo deve essere visualizzato o nascosto.
Specificare il comportamento alternativo nella sezione "Else".
Fare clic su Salva.
Per le regole dinamiche delle etichette, selezionare nuovamente "Aggiungi regola" per definire un'altra regola per lo stesso campo.
Per le regole di visibilità, continua ad aggiungere condizioni all'interno della stessa regola selezionando " Aggiungi condizione ".
Configurazione della regola di selezione progressiva
Per configurare una regola di selezione progressiva in un modulo:
Seleziona la regola dinamica per la regola di selezione progressiva.
Nella regola di selezione progressiva, nella sezione «Campi condizionali selezionati», seleziona «Aggiungi regola ».
Nella configurazione del campo "Condizionale", fare clic su "Seleziona strumento" e scegliere uno strumento dall'elenco disponibile.
Se necessario, configurare gli input dello strumento.
Fare clic su Salva.