Actions on Google ti consente di estendere le funzionalità dell'Assistente Google con Azioni. Le azioni consentono agli utenti di svolgere attività attraverso un'interfaccia di conversazione, che può essere un comando rapido per accendere alcune luci o una conversazione più lunga, come il gioco a quiz.
L'SDK Actions è un metodo per sviluppare l'evasione delle conversazioni senza utilizzare Dialogflow. Quando utilizzi l'SDK Actions, utilizzi un pacchetto Action per mappare gli intent alla loro distribuzione. Devi inoltre fornire pattern di query nel pacchetto azioni per definire le frasi di esempio che gli utenti potrebbero pronunciare.
interfaccia a riga di comando gactions
Durante lo sviluppo con l'SDK Actions, utilizzi l'interfaccia a riga di comando (CLI) gactions per testare e aggiornare il progetto Actions. L'interfaccia a riga di comando gactions consente anche di creare e gestire il pacchetto Azione per l'azione di conversazione.
Crea azioni nel pacchetto Azioni
Puoi creare azioni nel tuo pacchetto azioni mappando gli intent al fulfillment. Un'azione definisce un punto di ingresso per avviare conversazioni con un identificatore univoco denominato intent. Gli intent vengono mappati ai fulfillment, che elaborano l'intent.
Ad esempio, supponi di voler creare un progetto contenente azioni per acquistare alcuni prodotti, verificare lo stato degli ordini e mostrare alcune offerte giornaliere. Puoi definire gli intent che vengono attivati dicendo:
- "Hey Google, parla con ExampleAction."
- "Hey Google, parla di ExampleAction per acquistare alcune scarpe."
- "Hey Google, parla con ExampleAction per controllare il mio ordine."
- "Hey Google, parla di ExampleAction per mostrarmi le offerte di oggi."
Il file JSON del pacchetto azioni potrebbe avere il seguente aspetto:
{
"actions": [
{
"name": "MAIN",
"intent": {
"name": "actions.intent.MAIN"
},
"fulfillment": {
"conversationName": "ExampleAction"
}
},
{
"name": "BUY",
"intent": {
"name": "com.example.ExampleAction.BUY",
"parameters": [{
"name": "color",
"type": "org.schema.type.Color"
}],
"trigger": {
"queryPatterns": [
"find some $org.schema.type.Color:color sneakers",
"buy some blue suede shoes",
"get running shoes"
]
}
},
"fulfillment": {
"conversationName": "ExampleAction"
}
},
{
"name": "ORDER_STATUS",
"intent": {
"name": "com.example.ExampleAction.ORDER_STATUS",
"trigger": {
"queryPatterns": [
"check on my order",
"see order updates",
"check where my order is"
]
}
},
"fulfillment": {
"conversationName": "ExampleAction"
}
},
{
"name": "DAILY_DEALS",
"intent": {
"name": "com.example.ExampleAction.DAILY_DEALS",
"trigger": {
"queryPatterns": [
"hear about daily deals",
"buying some daily deals",
"get today's deals"
]
}
},
"fulfillment": {
"conversationName": "ExampleAction"
}
}
],
"conversations": {
"ExampleAction": {
"name": "ExampleAction",
"url": "https://www.example.com/ExampleAction"
}
}
}
Crea ed esegui il deployment di un webhook di fulfillment
Quando viene richiamata un'azione nel tuo progetto, le azioni su Google chiama il tuo evasione per avviare una conversazione con gli utenti per completare l'azione.
In ogni richiesta al webhook di evasione degli ordini, ricevi l'input dell'utente come stringa di testo. Per elaborare l'intent, in genere si analizza l'input di testo e si restituisce una risposta. Questo scambio avviene fino al termine della conversazione relativa all'azione.
Carica il pacchetto azioni
Dopo aver creato il pacchetto azioni ed eseguito il deployment del relativo pacchetto, puoi caricarlo nella console di Actions. La console di Actions utilizza i progetti Actions per raggruppare l'Azione di conversazione con i metadati, ad esempio lo stato di revisione e il nome visualizzato nella directory dell'assistente. Il progetto ti consente inoltre di definire i metadati della tua azione e gestire e monitorare l'azione durante il processo di approvazione.
Una volta creato un progetto, puoi caricare il pacchetto di azioni che definisce tutte le azioni utilizzando l'interfaccia a riga di comando di gactions.
Inviare il progetto per l'approvazione e renderlo disponibile agli utenti
Esempi
Per esplorare i progetti completati, visualizza gli esempi di SDK Actions di Node.js e Java.