En esta guía, se proporcionan todos los pasos de configuración necesarios para comenzar a usar Dialogflow. También se proporcionan consejos para posibles pasos de limpieza después de conocer o probar Dialogflow.
Antes de comenzar
Debes hacer lo siguiente antes de leer esta guía:
- Lee los conceptos básicos de Dialogflow ES.
- 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 la 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.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Habilitar 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.
Make sure that billing is enabled for your Google Cloud project.
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.
Enable the Dialogflow 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 e 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:
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud initConfigura 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 cuando se aprende a usar 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, consulte:
- Descripción general de la cuenta de servicio
- Recomendaciones para las cuentas de servicio
- Crea y administra cuentas de servicio
- Crea y administra claves de cuentas de servicio
- Autentica con claves de cuenta de servicio
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 deseas en Bibliotecas cliente.
Limpieza
Después de configurar y probar Dialogflow, te recomendamos borrar los recursos que creaste:
- Te recomendamos borrar 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