Funzioni

Estimated reading: 4 minutes 114 views

Cosa sono le Funzioni e quando usarle

Le Funzioni di TVox sono uno strumento fondamentale per progettare workflow più ordinati, riutilizzabili e semplici da mantenere. Permettono di racchiudere logiche operative ricorrenti in una sotto‑mappa indipendente, richiamabile in più punti di uno o più servizi, riducendo la duplicazione dei blocchi e il rischio di errori.

Una Funzione è una porzione di mappa configurabile con variabili di input e output e con una o più uscite logiche, pensata per essere riutilizzata all’interno dei servizi workflow (WF). Il concetto è simile a quello delle funzioni nei linguaggi di programmazione: quando una funzione viene richiamata, TVox esegue i blocchi contenuti nella sua mappa e restituisce il controllo al workflow principale.

Le Funzioni sono ideali quando:

una stessa sequenza di controlli o operazioni logiche viene ripetuta in più punti della mappa;
vuoi semplificare la lettura del servizio WF rendendolo più compatto;
hai bisogno di standardizzare una logica comune tra più servizi.

Possono essere utilizzate sia nel canale telefonico sia nel canale chat.

Nota

Le Funzioni possono essere considerate il “fratello minore” degli agenti virtuali: condividono l’idea di riuso della logica, ma sono orientate all’elaborazione interna e non all’interazione diretta con l’utente.

Dove si creano le Funzioni

La creazione avviene dalla sezione Funzioni dell’OCC, all’interno della Gestione Servizi. Da qui puoi definire nuove Funzioni scegliendo:

il nome;
una descrizione (facoltativa ma consigliata);
il canale (telefonico o chat).

Dopo aver confermato i dati iniziali, accedi all’editor grafico per configurare la mappa della Funzione.

La mappa di una Funzione si costruisce in modo simile a quella di un servizio WF, con una differenza importante: alcuni blocchi tipici dei servizi non sono disponibili, perché specifici della gestione del canale (ad esempio ACD, Calendar, Out of Service).

All’interno di una Funzione assumono un ruolo centrale due blocchi:

Blocco Start: input e output

Il blocco Start definisce le variabili di input (parametri in ingresso) e le variabili di output (valori restituiti al workflow chiamante). Tutte le variabili esistono solo all’interno della Funzione e non sono più disponibili dopo un blocco End.

Blocchi End: le uscite logiche

I blocchi End rappresentano i possibili esiti della Funzione. In ciascun End puoi configurare un’etichetta di uscita, che diventerà una freccia disponibile nel blocco Function del servizio WF.

Il comportamento cambia in base a come vengono usati gli End:

con etichette definite: ogni etichetta corrisponde a una freccia distinta nel servizio, permettendo di gestire separatamente i diversi esiti;
senza etichette: dal blocco Function sarà disponibile una sola freccia non etichettata e qualunque esito interno seguirà quel percorso.

Utilizzo di una Funzione nel workflow

Una volta creata, la Funzione può essere richiamata all’interno di un servizio WF tramite il blocco Function. Questo blocco agisce come una vera e propria chiamata a sotto‑mappa:

le frecce entranti “entrano” nella Funzione;
al raggiungimento di un blocco End, il flusso ritorna al servizio principale.

Importante

Nel blocco Function l’unico campo configurabile è la Funzione da selezionare. Dopo l’impostazione, il blocco viene bloccato e non può più essere modificato: per cambiare Funzione è necessario eliminare il blocco e crearne uno nuovo.

Vincoli e best practices

Le Funzioni sono soggette a vincoli precisi per garantire la stabilità dei servizi:

se una Funzione è utilizzata da almeno un servizio, non è possibile modificare:
- le variabili di input/output;
- le etichette dei blocchi End.

Questo evita effetti collaterali sui servizi già in produzione.

Strategia consigliata per modifica Function

Se devi cambiare una Funzione già in uso:

crea una copia della Funzione;
applica le modifiche sulla copia;
aggiorna i servizi sostituendo il blocco Function con uno che utilizza la nuova Funzione.

In questo modo, le interazioni già in corso continuano a usare la vecchia Funzione, mentre le nuove sfruttano quella aggiornata.

Importazione dei servizi con Funzioni

Quando importi un servizio WF che utilizza una Funzione:

la Funzione viene importata automaticamente solo se non è già presente nel sistema;
se esiste già una Funzione con lo stesso nome, non viene sovrascritta.

Questo comportamento protegge le configurazioni esistenti ed evita conflitti tra ambienti.

Differenza tra Funzioni e agenti virtuali

Pur condividendo la logica di riuso, le Funzioni si distinguono dagli agenti virtuali per alcuni aspetti chiave:

non includono blocchi di interazione come Interactive Reply o ASR;
sono orientate a logica ed elaborazione, non alla conversazione;
non raccolgono input direttamente dall’utente finale.

Per questo motivo, le Funzioni sono ideali per controlli, calcoli, verifiche su database e decisioni di flusso interne al servizio.

Funzioni

Cosa sono le Funzioni e quando usarle

Nota