Actions SDK – Übersicht (Dialogflow)

Mit Actions on Google können Sie die Funktionen von Google Assistant um Aktionen: Mit Aktionen können Nutzer Aufgaben über eine dialogorientierte Schnittstelle erledigen Das kann ein schneller Befehl sein, um manche Lampen einzuschalten, oder eine längere z. B. ein Quiz spielen.

Das Actions SDK ist eine Methode zur Entwicklung der Gesprächserfüllung, mit Dialogflow. Wenn Sie das Actions SDK nutzen, Intents ihrer Auftragsausführung zuordnen. Außerdem müssen Sie Abfragemuster im Aktionspaket zum Definieren von Beispielformulierungen, die deine Nutzer sagen könnten.

gactions-Befehlszeile

Bei der Entwicklung mit dem Actions SDK verwenden Sie die gactions-Befehlszeile um Ihr Actions-Projekt zu testen und zu aktualisieren. Die gactions-Befehlszeile hilft dir auch dabei, das Aktionspaket für deine Konversationsaktion zu erstellen und zu verwalten.

Aktionen im Aktionspaket erstellen

Sie erstellen Aktionen in Ihrem Aktionspaket, indem Sie Intents der Auftragsausführung zuordnen. Eine Aktion definiert einen Einstiegspunkt, um Unterhaltungen mit einer eindeutigen Kennung, die als Intent bezeichnet wird. Intents sind Ausführungen zugeordnet, die die Nutzerabsicht verstehen.

Angenommen, Sie möchten ein Projekt erstellen, das Aktionen für um Waren zu kaufen, den Bestellstatus zu prüfen und Tagesangebote anzuzeigen. Sie können Intents definieren, die ausgelöst werden, indem Sie Folgendes sagen:

  • „Hey Google, sprich mit ExampleAction.“
  • „Hey Google, sprich mit ExampleAction, um Schuhe zu kaufen.“
  • „Hey Google, sprich mit ExampleAction, um meine Bestellung zu prüfen.“
  • „Hey Google, sprich mit ExampleAction, um mir die heutigen Angebote zu zeigen.“

Die JSON-Datei des Aktionspakets könnte etwa so aussehen:

{
  "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"
    }
  }
}

Auftragsausführungs-Webhook erstellen und bereitstellen

Wenn eine Aktion in Ihrem Projekt aufgerufen wird, ruft Actions on Google Ihre Fulfillment, um eine Unterhaltung mit Nutzern zu beginnen, um die Aktion auszuführen.

In jeder Anfrage an den Auftragsausführungs-Webhook erhalten Sie die Nutzereingabe als Textzeichenfolge. Zur Verarbeitung des Intents parsen Sie in der Regel die Texteingabe und eine Antwort zurückgeben. Dieser Austausch findet statt, bis deine Aktion Unterhaltung endet.

Aktionspaket hochladen

Sobald Sie das Aktionspaket erstellt und die Auftragsausführung bereitgestellt haben: kannst du dein Aktionspaket in die Actions Console hochladen. In der Actions Console nutzt Action-Projekte, um deine Conversational Action mit Metadaten wie der Überprüfung zu gruppieren Status und Anzeigename im Assistant-Verzeichnis. Das Projekt bietet Ihnen auch die Möglichkeit, Metadaten zu deiner Aktion definieren und sie über die Genehmigungsprozess.

Sobald Sie ein Projekt haben, können Sie Ihr Aktionspaket hochladen, das alle Aktionen mithilfe der gactions-Befehlszeile ausführen.

Ihr Projekt zur Genehmigung einreichen und es den Nutzenden zur Verfügung stellen

Beispiele

Abgeschlossene Projekte finden Sie in den Actions SDK-Beispielen für Node.js und Java.