Konversationsaktionen werden am 13. Juni 2023 eingestellt. Weitere Informationen finden Sie unter Einstellung von Konversationsaktionen.

Actions SDK: Übersicht (Dialogflow)

Mit Actions on Google können Sie die Funktionalität von Google Assistant um Actions erweitern. Mit Aktionen können Nutzer Aufgaben über eine Conversational Interface erledigen, die von einem kurzen Befehl reicht, um einige Lichter einzuschalten, oder von einer längeren Unterhaltung, wie etwa einem Quizspiel.

Das Actions SDK ist eine Methode zum Entwickeln einer Unterhaltungsausführung ohne Dialogflow. Bei Verwendung des Actions SDK verwenden Sie ein Aktionspaket, um Intents dem Fulfillment zuzuordnen. Außerdem müssen Sie Abfragemuster im Aktionspaket angeben, um Beispielausdrücke zu definieren, die Ihre Nutzer möglicherweise sagen.

CLIS CLI

Bei der Entwicklung mit dem Actions SDK verwenden Sie die gactions-Befehlszeile, um Ihr Actions-Projekt zu testen und zu aktualisieren. Mit der gactions-Befehlszeile können Sie auch das Aktionspaket für Ihre Konversationsaktion erstellen und verwalten.

Aktionen im Aktionspaket erstellen

Sie erstellen Aktionen in Ihrem Aktionspaket, indem Sie Intents der Auftragsausführung zuordnen. Eine Aktion definiert einen Einstiegspunkt zum Starten von Unterhaltungen mit einer eindeutigen Kennung, die als Intent bezeichnet wird. Intents werden Auftragsausführungen zugeordnet, die den Intent verarbeiten.

Angenommen, Sie möchten ein Projekt erstellen, das Aktionen enthält, mit denen Sie bestimmte Waren kaufen, den Status von Bestellungen prüfen und einige tägliche Deals aufrufen können. Sie können Intents definieren, die ausgelöst werden, indem Sie Folgendes sagen:

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

Die JSON-Datei mit dem Aktionspaket 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 die Auftragsausführung auf, um eine Unterhaltung mit den Nutzern zu beginnen.

In jeder Anfrage an den Webhook der Auftragsausführung erhalten Sie die Nutzereingabe als Textstring. Zur Verarbeitung des Intents parsen Sie die Texteingabe und geben eine Antwort zurück. Dieser Austausch steht so lange zur Verfügung, bis die Unterhaltung der Aktion endet.

Aktionspaket hochladen

Nachdem Sie das Aktionspaket erstellt und die Auftragsausführung bereitgestellt haben, können Sie Ihr Aktionspaket in die Actions Console hochladen. In der Aktionskonsole werden Aktionsprojekte verwendet, um Unterhaltungsaktionen mit Metadaten wie dem Überprüfungsstatus und dem Anzeigenamen im Assistant-Verzeichnis zu gruppieren. Mit dem Projekt können Sie auch Metadaten zu Ihrer Aktion definieren und durch den Genehmigungsprozess verwalten und verfolgen.

Sobald Sie ein Projekt erstellt haben, können Sie Ihr Aktionspaket hochladen, das alle Ihre Aktionen über die gactions-Befehlszeile definiert.

Projekt zur Genehmigung einreichen und Nutzern zur Verfügung stellen

Beispiele

Sehen Sie sich die Node.js- und Java SDK-Beispiele für abgeschlossene Projekte an.