CLI de gactions (Dialogflow)
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
gactions es la interfaz de línea de comandos que usas para probar y actualizar tu
Proyecto de acciones.
Arquitectura del sistema
Para seleccionar la descarga adecuada, deberás encontrar la arquitectura de tu sistema.
En los dispositivos Mac OS X y Linux, puedes consultar la arquitectura de la CPU de tu computadora con el comando terminal.
uname -a
En dispositivos con Windows 10, sigue estos pasos para encontrar la arquitectura de la CPU:
Abre Configuración.
Haz clic en Sistema.
Haz clic en Acerca de.
Descargas
Puedes descargar gactions para tu sistema operativo (a continuación).
| SO |
Descargas |
| Windows |
|
| Mac |
|
| Linux |
|
Requisitos
- Haz que el archivo descargado sea ejecutable mediante la configuración de los permisos adecuados.
- En Mac y Linux, ejecuta
chmod +x gactions para que el objeto binario sea ejecutable.
- En Windows, debes tener derechos de administrador.
- La ubicación de descarga
gactions debe estar en tu variable de entorno PATH.
Argumentos admitidos
En la siguiente tabla, se describen los argumentos admitidos para gactions:
| Argumento |
Descripción |
help, h |
Muestra el texto de ayuda para esta herramienta. Por ejemplo:
gactions help
Para ver el texto de ayuda de un argumento específico, usa la siguiente sintaxis:
gactions help argument
Por ejemplo:
gactions help test
|
get |
Obtén el contenido del proyecto determinado (acciones + metadatos). Usa la siguiente sintaxis:
gactions get --project PROJECT_ID
|
init |
Crea un archivo action.json predeterminado en el directorio actual con la siguiente sintaxis:
gactions init
Si ya existe un archivo action.json, puedes reemplazarlo agregando el
--force, como se muestra en el siguiente ejemplo:
gactions init --force
|
list |
Muestra una lista de hasta 10 versiones recientes de tu proyecto de Acciones: en revisión,
producción, aprobado, etc., con la siguiente sintaxis:
gactions list --project PROJECT_ID
|
test |
Envía un paquete de acción a la plataforma del Asistente para probarlo con lo siguiente:
sintaxis:
gactions test --action_package PACKAGE_NAME --project PROJECT_ID
Por ejemplo:
gactions test --action_package mypackage.json --project my-project-1234567
De manera opcional, puedes inhabilitar las pruebas en el entorno de la zona de pruebas
con la marca
--disable_sandbox.
La marca --preview_mins dejó de estar disponible.
|
update |
Actualiza el paquete de acciones para el proyecto determinado con la siguiente sintaxis:
gactions update --action_package PACKAGE_NAME --project PROJECT_ID
Por ejemplo:
gactions update --action_package action.json --project my-project-1234567
Para usar el argumento update, debes usar el ID del proyecto de tu acción. Puedes obtener
el ID del proyecto haciendo clic en el ícono de configuración settings en la
Proyecto de Actions on Google seguido de Configuración del proyecto
Si tu proyecto de Acciones admite varios idiomas, consulta el
Documentación del paquete de acciones.
|
selfupdate |
gactions comprueba automáticamente si hay actualizaciones antes de que se ejecute cada comando, pero puedes forzar
que verifiquen con selfupdate
gactions selfupdate
|
Ver resultado detallado
Para ver un resultado más detallado durante el procesamiento, agrega la marca --verbose. Por ejemplo:
gactions --verbose test --action_package action.json --project my-project-1234567
Ejemplo predeterminado de action.json
Cuando ejecutas gactions init en el directorio de tu proyecto, generas una configuración
action.json en ese directorio:
{
"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 que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-26 (UTC)
[null,null,["Última actualización: 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```"]]
