gactions-Befehlszeile (Dialogflow)

gactions ist die Befehlszeilenschnittstelle, mit der Sie Ihr Actions-Projekt testen und aktualisieren.

Systemarchitektur

Um den richtigen Download auszuwählen, müssen Sie Ihre Systemarchitektur ermitteln.

  • Auf Mac OS X- und Linux-Geräten können Sie die CPU-Architektur Ihres Computers mit dem Terminalbefehl uname -a abrufen.

  • So findest du auf Windows 10-Geräten die CPU-Architektur:

    1. Öffne die Einstellungen.

    2. Klicken Sie auf System.

    3. Klicke auf Kanalinfo.

Downloads

Sie können gactions für Ihr Betriebssystem herunterladen (unten).

Betriebssystem Downloads
Windows
Mac
Linux

Voraussetzungen

  • Machen Sie die heruntergeladene Datei ausführbar, indem Sie die entsprechenden Berechtigungen festlegen.
    • Unter Mac und Linux führen Sie chmod +x gactions aus, um die Binärdatei ausführbar zu machen.
    • Unter Windows benötigen Sie Administratorrechte.
  • Der Downloadpfad für gactions muss sich in der Umgebungsvariablen PATH befinden.

Unterstützte Argumente

In der folgenden Tabelle werden die unterstützten Argumente für gactions beschrieben:

Argument Beschreibung
help, h Gibt den Hilfetext für dieses Tool aus. Beispiel: 
gactions help

Verwenden Sie die folgende Syntax, um den Hilfetext für ein bestimmtes Argument aufzurufen:

gactions help argument

Beispiel:

gactions help test
get Ruft den Inhalt des angegebenen Projekts ab (Aktionen + Metadaten). Verwenden Sie die folgende Syntax: 
gactions get --project PROJECT_ID
init Erstellt im aktuellen Verzeichnis eine action.json-Standarddatei mit der folgenden Syntax: 
gactions init

Wenn bereits eine action.json-Datei vorhanden ist, können Sie sie überschreiben, indem Sie das Argument --force wie im folgenden Beispiel hinzufügen:

gactions init --force
list Listet bis zu 10 aktuelle Versionen Ihres Actions-Projekts auf, z. B. in „Wird geprüft“, „Produktion“, „Genehmigt“ usw. mit der folgenden Syntax: 
gactions list --project PROJECT_ID
test Sendet ein Aktionspaket mit der folgenden Syntax an die Assistant-Plattform: 
gactions test --action_package PACKAGE_NAME --project PROJECT_ID

Beispiel:

gactions test --action_package mypackage.json --project my-project-1234567

Optional können Sie Tests in der Sandbox-Umgebung mit dem Flag
--disable_sandbox deaktivieren.

Das Flag --preview_mins wurde verworfen.
update Aktualisiert das Aktionspaket für das angegebene Projekt mit der folgenden Syntax: 
gactions update --action_package PACKAGE_NAME --project PROJECT_ID

Beispiel:

gactions update --action_package action.json --project my-project-1234567

Um das Argument update zu verwenden, müssen Sie die Projekt-ID Ihrer Aktion verwenden. Sie können Ihre Projekt-ID abrufen, indem Sie in Ihrem Actions on Google-Projekt auf das Zahnradsymbol und dann auf Projekteinstellungen klicken.

Wenn dein Actions-Projekt mehrere Sprachen unterstützt, findest du weitere Informationen in der Dokumentation zum Aktionspaket.
selfupdate gactions prüft vor jedem Befehl automatisch, ob Updates verfügbar sind. Sie können diese Prüfung jedoch mit selfupdate 
gactions selfupdate
erzwingen.

Ausführliche Ausgabe ansehen

Fügen Sie das Flag --verbose hinzu, um während der Verarbeitung eine detailliertere Ausgabe zu sehen. Beispiel:

gactions --verbose test --action_package action.json --project my-project-1234567

Beispiel für die Standardaktion „action.json“

Wenn Sie gactions init in Ihrem Projektverzeichnis ausführen, generieren Sie in diesem Verzeichnis eine action.json-Standarddatei:

{
  "actions": [
    {
      "description": "Default Welcome Intent",
      "name": "MAIN",
      "fulfillment": {
        "conversationName": "<INSERT YOUR CONVERSATION NAME HERE>"
      },
      "intent": {
        "name": "actions.intent.MAIN",
        "trigger": {
          "queryPatterns": [
            "talk to <INSERT YOUR NAME HERE>"
          ]
        }
      }
    }
  ],
  "conversations": {
    "<INSERT YOUR CONVERSATION NAME HERE>": {
      "name": "<INSERT YOUR CONVERSATION NAME HERE>",
      "url": "<INSERT YOUR FULLFILLMENT URL HERE>"
    }
  },
  "locale": "<INSERT YOUR LANGUAGE HERE>"
}