Gli intent sono oggetti di messaggistica che descrivono come fare qualcosa. Puoi utilizzare gli intent in uno dei due seguenti modi:
- Fornendo il fulfillment per un intent,
- Richiedendo l'adempimento di un intent da parte dell'Assistente Google.
Il processo con cui fornisci il fulfillment per un intent è diverso per gli sviluppatori che creano con Dialogflow e per gli sviluppatori che creano con l'SDK Actions. Tuttavia, in entrambi i casi, fornisci il nome dell'intent e l'URL del webhook di fulfillment. Questo indica ad Actions on Google che puoi supportare le query degli utenti che corrispondono all'intento.
Per richiedere il completamento di un intent, devi specificare l'intent nell'oggetto possibleIntents quando rispondi all'assistente. Nella richiesta successiva al tuo adempimento, l'assistente ti restituisce il risultato dell'intent elaborato. Per ulteriori informazioni, leggi la panoramica dell'utilizzo degli assistenti.
Intent comuni
La tabella seguente descrive gli intent che l'assistente richiede da soddisfare.
| Nome intent | Utilizzo | Evento Dialogflow |
|---|---|---|
actions.intent.MAIN |
Obbligatorio: ogni pacchetto di azioni dichiara un solo intent che funge da punto di ingresso per consentire agli utenti di avviare conversazioni. | WELCOME o GOOGLE_ASSISTANT_WELCOME |
actions.intent.TEXT |
Ottieni una rappresentazione testuale della richiesta di un utente. La utilizzi la maggior parte delle volte quando interagisci in una conversazione con gli utenti. | |
actions.intent.CANCEL |
Ricevi questo intent quando attivi la ricezione di intent di annullamento nel pacchetto azioni. Quando gli utenti pronunciano un comando di annullamento globale come "quit", ricevi questo intent nella richiesta successiva al fulfillment, in modo da poter rispondere con un messaggio finale ed eseguire eventuali operazioni di pulizia nella logica di fulfillment. | actions_intent_CANCEL |
actions.intent.NO_INPUT |
Ricevi questo intent quando attivi la ricezione di intent senza input nel pacchetto azioni. Quando gli utenti non rispondono a una richiesta, ricevi questo intent nella richiesta successiva all'evasione dell'ordine. | actions_intent_NO_INPUT |
Supporto
La seguente tabella descrive gli helper supportati che puoi richiedere all'assistente di soddisfare.
| Nome intent | Utilizzo | Evento Dialogflow |
|---|---|---|
actions.intent.PERMISSION |
Ottieni nome completo, posizione approssimativa, posizione esatta o tutti e tre l'utente. | actions_intent_PERMISSION |
actions.intent.OPTION |
Ricevi l'elemento selezionato da un'interfaccia utente di elenco o carosello. In alternativa, se l'utente non seleziona una voce dall'elenco o dall'interfaccia utente del carosello, riceverà un input vocale o di testo corrispondente alla chiave nell'interfaccia utente del carosello o dell'elenco. | actions_intent_OPTION |
actions.intent.DATETIME |
Ottieni dall'utente un input di data e ora. | actions_intent_DATETIME |
actions.intent.SIGN_IN |
Richiede un flusso di collegamento degli account per collegare l'account di un utente. | actions_intent_SIGN_IN |
actions.intent.PLACE |
Ottieni un indirizzo o una posizione salvata dall'utente. | actions_intent_PLACE |
actions.intent.CONFIRMATION |
Ottenere una conferma dall'utente (ad esempio, una risposta a una domanda con sì o no). | actions_intent_CONFIRMATION |
actions.intent.NEW_SURFACE |
Chiede all'utente l'autorizzazione per passare a un'altra piattaforma dell'assistente. | actions_intent_NEW_SURFACE |
Intent integrati
Gli intent integrati modellano alcuni dei modi comuni in cui gli utenti esprimono le attività che stanno cercando di svolgere o le informazioni che cercano, ad esempio ordinare un pasto, prenotare una corsa o controllare il saldo dell'account. Per ulteriori informazioni, consulta la documentazione di riferimento per gli intent integrati.
Altri intent
La maggior parte delle azioni conversazionali è realizzata con una combinazione di intent, assistenti e risposte comuni. Tuttavia, le azioni che incorporano funzionalità aggiuntive come transazioni o aggiornamenti giornalieri hanno accesso agli intent specifici di queste funzionalità.
Supporti per le transazioni
La tabella seguente descrive gli aiuti relativi alla gestione degli acquisti che puoi richiedere all'assistente di eseguire. Puoi trovare ulteriori informazioni su come implementare questi e altri intent correlati nella documentazione relativa alla funzionalità Transazioni.
| Nome intent | Utilizzo | Evento Dialogflow |
|---|---|---|
actions.intent.DELIVERY_ADDRESS |
Ottieni dall'utente un indirizzo di consegna. | actions_intent_DELIVERY_ADDRESS |
actions.intent.TRANSACTION_REQUIREMENTS_CHECK |
Verificare che tutti i requisiti di una transazione siano soddisfatti. | actions_intent_TRANSACTION_REQUIREMENTS_CHECK |
actions.intent.TRANSACTION_DECISION |
Chiede all'utente se deve avvenire la transazione. | actions_intent_TRANSACTION_DECISION |
actions.intent.DIGITAL_PURCHASE_CHECK |
Convalida la configurazione della transazione dell'utente. Utilizzato per evitare di offrire beni digitali agli utenti per i quali la transazione non andrà a buon fine. | actions_intent_DIGITAL_PURCHASE_CHECK |
actions.intent.COMPLETE_PURCHASE |
Avvia una richiesta di acquisto. Genera un risultato di acquisto che descrive se e come la transazione è riuscita o meno. | actions_intent_COMPLETE_PURCHASE |
Intenzioni di coinvolgimento degli utenti
La seguente tabella descrive gli intent relativi alle funzionalità di coinvolgimento degli utenti. Puoi trovare ulteriori informazioni su come implementare questi e altri intent correlati nella documentazione relativa alla funzionalità di coinvolgimento degli utenti.
| Nome intent | Fornisci il fulfillment | Evasione della richiesta | Utilizzo | Evento Dialogflow |
|---|---|---|---|---|
actions.intent.REGISTER_UPDATE |
X | Chiede all'utente di registrarsi per gli aggiornamenti. | actions_intent_REGISTER_UPDATE |
|
actions.intent.CONFIGURE_UPDATES |
X | Ricevi questo intent quando l'utente prova a registrarsi per gli aggiornamenti (ovvero, deve essere inviato un intent REGISTER_UPDATE). | actions_intent_CONFIGURE_UPDATES |
Segmenti di pubblico personalizzati per intenzione
Puoi creare i tuoi intent per definire scorciatoie nella conversazione e aiutare gli utenti a svolgere le attività in modo più efficiente. Questi intent risiedono nel tuo spazio dei nomi; sei tu a definire il modo in cui gli utenti attivano gli intent e il tuo pacchetto Azioni è l'unico che li supporta.
Per maggiori informazioni, consulta la pagina sulla definizione delle azioni in Dialogflow o con l'SDK Actions. Puoi trovare ulteriori informazioni sui pacchetti di azioni nella documentazione di riferimento al pacchetto azioni.
Intent per smart home
Se stai creando un'azione per la smart home, definisci il supporto per gli intent in modo leggermente diverso. Per ulteriori informazioni, consulta la documentazione sugli intent per la smart home.