CLI de gactions (Dialogflow)

gactions es la interfaz de línea de comandos que usas para probar y actualizar tu proyecto de Actions.

Arquitectura del sistema

Para seleccionar la descarga adecuada, debes encontrar la arquitectura de tu sistema.

  • En dispositivos con Mac OS X y Linux, puedes encontrar la arquitectura de CPU de tu computadora con el comando de terminal uname -a.

  • En los dispositivos con Windows 10, sigue estos pasos para encontrar la arquitectura de la CPU:

    1. Abre Configuración.

    2. Haz clic en System.

    3. Haz clic en Acerca de.

Descargas

Puedes descargar gactions para tu sistema operativo (más abajo).

SO Descargas
Windows
Mac
Linux

Requisitos

  • Configura los permisos correspondientes para que el archivo descargado sea ejecutable.
    • 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 la variable de entorno PATH.

Argumentos compatibles

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 Obtener el contenido de un 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 argumento --force, como se muestra en el siguiente ejemplo:

gactions init --force
list Enumera hasta 10 versiones recientes de tu proyecto de acciones: en revisión, producción, aprobada, etc., con la siguiente sintaxis:
gactions list --project PROJECT_ID
test Envía un paquete de acciones a la plataforma de Asistente para probar con la 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. Para obtener el ID del proyecto, haz clic en el ícono de configuración en el proyecto de Actions on Google y, luego, en Configuración del proyecto.

Si tu proyecto de acciones admite varios lenguajes, consulta la documentación del paquete de acciones.

selfupdate gactions comprueba automáticamente si hay actualizaciones antes de que se ejecute cada comando, pero puedes forzar esa verificación 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 un archivo action.json predeterminado 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>"
}