CLI de gactions (Dialogflow)

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:

    1. Abre Configuración.

    2. Haz clic en Sistema.

    3. 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 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>"
}