Panoramica dell'SDK Actions (Dialogflow)

Actions on Google ti consente di estendere la funzionalità dell'Assistente Google con Azioni: Le azioni consentono agli utenti di svolgere attività tramite un'interfaccia di conversazione che può includere un comando rapido per accendere alcune luci o un una conversazione, ad esempio un gioco di cultura generale.

L'SDK Actions è un metodo per sviluppare il completamento di una conversazione senza utilizzando Dialogflow. Quando utilizzi l'SDK Actions, puoi usare un pacchetto di azioni per gli intent della mappa al loro adempimento. Devi inoltre fornire pattern di query nel Pacchetto di azioni per definire frasi di esempio che gli utenti potrebbero pronunciare.

interfaccia a riga di comando gactions

Durante lo sviluppo con l'SDK Actions, utilizzi la riga di comando gactions (interfaccia a riga di comando) per testare e aggiornare il progetto Actions. L'interfaccia a riga di comando di gactions ti aiuta anche a creare e gestire il pacchetto Azioni per l'azione conversazionale.

Creare azioni nel pacchetto Azioni

Puoi creare azioni nel tuo pacchetto Azioni mappando gli intent al completamento. Un'azione definisce un punto di ingresso per avviare conversazioni con un un identificatore denominato intent. Gli intent vengono mappati ai fulfillment, che elaborano l'intento.

Ad esempio, supponi di voler creare un progetto che contenga Azioni per acquistare alcuni articoli, controllare lo stato degli ordini e mostrare alcune offerte del giorno. Puoi definire gli intent che vengono attivati dicendo:

• "Hey Google, parla con ExampleAction."
• "Hey Google, parla con ExampleAction per comprare delle scarpe."
• "Hey Google, parla con ExampleAction per controllare il mio ordine."
• "Hey Google, parla con ExampleAction per mostrarmi le offerte di oggi."

Il file JSON del pacchetto di azioni potrebbe avere un aspetto simile al seguente:

{
  "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 progetto, Actions on Google chiama il tuo completamento per avviare una conversazione con gli utenti al fine di completare l'Azione.

In ogni richiesta al webhook di fulfillment, ricevi l'input utente come stringa di testo. Per elaborare l'intent, in genere si analizzano l'input di testo e restituiscono una risposta. Questo scambio avviene finché l'azione termina la conversazione.

Carica il tuo pacchetto di azioni

Dopo aver creato il pacchetto di azioni e eseguito il deployment del relativo fulfillment, puoi caricare il pacchetto Action nella console Actions. La console Actions usa i progetti di azione per raggruppare l'azione conversazionale con metadati come la sua revisione e il nome visualizzato nella directory dell'assistente. Il progetto ti consente anche definire i metadati dell'azione, nonché gestire e monitorare l'azione tramite una procedura di approvazione.

Una volta creato un progetto, puoi caricare il pacchetto di azioni che definisce 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 per Node.js e Java.