Modelli di chiamata alla build

Un modello di chiamata specifica in che modo gli utenti richiamano le azioni nel progetto. Quando gli utenti richiamano un'azione, iniziano una conversazione con l'azione, che è definita dal tuo modello di conversazione. Puoi definire le chiamate nei seguenti modi:

  • Chiamata principale: questa è l'unica chiamata obbligatoria per il tuo progetto Actions. Gli utenti usano una frase simile a "Hey Google, parla con <nome visualizzato>" per soddisfare questo intent, che in genere viene gestito salutando l'utente con un messaggio di benvenuto.

  • Chiamate di link diretti: si tratta di chiamate facoltative che consentono di definire frasi di addestramento in un intent personalizzato, in modo che gli utenti possano collegarsi a una parte specifica della conversazione. Gli utenti possono pronunciare una frase simile a "Hey Google, parla con <nome visualizzato> con <frase link diretto>" per creare una corrispondenza con questi tipi di intent (ad esempio "Hey Google, parla con Fatti su Google per ottenere dati aziendali")

  • Intent integrati: si tratta di chiamate facoltative che consentono di sfruttare i modelli di chiamata definiti dal sistema. Dichiarando il supporto per un intent integrato, gli utenti possono scoprire e richiamare il tuo progetto Actions senza dover specificare il nome visualizzato. Ad esempio, gli utenti possono dire "Hey Google, gioca" e l'Assistente Google può presentare l'Azione come opzione di chiamata.

Figura 1. Un modello di chiamata è costituito da tutti gli intent idonei ad avviare conversazioni con le tue azioni.

Crea la chiamata principale

Ogni progetto di Actions ha una chiamata principale predefinita che funge da punto di ingresso predefinito nel progetto Actions.Il modello linguistico di questa chiamata è associato al nome visualizzato del progetto, quindi gli utenti devono solo pronunciare una frase simile a "Ok Google, parla con <nome visualizzazione>" per utilizzare questa chiamata. Quando gli utenti richiamano le tue azioni in questo modo, il runtime dell'assistente corrisponde all'intent di sistema actions.intent.MAIN.

Per creare la chiamata principale:

Per creare chiamate di link diretti, crea intent utente globali con frasi di addestramento che definiscono l'input utente da impostare per il link diretto. Gli utenti pronunciano il tuo nome visualizzato in combinazione con la frase del link diretto per eseguire la chiamata di un link diretto (ad esempio, "Hey Google, parla con <nome visualizzazione> con <frase del link diretto>").

Crea chiamate implicite

La chiamata implicita consente agli utenti di richiamare l'azione senza utilizzare il nome visualizzato del progetto. Per trovare le azioni corrispondenti, Google utilizza indicatori come gli utenti che dicono all'assistente di fare qualcosa di simile a una frase di chiamata per uno degli intent configurati o quando l'utente si trova in un contesto in cui le tue azioni sarebbero appropriate.

Gestire gli eventi di chiamata

Quando l'assistente corrisponde a uno dei tuoi intent globali, attiva un evento che puoi elaborare con un gestore. Le seguenti sezioni descrivono ciò che il gestore può eseguire (puoi scegliere una delle tre opzioni o una qualsiasi combinazione di entrambe).

Attiva un webhook

Il gestore di intent può delegare a un servizio web attivando un evento webhook. Per attivare un webhook e fare in modo che un servizio web gestisca la chiamata:

Prompt

Il gestore di intent può rispondere con un prompt statico. In genere, i prompt per gli intent di chiamata accolgono l'utente, li orientano su come utilizzare l'azione o rispondono con le informazioni di cui l'utente ha bisogno immediatamente (azioni one-shot).

Per gestire la corrispondenza di un intent di chiamata con un prompt:

Passaggio a una scena

Il gestore di intent può passare a una scena per elaborare l'intent di chiamata corrispondente. Questo ti offre la massima flessibilità per applicare la logica. Per passare a una scena: