Concetti e definizioni di comandi personalizzati

Articolo
01/19/2024

Importante

I comandi personalizzati verranno ritirati il 30 aprile 2026. A partire dal 30 ottobre 2023 non è possibile creare nuove applicazioni comandi personalizzati in Speech Studio. In relazione a questa modifica, LUIS verrà ritirato il 1° ottobre 2025. A partire dal 1° aprile 2023 non è possibile creare nuove risorse LUIS.

Questo articolo funge da riferimento per concetti e definizioni per le applicazioni comandi personalizzati.

Configurazione dei comandi

I comandi sono i blocchi predefiniti di base di un'applicazione Comandi personalizzati. Un comando è un set di configurazioni necessarie per completare un'attività specifica definita da un utente.

Frasi di esempio

Le espressioni di esempio sono gli esempi di set che l'utente può dire di attivare un comando specifico. È necessario fornire solo un esempio di espressioni e non un elenco completo.

Parametri

I parametri sono informazioni richieste dai comandi per completare un'attività. In scenari complessi, i parametri possono essere usati anche per definire condizioni che attivano azioni personalizzate.

Regole di completamento

Le regole di completamento sono una serie di regole da eseguire dopo che il comando è pronto per essere soddisfatto, ad esempio quando vengono soddisfatte tutte le condizioni delle regole.

Regole di interazione

Le regole di interazione sono regole aggiuntive per gestire situazioni più specifiche o complesse. È possibile aggiungere altre convalide o configurare funzionalità avanzate, ad esempio le conferme o una correzione in un unico passaggio. È anche possibile creare regole di interazione personalizzate.

Configurazione dei parametri

Nome

Un parametro viene identificato dalla proprietà name. È sempre necessario assegnare un nome descrittivo a un parametro. È possibile fare riferimento a un parametro in sezioni diverse, ad esempio quando si creano condizioni, risposte vocali o altre azioni.

Richiesto

Questa casella di controllo indica se è necessario un valore per questo parametro per l'evasione o il completamento dei comandi. È necessario configurare le risposte per richiedere all'utente di specificare un valore se un parametro è contrassegnato come obbligatorio.

Se è stato configurato un parametro obbligatorio per avere un valore predefinito, il sistema richiede comunque il valore del parametro.

Type

I comandi personalizzati supportano i tipi di parametro seguenti:

Età
Valuta
Data/Ora
Dimensione
E-mail
Geografia
Numero
Ordinale
Percentuale
PersonName
PhoneNumber
String
Temperatura
Url

Tutte le impostazioni locali supportano il tipo di parametro "String", ma la disponibilità di tutti gli altri tipi è diversa dalle impostazioni locali. I comandi personalizzati usano la risoluzione predefinita delle entità di LUIS, pertanto la disponibilità di un tipo di parametro in un'impostazione locale dipende dal supporto entità predefinita di LUIS in tali impostazioni locali. Sono disponibili altri dettagli sul supporto entità predefinita di LUIS per impostazioni locali. Le entità LUIS personalizzate (ad esempio le entità machine learning) non sono attualmente supportate.

Alcuni tipi di parametro, ad esempio Number, String e DateTime supportano la configurazione del valore predefinito, che è possibile configurare dal portale.

Impostazione

Configuration è una proprietà di parametro definita solo per il tipo String. Sono supportati i valori seguenti:

Nessuno.
Accetta l'input completo: se abilitato, un parametro accetta qualsiasi espressione di input. Questa opzione è utile quando l'utente necessita di un parametro con l'espressione completa. Un esempio è costituito da indirizzi postali.
Accettare valori di input predefiniti da un catalogo esterno: questo valore viene usato per configurare un parametro che può presupporre un'ampia gamma di valori. Un esempio è un catalogo vendite. In questo caso, il catalogo è ospitato in un endpoint Web esterno e può essere configurato in modo indipendente.
Accettare valori di input predefiniti dal catalogo interno: questo valore viene usato per configurare un parametro che può presupporre alcuni valori. In questo caso, i valori devono essere configurati in Speech Studio.

Convalida

Le convalide sono costrutti applicabili a determinati tipi di parametro che consentono di configurare vincoli sul valore di un parametro. Attualmente, i comandi personalizzati supportano le convalide nei tipi di parametro seguenti:

Data/Ora
Numero

Configurazione delle regole

Una regola in Comandi personalizzati viene definita da un set di condizioni che, quando soddisfatte, eseguono un set di azioni. Le regole consentono anche di configurare lo stato di post-esecuzione e le aspettative per il turno successivo.

Tipi

I comandi personalizzati supportano le categorie di regole seguenti:

Regole di completamento: queste regole devono essere eseguite al momento dell'evasione dei comandi. Verranno eseguite tutte le regole configurate in questa sezione per cui le condizioni sono vere.
Regole di interazione: queste regole possono essere usate per configurare convalide, conferme e correzioni in un unico passaggio oppure per eseguire qualsiasi altra logica di dialogo personalizzata. Le regole di interazione vengono valutate a ogni turno nell'elaborazione e possono essere usate per attivare le regole di completamento.

Le diverse azioni configurate come parte di una regola vengono eseguite nell'ordine in cui vengono visualizzate nel portale di creazione.

Condizioni

Le condizioni sono i requisiti che devono essere soddisfatti per l'esecuzione di una regola. Le condizioni delle regole possono essere dei tipi seguenti:

Il valore del parametro è uguale a: il valore del parametro configurato è uguale a un valore specifico.
Nessun valore di parametro: i parametri configurati non devono avere alcun valore.
Parametri obbligatori: il parametro configurato ha un valore.
Tutti i parametri obbligatori: tutti i parametri contrassegnati come obbligatori hanno un valore.
Parametri aggiornati: uno o più valori di parametro sono stati aggiornati in seguito all'elaborazione dell'input corrente (espressione o attività).
Conferma riuscita: l'espressione o l'attività di input ha avuto esito positivo (sì).
Conferma negata: l'espressione di input o l'attività non ha avuto esito positivo (no).
Il comando precedente deve essere aggiornato: questa condizione viene usata nelle istanze quando si vuole rilevare una conferma negata insieme a un aggiornamento. In background, questa condizione viene configurata per quando il motore della finestra di dialogo rileva una conferma negativa in cui la finalità è la stessa del turno precedente e l'utente ha risposto con un aggiornamento.

Azioni

Inviare la risposta vocale: inviare una risposta vocale al client.
Aggiornare il valore del parametro: aggiornare il valore di un parametro di comando a un valore specificato.
Cancella il valore del parametro: cancella il valore del parametro del comando.
Chiamare l'endpoint Web: effettuare una chiamata a un endpoint Web.
Inviare attività al client: inviare un'attività personalizzata al client.

Aspettative

Le aspettative vengono usate per configurare i suggerimenti per l'elaborazione dell'input utente successivo. Sono supportati i tipi seguenti:

Attesa di conferma da parte dell'utente: questa aspettativa specifica che l'applicazione prevede una conferma (sì/no) per l'input utente successivo.
Previsto input di parametri da parte dell'utente: questa aspettativa specifica uno o più parametri di comando che l'applicazione prevede dall'input dell'utente.

Stato post-esecuzione

Lo stato post-esecuzione è lo stato del dialogo dopo l'elaborazione dell'input corrente (espressione o attività). Sono dei tipi seguenti:

Mantieni lo stato corrente: mantieni solo lo stato corrente.
Completare il comando: completare il comando e non vengono elaborate altre regole del comando.
Eseguire le regole di completamento: eseguire tutte le regole di completamento valide.
Attendere l'input dell'utente: attendere l'input dell'utente successivo.

Passaggi successivi

Vedere esempi in GitHub