Entregas

Para el turno de conversación de un agente, este debe responder al usuario final con una respuesta a una pregunta, una consulta de información o una finalización de la sesión. Es posible que el agente también deba comunicarse con el servicio para generar respuestas dinámicas o tomar medidas durante un turno. La entrega se usa para lograr todo esto.

Una entrega puede contener cualquiera de los siguientes elementos:

• Mensajes de respuesta estática.
• Webhook llama para obtener respuestas dinámicas o para realizar acciones.
• Ajustes predeterminados de parámetros para establecer o anular los valores del parámetro

Durante el turno de un agente, es posible (y, a veces, conveniente) llamar a varias entregas, cada una de las cuales puede generar un mensaje de respuesta. Los agentes de conversación (Dialogflow CX) mantienen estas respuestas en una cola de respuestas. Una vez que el agente termine, Conversational Agents (Dialogflow CX) envía las respuestas ordenadas al usuario final.

Casos prácticos de entrega

La entrega se usa en todas partes en que se necesita un mensaje de respuesta:

• Entrega de entrada de página
• Rutas
• Controladores de eventos
• Mensajes iniciales para formularios
• Controladores de solicitudes nuevas para formularios

Para cada uno de estos casos de uso, la consola abrirá un panel de edición de entregas.

Mensajes de respuesta estática (opciones de diálogo)

Los mensajes de respuesta estáticos son respuestas del agente que defines en el momento del diseño. Se definen durante la creación de la entrega. En el entorno de ejecución, estas respuestas se agregan a la cola de respuestas.

Existen varios tipos de mensajes de respuesta, que se describen en las subsecciones que siguen. Cuando uses la consola, un panel de entregas tendrá una tarjeta inicial de mensaje de respuesta de texto, pero puedes hacer clic en Agregar opción de diálogo para agregar más tarjetas para otros tipos de mensajes de respuesta.

Texto

Los mensajes de respuesta de texto envían el diálogo al texto al usuario final. Si tus llamadas a la API de detección de intent o las llamadas de integración usan síntesis de voz, este texto se usará para generar contenido de audio. En este caso, en el texto proporcionado, se puede usar el lenguaje de marcación de síntesis de voz (SSML) de forma opcional.

Puedes definir varias tarjetas de respuesta de texto y varias respuestas de texto dentro de cada tarjeta. Si defines varias tarjetas, se concatenan para una sola respuesta en el entorno de ejecución. Si defines varias respuestas dentro de una tarjeta, uno de los mensajes de la tarjeta se elige de forma aleatoria en el entorno de ejecución.

Estos mensajes de texto pueden contener referencias de parámetros y funciones del sistema intercaladas.

Carga útil personalizada

Algunas integraciones son compatibles con una respuesta de carga útil personalizada para administrar respuestas enriquecidas. Estas cargas útiles personalizadas se suministran en un formato JSON definido en la documentación de la integración. Por ejemplo, consulta el Formato de carga útil personalizada de Dialogflow CX Messenger.

Puedes incluir referencias de parámetros en el JSON de carga útil personalizado. Deben tratarse como valores de string JSON, por lo que debes colocarlos entre comillas dobles. Por ejemplo:

{
  "someField": "$session.params.date"
}

También puedes enviar una carga útil personalizada a las integraciones que desarrollas. Los agentes conversacionales (Dialogflow CX) no se encargarán del procesamiento, por lo que tendrás que manejarlo en tu propia lógica empresarial.

Consulta también la sección plantillas de cargas útiles personalizadas a continuación.

Transferencia del agente humano

Esta respuesta le indica al emisor de la API de detección de intent que la conversación se debe transferir a un agente humano. Los agentes conversacionales (Dialogflow CX) solo usan este indicador para identificar las conversaciones que se entregan con fines de medición y no alteran el estado de la sesión de ninguna manera. El sistema o la integración pueden usar esta señal para realizar cualquier acción que sea necesaria para transferir la conversación. Los agentes conversacionales (Dialogflow CX) no imponen ninguna estructura en estos datos, por lo que puedes elegir cualquier estructura que se adapte a tu sistema.

Metadatos de la conversación correcta

Esta respuesta le indica al llamador de la API de detección de intent que la conversación con el agente de conversaciones (Dialogflow CX) de forma correcta. Los agentes conversacionales (Dialogflow CX) solo usan esta señal para identificar las conversaciones que se completaron de forma correcta con fines de medición y no alteran el estado de la sesión de ninguna manera. El sistema o la integración pueden usar esta señal para realizar cualquier acción que sea necesaria. Los agentes de conversación (Dialogflow CX) no imponen ninguna estructura en estos datos, así que puedes elegir la estructura que mejor se adapte a tu sistema.

Reproduce el audio grabado previamente

Esta respuesta reproduce un archivo de audio para las integraciones que admiten esta característica.

Los requisitos de formato de archivo de audio pueden variar según las diferentes integraciones. Por ejemplo, consulta los requisitos de la puerta de enlace telefónica de Dialogflow CX.

En el caso de las integraciones de telefonía de socios, el socio debe poder acceder a la URL del archivo de audio. Una URL disponible públicamente, como una archivo público en Cloud Storage siempre es accesible para el socio. El socio también puede otorgar acceso restringido a los archivos de audio. Consulta la documentación para socios para obtener más información.

Texto de audio de salida

Esta respuesta es similar a la texto, sin embargo, solo se aplica a la síntesis de voz. Si tu agente puede manejar sesiones de texto y de voz, puedes usar respuestas únicas de texto y texto de audio de salida a fin de crear una experiencia del usuario diferente para texto en comparación con voz Si se proporciona texto de audio de salida para una sesión de voz, se ignoran las respuestas de texto sin formato.

Si tu agente maneja sesiones de texto y voz, y deseas los mismos mensajes de respuesta, solo usa respuestas de texto para sesiones de texto y voz.

El texto de audio de salida se concatena entre las respuestas de texto. Si las respuestas de texto del audio de salida son una mezcla de texto y SSML, el resultado concatenado se trata como SSML. Lo ideal es que el diseñador del agente use texto o SSML de manera coherente.

Respuesta condicional

Este tipo de respuesta se usa para las respuestas condicionales. El formato general es el siguiente:

if [condition]
  [response]
elif [condition]
  [response]
elif [condition]
  [response]
else
  [response]
endif

Donde:

• [condition] es el mismo formato que se usa para las condiciones de enrutamiento.
• [response] es una respuesta de texto
• Los bloques elif y else son opcionales

Por ejemplo:

if $session.params.user-age >= 21
  Ok, you may enter.
else
  Sorry, you cannot enter.
endif

[condition] y [response] pueden usar funciones del sistema intercaladas para generar valores dinámicos durante las conversaciones. Para obtener más información, consulta las referencias de las funciones del sistema y las condiciones de enrutamiento. El [condition] se resuelve en función del estado de la sesión al comienzo de la entrega. Si [response] depende del estado de la sesión, se resuelve. según el estado actualizado de la sesión al final de la entrega.

En el caso de los agentes multilingües, [condition] es común para todos los idiomas, mientras que [response] es específico de un idioma. Cuando cambias [condition] para un idioma en la consola, esta parte se actualiza en todos los idiomas del agente y, desde que se vuelve una condición nueva, se borra [response] para todos los idiomas que no sea el idioma que seleccionaste cuando actualizaste [condition].

Llamada de transferencia telefónica

Nota: Por el momento, la transferencia de llamadas solo está disponible para la puerta de enlace telefónica de Dialogflow CX.

En algunas integraciones de telefonía, puedes especificar un número de teléfono de EE.UU. para la transferencia de llamadas. En el entorno de ejecución, cuando el agente virtual de agentes de conversación (Dialogflow CX) llama a una entrega con transferencia de llamadas, la llamada se transfiere al número especificado y se suspende el control del agente virtual.

Mensajes de respuesta específicos del canal

Cuando definas la entrega, podrás crear mensajes de respuesta específicos del canal para crear respuestas segmentadas para el chat de texto, la voz, los SMS, las integraciones específicas que admiten canales, etcétera. Cualquier mensaje de respuesta que no sea específico de un canal se denominan mensajes de respuesta predeterminados.

Durante el tiempo de ejecución, Conversational Agents (Dialogflow CX) seleccionará el mensaje de respuesta predeterminado, o un mensaje de respuesta específico del canal Cuando una solicitud de detección de intent especifica un canal. Como práctica recomendada, debes definir mensajes de respuesta predeterminados, incluso si usas mensajes de respuesta específicos del canal. Los mensajes de respuesta predeterminados pueden actuar como resguardo cuando el sistema no proporciona un canal válido.

El nombre del canal es un campo personalizado que puedes configurar con cualquier texto. Si usas la API de agentes conversacionales (Dialogflow CX) directamente para las llamadas del entorno de ejecución, puedes usar cualquier nombre de canal que desees. Si usas una integración existente, debes usar los nombres de los canales que reconoce la integración.

Cómo configurar mensajes de respuesta específicos del canal en el momento del diseño

Para proporcionar mensajes de respuesta específicos del canal para la entrega cuando usas la consola, haz lo siguiente:

• Haz clic en Agregar canal después de agregar los mensajes de respuesta predeterminados. La interfaz de usuario te permitirá agregar mensajes de respuesta específicos del canal. Vuelve a hacer clic en Agregar canal para agregar otro canal.

Proporcionar mensajes de respuesta específicos del canal para la entrega cuando uses la API:

• Establece el campo Fulfillment.messages[i].channel en el canal deseado para cada mensaje de respuesta. Si no se configura este campo, la respuesta es un mensaje de respuesta predeterminado.

Cómo usar mensajes de respuesta específicos del canal durante el tiempo de ejecución

Nota: Si usas una integración existente que admite canales, la implementación de la integración realiza los pasos que se indican a continuación.

Para recibir un mensaje de respuesta específico del canal, haz lo siguiente: Se debe especificar el canal en el mensaje de solicitud de detección de intent. Consulta el campo queryParams.channel en el método detectIntent. del tipo Sessions. Ir a la referencia de la API de sesión

Selecciona un protocolo y una versión para la referencia de sesión:

Protocolo	V3	V3beta1
REST	Recurso de sesión	Recurso de sesión
RPC	Interfaz de sesión	Interfaz de sesión
C++	SessionsClient	No disponible
C#	SessionsClient	No disponible
Go	SessionsClient	No disponible
Java	SessionsClient	SessionsClient
Node.js	SessionsClient	SessionsClient
PHP	No disponible	No disponible
Python	SessionsClient	SessionsClient
Ruby	No disponible	No disponible

Cerrar

Si no se define ningún canal en una solicitud o no se encuentra ningún canal coincidente en la entrega, los agentes conversacionales (Dialogflow CX) mostrarán el mensaje de respuesta predeterminado.

Plantillas de carga útil personalizadas

Si usas cargas útiles personalizadas con frecuencia, debes usar plantillas de cargas útiles personalizadas. A veces, las cargas útiles personalizadas son grandes y complejas, por lo que usar plantillas puede facilitar el proceso de creación de agentes.

Puedes proporcionar estas plantillas en la configuración de tu agente por lo que están disponibles para su selección cada vez que crees una entrega para tu agente.

Por ejemplo: la carga útil de JSON para “sí” y "no" los botones pueden definirse como plantillas de carga útil personalizadas. Cuando crees una entrega que requiera estos botones, solo debes seleccionar la plantilla cuando crees la entrega.

Cuando seleccionas una plantilla para una carga útil personalizada de entrega, el contenido de la plantilla se inserta en la carga útil. Luego, puedes editar la carga útil según sea necesario.

Si cambias una plantilla, el cambio no se propaga automáticamente a todas las cargas útiles de entrega a las que se hizo referencia.

Para crear una plantilla de carga útil personalizada, consulta la configuración general del agente.

Para seleccionar una plantilla de carga útil personalizada cuando crees la entrega, haz clic en Seleccionar plantilla cuando crees una carga útil personalizada de entrega.

Llamadas de webhook

Cuando se llama a una entrega y esta tiene un webhook, el agente envía una solicitud a tu webhook. El webhook puede realizar cualquier acción necesaria dentro de tu servicio, proporcionar un mensaje de respuesta dinámica, anular los valores de los parámetros y cambiar la página actual.

A continuación, se describe la configuración de webhook para la entrega:

Término	Definición
Habilita el webhook	Esto habilita el webhook para la entrega.
Webhook	Selecciona el recurso de webhook.
Etiqueta	La etiqueta de texto que proporciones aquí se propagará en el campo WebhookRequest.fulfillmentInfo.tag de la solicitud de webhook que se envía a tu servicio de webhook. Se puede usar para controlar el comportamiento del webhook de una manera específica de la entrega.
Cómo mostrar una respuesta parcial	Permite cancelar la reproducción de una respuesta parcial. Consulta la configuración de voz avanzada para obtener más detalles.

Ajustes predeterminados de los parámetros

Puedes usar una entrega para proporcionar ajustes predeterminados que establezcan o anulen los valores de parámetros actuales. Estos ajustes predeterminados se aplicarán antes de resolver los mensajes de respuesta estática o llamar a un webhook.

También puedes usar las funciones del sistema para ajustar el parámetro a un valor generado de forma dinámica.

A continuación, se muestran algunos ejemplos:

• Establece un parámetro now en la hora actual:

  Parámetro	Valor
  ahora	$sys.func.NOW()

• Incrementa un parámetro existente counter en 1:

  Parámetro	Valor
  contador	$sys.func.ADD($session.params.counter, 1)

• Establece un parámetro new-cost en el valor del parámetro other-cost y, al mismo tiempo, mantén el valor completo del objeto compuesto:

  Parámetro	Valor
  new-cost	$sys.func.IDENTITY($session.params.other-cost)

Configuración avanzada de voz

Esta configuración avanzada de voz puede anular de manera opcional la misma configuración de voz de página, configuración de voz de flujo y configuración de voz del agente.

Cola de respuestas

Durante el turno de un agente, es posible (y, a veces, conveniente) llamar a varias entregas, cada una de las cuales puede generar un mensaje de respuesta. Los agentes conversacionales (Dialogflow CX) mantienen estas respuestas en una cola de respuestas.

Respuesta parcial para la API de transmisión

De forma predeterminada, Conversational Agents (Dialogflow CX) solo envía las respuestas ordenadas al usuario final una vez que termine el turno del agente. También puedes habilitar la opción Mostrar una respuesta parcial en la entrega para que muestre respuestas en cola como una respuesta parcial cuando usas las API de transmisión. Consulta Ciclo de vida de una página para obtener más detalles.

Por ejemplo, si tu webhook probablemente se ejecute por mucho tiempo, puedes agregar una respuesta estática en la entrega y habilitar la respuesta parcial. Esto hace que los agentes de conversación (Dialogflow CX) borren la cola de respuestas y envíen todos los mensajes como una respuesta parcial antes de llamar al webhook.

Por el momento, no se admite la respuesta parcial para lo siguiente, pero se admitirá más adelante:

• Las entradas de audio simulator.
• Integraciones de telefonía de socios pueden o no admitir una respuesta parcial en este momento. Consulta la documentación del socio para verificarlo.

Para probar esta función en el simulador, debes activar la respuesta parcial.

En el siguiente ejemplo, considera que tu webhook tarda 5 segundos en completarse y que no habilitas la respuesta parcial. El agente de Conversational Agents (Dialogflow CX) el turno de conversación no finaliza hasta que se complete el webhook. Durante este turno de 5 segundos, las respuestas se ponen en cola mientras esperan el webhook y no se muestran al usuario final hasta que se completa el turno. Esto genera una mala experiencia del usuario.

Si habilitas la respuesta parcial en la primera entrega, Conversational Agents (Dialogflow CX) muestra el primer mensaje de entrega rápidamente y llama al webhook. Una vez que el webhook completado, Conversational Agents (Dialogflow CX) devuelve la respuesta final. La experiencia del usuario final se mejora en esta situación, ya que se les pide que esperen una breve espera. Además, la llamada de webhook se ejecuta de forma simultánea con una respuesta que se envía al usuario final.

Lenguaje de marcación de síntesis de voz (SSML)

Puedes usar el lenguaje de marcación de síntesis de voz (SSML) en campos de entrega de texto de audio o audio de salida. Esto te permite personalizar tu respuesta de audio proporcionando detalles sobre las pausas y el formato de audio para las siglas, fechas, horas, abreviaturas o el texto que se debe censurar.

Para obtener detalles sobre la sintaxis, consulta la Documentación de SSML de texto a voz.

Nota: Un campo de entrega no puede tener más de un par de etiquetas <speak></speak>.