interfaccia a riga di comando gactions (Dialogflow)
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
gactions è l'interfaccia a riga di comando che utilizzi per testare e aggiornare
Progetto Actions.
Architettura di sistema
Per selezionare il download corretto, dovrai individuare l'architettura del tuo sistema.
Sui dispositivi Mac OS X e Linux, puoi trovare l'architettura della CPU del computer utilizzando il comando del terminale
uname -a.
Sui dispositivi Windows 10, attieniti alla seguente procedura per trovare l'architettura della CPU:
Apri Impostazioni.
Fai clic su Sistema.
Fai clic su Informazioni.
Download
Puoi scaricare gactions per il tuo sistema operativo (di seguito).
| Sistema operativo |
Download |
| Windows |
|
| Mac |
|
| Linux |
|
Requisiti
- Rendi eseguibile il file scaricato impostando le autorizzazioni appropriate.
- Su Mac e Linux, esegui
chmod +x gactions per rendere eseguibile il file binario.
- Su Windows, devi disporre dei diritti di amministratore.
- Il percorso di download
gactions deve essere nella variabile di ambiente PATH.
Argomenti supportati
Nella tabella seguente vengono descritti gli argomenti supportati per gactions:
| Argomento |
Descrizione |
help, h |
Restituisce il testo della guida per questo strumento. Ad esempio:
gactions help
Per visualizzare il testo della guida per un argomento specifico, utilizza la seguente sintassi:
gactions help argument
Ad esempio:
gactions help test
|
get |
Recupera i contenuti del progetto specificato (Azioni + metadati). Utilizza la seguente sintassi:
gactions get --project PROJECT_ID
|
init |
Crea un file action.json predefinito nella directory corrente con la seguente sintassi:
gactions init
Se esiste già un file action.json, puoi sovrascriverlo aggiungendo il metodo
Argomento --force, come mostrato nell'esempio seguente:
gactions init --force
|
list |
Elenca fino a 10 versioni recenti del progetto Actions: in revisione,
produzione, approvato e così via, con la seguente sintassi:
gactions list --project PROJECT_ID
|
test |
Esegue il push di un pacchetto di azioni alla piattaforma Assistant per eseguire test con quanto segue
sintassi:
gactions test --action_package PACKAGE_NAME --project PROJECT_ID
Ad esempio:
gactions test --action_package mypackage.json --project my-project-1234567
Facoltativamente, puoi disattivare i test nell'ambiente sandbox
con il flag
--disable_sandbox.
Il flag --preview_mins è deprecato.
|
update |
Aggiorna il pacchetto Action per il progetto specificato con la seguente sintassi:
gactions update --action_package PACKAGE_NAME --project PROJECT_ID
Ad esempio:
gactions update --action_package action.json --project my-project-1234567
Per utilizzare l'argomento update, devi usare l'ID progetto dell'azione. Puoi ottenere
del tuo ID progetto facendo clic sull'icona a forma di ingranaggio delle impostazioni settings
Progetto Actions on Google seguito da Impostazioni progetto.
Se il progetto Actions supporta più lingue, consulta le
Documentazione relativa al pacchetto Action.
|
selfupdate |
gactions verifica automaticamente la presenza di aggiornamenti prima dell'esecuzione di ciascun comando, ma puoi forzare
che verifica con selfupdate
gactions selfupdate
|
Visualizza output dettagliato
Per visualizzare un output più dettagliato durante l'elaborazione, aggiungi il flag --verbose. Ad esempio:
gactions --verbose test --action_package action.json --project my-project-1234567
Esempio di action.json predefinito
Quando esegui gactions init nella directory del progetto, generi un valore
action.json file in quella directory:
{
"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>"
}
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-26 UTC.
[null,null,["Ultimo aggiornamento 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```"]]
