Configuración y limpieza de Dialogflow CX

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

En esta guía, se proporcionan todos los pasos de configuración necesarios para comenzar a usar Dialogflow CX. También se proporcionan 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 CX.
  2. Consulta Ediciones.

Acerca de Google Cloud Console

Google Cloud Console (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 Google Cloud Console 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.

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

Ir al selector de proyectos

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.

Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Obtén información sobre cómo verificar si la facturación está habilitada en un proyecto.

Habilite 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

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

Si planeas usar la API de Dialogflow, debes instalar y, luego, inicializar la CLI de Google Cloud. 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 y, luego, inicializa Google Cloud CLI.

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 cuando se aprende la API de Dialogflow y para el desarrollo local. Puedes usar tu cuenta de usuario para autenticar ejecuciones de la línea de comandos de REST o llamadas a la biblioteca cliente.

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

Para autenticar 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 para tu entorno local, sigue estos pasos:

gcloud auth login

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

Para autenticar llamadas de biblioteca cliente, usa la CLI de gcloud. El comando gcloud auth application-default login te permite acceder a gcloud para obtener las credenciales predeterminadas de la aplicación con tu cuenta de usuario, lo que se debe hacer antes de llamar a la API. Debes 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, sigue estos pasos:

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 debe usarse 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:

Control de acceso con funciones

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

Si creaste el proyecto con tu cuenta de usuario, esta tendrá la función básica de propietario. Esta función proporciona acceso para llamar a cualquier API del proyecto. Sin embargo, si una cuenta diferente creó el proyecto, es posible que debas tener funciones asignadas a tu cuenta de usuario antes de poder 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.

Limpieza

Después de configurar y probar o probar Dialogflow, es posible que desees borrar los recursos que creaste:

  • Te recomendamos borrar tu agente.
  • Es posible que desees cerrar tu proyecto.
  • Si llamaste a gcloud auth login, se almacenarán credenciales en el directorio de usuarios de tu computadora. Para borrar estas credenciales, llama a:
    gcloud auth revoke
  • Si llamaste a gcloud auth application-default login, se almacenarán credenciales en el directorio de usuarios de tu computadora. Para borrar estas credenciales, llama a:
    gcloud auth application-default revoke