gactions-Befehlszeile (Dialogflow)
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
gactions ist die Befehlszeile, mit der Sie Ihre
Actions-Projekt.
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 mithilfe des Terminalbefehls ermitteln.
uname -a
Führen Sie auf Windows 10-Geräten die folgenden Schritte aus, um die CPU-Architektur zu ermitteln:
Öffnen Sie die Einstellungen.
Klicken Sie auf System.
Klicke auf Kanalinfo.
Downloads
Sie können gactions für Ihr Betriebssystem herunterladen (siehe unten).
| Betriebssystem |
Downloads |
| Windows |
|
| Mac |
|
| Linux |
|
Voraussetzungen
- Machen Sie die heruntergeladene Datei ausführbar, indem Sie die entsprechenden Berechtigungen festlegen.
- Führen Sie auf Mac- und Linux-Computern
chmod +x gactions aus, um das Binärprogramm ausführbar zu machen.
- Unter Windows benötigen Sie Administratorrechte.
- Der Downloadpfad von
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 anzuzeigen:
gactions help argument
Beispiel:
gactions help test
|
get |
Inhalt des angegebenen Projekts abrufen (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 diese überschreiben, indem Sie den
--force-Arguments, wie im folgenden Beispiel gezeigt:
gactions init --force
|
list |
Listet bis zu zehn aktuelle Versionen Ihres Actions-Projekts auf: „Wird geprüft“,
Produktion, genehmigt usw. mit der folgenden Syntax:
gactions list --project PROJECT_ID
|
test |
Sendet ein Aktionspaket zum Testen an die Assistant-Plattform mit folgenden Elementen:
Syntax:
gactions test --action_package PACKAGE_NAME --project PROJECT_ID
Beispiel:
gactions test --action_package mypackage.json --project my-project-1234567
Sie können Tests in der Sandbox-Umgebung optional deaktivieren.
mit dem Flag
--disable_sandbox.
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
Wenn du das Argument update verwenden möchtest, musst du die Projekt-ID deiner Aktion angeben. Sie erhalten
Ihre Projekt-ID, indem Sie auf das Zahnradsymbol settings
Actions on Google-Projekt, gefolgt von Project Settings (Projekteinstellungen).
Wenn Ihr Actions-Projekt mehrere Sprachen unterstützt, lesen Sie die
Dokumentation zu Aktionspaketen
|
selfupdate |
gactions sucht automatisch nach Updates, bevor jeder Befehl ausgeführt wird. Sie können jedoch
die selfupdate prüfen
gactions selfupdate
|
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
Standardbeispiel für action.json
Wenn Sie gactions init in Ihrem Projektverzeichnis ausführen, generieren Sie einen Standardwert
action.json-Datei in diesem Verzeichnis:
{
"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>"
}
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-26 (UTC)."],[[["\u003cp\u003e\u003ccode\u003egactions\u003c/code\u003e is a command-line interface used to test and manage Actions projects, providing functionalities like updating, testing, and retrieving project data.\u003c/p\u003e\n"],["\u003cp\u003eDownloads for \u003ccode\u003egactions\u003c/code\u003e are available for Windows, Mac, and Linux operating systems, with options for different system architectures like x86_64, i386, and arm.\u003c/p\u003e\n"],["\u003cp\u003eBefore using \u003ccode\u003egactions\u003c/code\u003e, ensure it is executable and its location is added to your system's \u003ccode\u003ePATH\u003c/code\u003e environment variable.\u003c/p\u003e\n"],["\u003cp\u003eKey functionalities include \u003ccode\u003einit\u003c/code\u003e to create an \u003ccode\u003eaction.json\u003c/code\u003e file, \u003ccode\u003etest\u003c/code\u003e to deploy for testing, \u003ccode\u003eupdate\u003c/code\u003e to push updates, and \u003ccode\u003eget\u003c/code\u003e to retrieve project content.\u003c/p\u003e\n"],["\u003cp\u003eFor detailed information about \u003ccode\u003egactions\u003c/code\u003e usage and available arguments, use the \u003ccode\u003ehelp\u003c/code\u003e command or consult the provided documentation.\u003c/p\u003e\n"]]],[],null,["# gactions CLI (Dialogflow)\n\n`gactions` is the command line interface that you use to test and update your\nActions project.\n\nSystem architecture\n-------------------\n\nTo select the proper download, you'll need to find your system architecture.\n\n- On Mac OS X and Linux devices, you can find your computer's CPU architecture using the terminal command\n `uname -a`.\n\n- On Windows 10 devices, take the following steps to find the CPU architecture:\n\n 1. Open **Settings**\n\n 2. Click **System**\n\n 3. Click **About**\n\nDownloads\n---------\n\nYou can download `gactions` for your operating system (below).\n\n| OS | Downloads |\n|---------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Windows | - [x86_64](https://dl.google.com/gactions/updates/bin/windows/amd64/gactions.exe/gactions.exe) - [i386](https://dl.google.com/gactions/updates/bin/windows/386/gactions.exe/gactions.exe) |\n| Mac | - [x86_64](https://dl.google.com/gactions/updates/bin/darwin/amd64/gactions/gactions) - [i386](https://dl.google.com/gactions/updates/bin/darwin/386/gactions/gactions) |\n| Linux | - [x86_64](https://dl.google.com/gactions/updates/bin/linux/amd64/gactions/gactions) - [i386](https://dl.google.com/gactions/updates/bin/linux/386/gactions/gactions) - [arm](https://dl.google.com/gactions/updates/bin/linux/arm/gactions) |\n\nRequirements\n------------\n\n- Make the downloaded file executable by setting the appropriate permissions.\n - On Mac and Linux, run `chmod +x gactions` to make the binary executable.\n - On Windows, you must have Administrator rights.\n- The `gactions` download location must be in your `PATH` environment variable.\n\nSupported arguments\n-------------------\n\nThe following table describes the supported arguments for `gactions`:\n\n| Argument | Description |\n|--------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `help`, `h` | Outputs the help text for this tool. For example: ``` gactions help ``` To view the help text for a specific argument, use the following syntax: ``` gactions help argument ``` For example: ``` gactions help test ``` |\n| `get` | Get the content of the given project (Actions + metadata). Use the following syntax: ``` gactions get --project PROJECT_ID ``` |\n| `init` | Creates a default `action.json` file in the current directory with the following syntax: ``` gactions init ``` If there is already an existing `action.json` file, you can overwrite it by adding the `--force` argument, as the following example shows: ``` gactions init --force ``` |\n| `list` | Lists up to 10 recent versions of your Actions project: in review, production, approved, etc, with the following syntax: ``` gactions list --project PROJECT_ID ``` |\n| `test` | Pushes an action package to the Assistant Platform for testing with the following syntax: ``` gactions test --action_package PACKAGE_NAME --project PROJECT_ID ``` For example: ``` gactions test --action_package mypackage.json --project my-project-1234567 ``` You can optionally disable testing in the sandbox environment with the `--disable_sandbox` flag. `--preview_mins` flag is deprecated. |\n| `update` | Updates the Action package for the given project with the following syntax: ``` gactions update --action_package PACKAGE_NAME --project PROJECT_ID ``` For example: ``` gactions update --action_package action.json --project my-project-1234567 ``` To use the `update` argument, you must use your Action's Project ID. You can get your project ID by clicking the settings gear *settings* in your Actions on Google project followed by **Project Settings**. If your Actions project supports multiple languages, see the [Action package documentation.](/assistant/df-asdk/localization/action-packages) |\n| `selfupdate` | gactions automatically checks for updates before each command runs, but you can force that check with `selfupdate` ``` gactions selfupdate ``` |\n\nView verbose output\n-------------------\n\nTo view more detailed output during processing, add the `--verbose` flag. For example: \n\n```\ngactions --verbose test --action_package action.json --project my-project-1234567\n```\n\nDefault action.json example\n---------------------------\n\nWhen you run `gactions init` in your project directory, you generate a default\n`action.json` file in that directory: \n\n```text\n{\n \"actions\": [\n {\n \"description\": \"Default Welcome Intent\",\n \"name\": \"MAIN\",\n \"fulfillment\": {\n \"conversationName\": \"\u003cINSERT YOUR CONVERSATION NAME HERE\u003e\"\n },\n \"intent\": {\n \"name\": \"actions.intent.MAIN\",\n \"trigger\": {\n \"queryPatterns\": [\n \"talk to \u003cINSERT YOUR NAME HERE\u003e\"\n ]\n }\n }\n }\n ],\n \"conversations\": {\n \"\u003cINSERT YOUR CONVERSATION NAME HERE\u003e\": {\n \"name\": \"\u003cINSERT YOUR CONVERSATION NAME HERE\u003e\",\n \"url\": \"\u003cINSERT YOUR FULLFILLMENT URL HERE\u003e\"\n }\n },\n \"locale\": \"\u003cINSERT YOUR LANGUAGE HERE\u003e\"\n}\n```"]]
