Las acciones de conversación dejarán de estar disponibles el 13 de junio de 2023. Para obtener más información, consulta Eliminación de acciones en conversaciones.

Guía de inicio rápido del SDK de Actions y Builder

En esta guía, aprenderás a configurar tu entorno para compilar acciones con el SDK de Actions y Actions Builder. Realizarás las siguientes tareas:

  • Instala Node.js: Necesitas este entorno de ejecución para usar nuestra biblioteca de entrega de Node.js.
  • Instala Firebase CLI: Esta herramienta de línea de comandos te permite desarrollar y, luego, implementar dependencias de Firebase, como apps web para Interactive Canvas, en Firebase Hosting.
  • Instala la línea de comandos de gactions: Cuando desarrollas con el SDK de Actions, debes usar esta herramienta para crear, administrar y, luego, implementar el paquete de acciones para tu acción.
  • Crea un proyecto de Actions: Un proyecto de Actions es el contenedor lógico para tus acciones de conversación. Debes crear uno en la Consola de Actions antes de comenzar a compilar.
  • Inicializar y, luego, implementar una muestra: En esta muestra simple, se indica cómo comenzar a compilar acciones con la tecnología de Interactive Canvas.

Una vez que completes este inicio rápido, podrás sincronizar tu proyecto de Actions entre tu entorno de desarrollo local y la experiencia web de Actions Builder.

Instala Node.js y Firebase CLI

Descarga y, luego, instala Node.js según la documentación de Node.js para usar nuestra biblioteca de entregas. La instalación de Node.js también te permite instalar Firebase CLI con npm y, luego, para ejecutar la implementación de entrega conversacional de forma local.

Instala y configura Firebase CLI según la documentación de Firebase. Firebase CLI te permite implementar una app web de Interactive Canvas en Firebase Hosting y, si es necesario, implementar la entrega en Cloud Functions para Firebase de forma manual.

Instala la herramienta de línea de comandos gactions

Para instalar la herramienta de la interfaz de línea de comandos (CLI) de gactions, descarga un paquete de instalación, descomprímelo y configura la ruta de ejecución.

Para instalar y configurar gacciones, sigue estos pasos:

  1. Descarga el paquete adecuado para tu sistema operativo:

    Plataforma Paquete Suma de comprobación
    Windows Descargar SHA256
    Linux Descargar SHA256
    macOS Descargar SHA256
  2. Extrae el paquete a una ubicación de tu elección y agrega el objeto binario a la variable PATH de tu entorno. Como alternativa, extrae el paquete en una ubicación que ya esté en tu variable PATH (por ejemplo, /usr/local/bin).

  3. En Linux y Mac, habilita los permisos de ejecución si es necesario:

    chmod +x PATH_TO/gactions
  4. Ejecuta el siguiente comando para autenticar la CLI. Este comando inicia un flujo de autenticación y requiere un navegador web:

    gactions login

    Cuando se completa el flujo, la CLI se autentica de forma automática.

Cómo crear y configurar un proyecto

Para poder usar la herramienta de línea de comandos de gactions, debes crear un proyecto en la Consola de Actions y otorgar acceso de gactions al proyecto. Para crear y configurar un proyecto, haz lo siguiente:

  1. Ve a la Consola de Actions.
  2. Haz clic en Proyecto nuevo, ingresa un nombre para el proyecto y haz clic en Crear proyecto.
  3. Selecciona una categoría y haz clic en Siguiente.
  4. Selecciona Blank project y haz clic en Start Building.
  5. Para habilitar la API de Actions en Google Cloud Console, sigue las instrucciones que se indican en Habilita o inhabilita API. Esto permite que las gacciones interactúen con tu proyecto.

Obtén la muestra de Hello World

En la muestra interactiva de Hello World, se muestra cómo crear un proyecto de Acciones simple con una sola acción con la tecnología de Interactive Canvas.

  1. Crea un directorio vacío y, luego, inicializa el ejemplo de Interactive Canvas en ese directorio. Por ejemplo, el siguiente código inicializa la muestra en un directorio interactive-canvas-sample/, que se usa como ejemplo en todo este documento:

    gactions init interactive-canvas --dest interactive-canvas-sample
    cd interactive-canvas-sample
    
  2. Abre el archivo interactive-canvas-sample/sdk/settings/settings.yaml y cambia el valor del campo projectId por el ID de tu proyecto.

Implementa y prueba la muestra

Después de configurar la muestra, puedes implementar la aplicación web de Interactive Canvas y tu proyecto de Actions. Este proceso crea una versión de borrador del proyecto de Actions que puedes implementar en el simulador de Actions para obtener una vista previa y realizar pruebas:

  1. Desde el directorio interactive-canvas-sample/, ejecuta el siguiente comando para implementar la app web de Interactive Canvas (el contenido del directorio public/).

    firebase deploy --project PROJECT_ID --only hosting
    

    Puedes ver una versión procesada de la aplicación web en la URL que muestra Firebase CLI en un navegador: https://PROJECT_ID.web.app.

  2. Abre el archivo interactive-canvas-sample/sdk/webhooks/ActionsOnGoogleFulfillment/index.js y cambia el valor de la variable CANVAS_URL por la URL de la app web del proyecto.

    const CANVAS_URL = 'https://PROJECT_ID.web.app';
    
  3. Desde el directorio interactive-canvas-sample/sdk/, ejecuta el siguiente comando para enviar la versión local de tu proyecto de Actions a la consola como una versión de borrador:

    gactions push
    
  4. Desde el directorio interactive-canvas-sample/sdk/, ejecuta el siguiente comando para probar el proyecto de acciones en el simulador:

    gactions deploy preview
    
  5. Abre el vínculo que muestra la herramienta de línea de comandos para ir al simulador.

  6. En el simulador, ingresa “Hablar con un lienzo interactivo de muestra” para iniciar la acción. Deberías ver un triángulo giratorio con la tecnología de la aplicación web implementada en https://PROJECT_ID.web.app.

    Figura 1: El simulador que obtiene una vista previa del proyecto Actions