Configuración y limpieza de Dialogflow ES

En esta guía, se proporcionan todos los pasos de configuración necesarios para comenzar a usar Dialogflow. También proporciona consejos para los posibles pasos de limpieza después de probar o probar Dialogflow.

Antes de comenzar

Debes hacer lo siguiente antes de leer esta guía:

  1. Lee los conceptos básicos de Dialogflow ES.
  2. Consulta Ediciones.

Acerca de la consola de Google Cloud

La consola de Google Cloud (consultar la documentación, abrir la consola) es una IU web que se usa para aprovisionar, configurar, administrar y supervisar los sistemas que usan productos de Google Cloud. Usas la consola de Google Cloud para configurar y administrar los recursos de Dialogflow.

Crear un proyecto

Para usar los servicios que proporciona Google Cloud, debes crear un proyecto. En él, se organizan todos tus recursos de Google Cloud. Un proyecto consta de un conjunto de colaboradores, API habilitadas (y otros recursos), herramientas de supervisión, datos de facturación y controles de autenticación y acceso. Puedes crear uno o varios proyectos y usarlos para organizar tus recursos de Google Cloud en una jerarquía de recursos. Cuando creas un proyecto, toma nota del ID del proyecto. Necesitarás este ID para realizar llamadas a la API. Para obtener más información sobre los proyectos, consulta la documentación del Administrador de recursos.

La consola de Dialogflow ES (consulta la documentación, abre la consola) puede crear un proyecto básico de forma opcional cuando creas un agente. Si planeas usar tu proyecto para algo más que el acceso básico a una edición sin cargo o planeas usar la API, debes crear un proyecto con Google Cloud Console como se describe a continuación.

Te recomendamos crear proyectos separados para experimentos, pruebas y producción. Cada proyecto solo puede crear un agente de Dialogflow. Si necesitas varios agentes, deberás crear varios proyectos.

En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

Ir al selector de proyectos

Habilitar la facturación

Se usa una cuenta de facturación para definir quién paga por un conjunto específico de recursos y puede vincularse a uno o más proyectos. El uso del proyecto se cobra a la cuenta de facturación vinculada. En la mayoría de los casos, configuras la facturación cuando creas un proyecto. Para obtener más información, consulta la documentación de la facturación.

Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

Habilita la API

Debes habilitar la API de Dialogflow en tu proyecto. Para obtener más información sobre cómo habilitar las API, consulta la documentación de Service Usage.

Habilita Dialogflow API.

Habilita la API

Habilita registros de auditoría

Habilita los registros de auditoría de acceso a los datos para la API de Dialogflow en tu proyecto. Esto puede ayudarte a hacer un seguimiento de los cambios durante el diseño en los agentes de Dialogflow vinculados a este proyecto.

Instala y, luego, inicializa el SDK de Google Cloud.

Si planeas usar la API de Dialogflow, debes instalar y, luego, inicializar Google Cloud CLI. La CLI de gcloud es un conjunto de herramientas que puedes usar para administrar recursos y aplicaciones alojados en Google Cloud.

En el siguiente vínculo, se proporcionan instrucciones:

Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando:

gcloud init

Configura la autenticación y el control de acceso

Si planeas usar la API de Dialogflow, debes configurar la autenticación. Cualquier aplicación cliente que use la API debe estar autenticada y tener acceso a los recursos solicitados. En esta sección, se describen conceptos importantes de autenticación y se proporcionan pasos para configurarla. Para obtener más información, consulta la Descripción general de la autenticación.

Autenticación con cuentas de usuario

Las cuentas de usuario son la mejor opción de autenticación para aprender sobre la API de Dialogflow y para el desarrollo local. Puedes usar tu cuenta de usuario para autenticar las ejecuciones de la línea de comandos de REST o las llamadas a la biblioteca cliente.

Autenticación de la cuenta de usuario de la línea de comandos de REST

Para autenticar las llamadas de línea de comandos de REST, usa la CLI de gcloud. El comando gcloud auth login te permite acceder a gcloud con tu cuenta de usuario, lo que se debe hacer antes de llamar a la API. El comando gcloud auth print-access-token se usa en las muestras de la línea de comandos de REST de esta documentación para autenticar las llamadas de REST.

Para crear credenciales de usuario en tu entorno local, sigue estos pasos:

gcloud auth login

Autenticación de la cuenta de usuario de la biblioteca cliente

Para autenticar las llamadas de la biblioteca cliente, usa la CLI de gcloud. El comando gcloud auth application-default login accede a gcloud para obtener credenciales predeterminadas de la aplicación con tu cuenta de usuario, lo que se debe hacer antes de llamar a la API. Se debe usar el comando gcloud auth application-default set-quota-project a fin de configurar tu proyecto para la facturación y las cuotas relacionadas con las llamadas a la API. Por lo general, este es el mismo proyecto que usa tu agente y proporcionas el ID del proyecto que creaste en los pasos anteriores.

No se debe establecer la variable de entorno GOOGLE_APPLICATION_CREDENTIALS para que las bibliotecas cliente puedan usar las credenciales predeterminadas de tu aplicación.

Para crear credenciales predeterminadas de la aplicación para tu entorno local, haz lo siguiente:

gcloud auth application-default login
gcloud auth application-default set-quota-project PROJECT_ID

Autenticación con cuentas de servicio

Las cuentas de servicio son otra opción de autenticación que solo se debe usar en entornos seguros como producción o etapa de pruebas. Una cuenta de servicio proporciona credenciales para aplicaciones, a diferencia de los usuarios finales. Las cuentas de servicio son propiedad de los proyectos, y puedes crear muchas cuentas de servicio para un proyecto. Para obtener más información, consulta:

Control de acceso con roles

Cuando una principal (cuenta de usuario, cuenta de servicio, etc.) llama a una API, Google Cloud requiere que la principal tenga los permisos correspondientes. Para otorgar permisos, puedes asignar roles a una principal. Para obtener más información, consulta la descripción general de los roles.

Si creaste tu proyecto con tu cuenta de usuario, esta tiene la rol básico de propietario para el proyecto. Este rol proporciona acceso para llamar a cualquier API del proyecto. Sin embargo, si otra cuenta creó el proyecto, es posible que debas otorgar roles a tu cuenta de usuario antes de que puedas llamar a la API. Para obtener instrucciones, consulta la guía de control de acceso de Dialogflow.

Instala la biblioteca cliente de Dialogflow

Tienes tres opciones para llamar a la API: las bibliotecas cliente compatibles con Google, REST o gRPC.

Las bibliotecas cliente están disponibles para varios lenguajes populares. Para obtener instrucciones de instalación, consulta el lenguaje que desees en Bibliotecas cliente.

Realiza una limpieza

Después de configurar y probar o probar Dialogflow, te recomendamos borrar los recursos que creaste:

  • Te recomendamos que borres tu agente.
  • Te recomendamos cerrar tu proyecto.
  • Si llamaste a gcloud auth login, esto almacena las credenciales en el directorio de usuarios de tu computadora. Puedes borrar estas credenciales con la siguiente llamada:
    gcloud auth revoke
  • Si llamaste a gcloud auth application-default login, esto almacena las credenciales en el directorio de usuarios de tu computadora. Puedes borrar estas credenciales con la siguiente llamada:
    gcloud auth application-default revoke