Interacciones de la API

Si no usas una de las opciones de la integración, debes escribir el código que interactúa directamente con el que el usuario final. También debes interactuar directamente con la API de Dialogflow en cada turno de la conversación para enviar las expresiones del usuario final y recibir coincidencias de intent. En el siguiente diagrama, se muestra el flujo de procesamiento en el momento en el que se interactúa con la API.

Diagrama en el que se muestra el flujo de la API
  1. El usuario final escribe o verbaliza una expresión.
  2. Tu servicio le envía esta expresión del usuario final a Dialogflow en un mensaje de solicitud de intent de detección.
  3. Dialogflow le envía un mensaje de respuesta de intent de detección a tu servicio. Este mensaje contiene información sobre el intent coincidente, la acción, los parámetros y la respuesta definida para ese intent.
  4. Tu servicio realiza acciones según sea necesario, como consultas a la base de datos o llamadas a la API externas.
  5. Tu servicio le envía una respuesta al usuario final.
  6. El usuario final ve o escucha la respuesta.

Configuración y autenticación del proyecto

Antes de llamar a la API, debes configurar una autenticación y un proyecto de GCP. Puedes seguir los pasos detallados en la guía de inicio rápido para la configuración.

Compilación del agente

En la mayoría de los casos, debes usar la consola de Dialogflow (consultar la documentación, abre la consola) para compilar agentes. Puedes seguir los pasos detallados en la página de la guía de inicio rápido de la consola para compilar un agente. También puedes usar la API de Dialogflow para compilar agentes en situaciones avanzadas. En muchas páginas de conceptos, se hace foco en el uso de la consola para compilar agentes, pero también se proporcionan vínculos a los tipos de API relevantes.

REST, gRPC y bibliotecas cliente

Puedes acceder a la API de Dialogflow a través de REST, gRPC o una de las bibliotecas cliente proporcionadas. Si las bibliotecas cliente admiten el lenguaje de programación deseado, debes usar la biblioteca cliente para tu lenguaje. Si no se admite tu lenguaje, debes usar REST por su simplicidad o gRPC por su alto rendimiento. Las bibliotecas cliente se compilan en el protocolo gRPC.

Para obtener detalles sobre estas opciones, consulta las páginas de referencia.

Sesiones

Una sesión representa una conversación entre un agente de Dialogflow y un usuario final. La sesión se crea al comienzo de una conversación y se usa para cada turno de la conversación. Una vez terminada la conversación, se deja de usar la sesión.

No se debe usar la misma sesión para conversaciones simultáneas con diferentes usuarios finales. Dialogflow mantiene los contextos activos en este momento para cada sesión activa. Dialogflow almacena los datos de la sesión durante 20 minutos.

Cada sesión se determina como única por un ID de sesión que generó tu sistema. Para crear una sesión nueva, debes proporcionar un ID de sesión nuevo en una solicitud de detección de intent. Un ID de sesión es una string de 36 bytes de tamaño como máximo. Tu sistema se encarga de generar ID de sesión únicos. Pueden ser números aleatorios, identificadores de usuario final con hash o cualquier otro valor que te resulte conveniente generar.

Detecta intents

Cuando usas la API para interactuar, tu servicio interactúa directamente con el usuario final. Para cada turno de la conversación, el servicio envía expresiones del usuario final a Dialogflow mediante llamadas al método detectIntent o streamingDetectIntent del tipo Sessions. Dialogflow responde con información sobre el intent coincidente, la acción, los parámetros y la respuesta definida para ese intent. Tu servicio realiza acciones según sea necesario (por ejemplo, consultas a la base de datos o llamadas a la API externa) y envía un mensaje al usuario final. Este proceso continúa hasta que la conversación haya terminado.

Puedes encontrar ejemplos de intents de detección que realizan llamadas en la página de la guía de inicio rápido de la API y en Guías prácticas.

¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

Documentación de Dialogflow
¿Necesitas ayuda? Visita nuestra página de asistencia.