Componentes
Los estados de un flujo de diálogo se basan en componentes que realizan acciones, como aceptar la entrada del usuario, verificar esa entrada o responder con texto.
Hay dos tipos de componentes que se pueden utilizar en un flujo de diálogo: componentes incorporados y componentes personalizados. Cuando el motor de diálogo introduce un estado en el flujo de diálogo, evalúa el componente. Cuando se encuentra con uno de los componentes incorporados, ejecuta una de las tareas genéricas, como mostrar un mensaje o solicitar al usuario que introduzca texto. Cuando el motor de diálogo detecta un componente personalizado, llama al servicio del componente, que aloja uno o más componentes personalizados.
Componentes incorporados
Digital Assistant proporciona un juego de componentes que soportan una serie de acciones genéricas y que se pueden utilizar en cualquier aptitud: seguridad, análisis de las entradas de usuario, enrutamiento del flujo de diálogo según dichas entradas de usuario y salida de las respuestas de la aptitud de varias formas. A menos que necesite efectuar una integración con backends o ejecutar una lógica extremadamente compleja, estos componentes proporcionan las acciones que necesitan los estados.
La forma de acceder a los componentes depende de si está diseñando el flujo de diálogo con el diseñador de flujos visual o en el modo YAML:
- Si utiliza el diseñador de flujos visual, puede agregar el primer estado de un componente incorporado a un flujo pasando el cursor sobre el mosaico Inicio, haciendo clic en el menú
, seleccionando Agregar estado de inicio y, a continuación, seleccionando una plantilla de componente en el cuadro de diálogo Agregar estado. Puede agregar estados posteriores seleccionando Agregar estado en el menú de un estado o haciendo clic en el icono Agregar un estado a esta transición entre dos estados. Consulte Diseño de flujos.
- Si está diseñando la aptitud en modo YAML, puede agregar un estado para un componente incorporado al flujo de diálogo seleccionando + Componentes y, a continuación, seleccionando una plantilla de componente en el menú.
Al validar el flujo de cuadro de diálogo, Digital Assistant verifica las propiedades del componente. Por ejemplo, se notifica la no inclusión de una propiedad necesaria.
Para obtener más información sobre las plantillas de componentes disponibles en el diseñador de flujos visual, consulte Plantillas de componentes.
Para obtener más información sobre los componentes disponibles en modo YAML, consulte Componentes incorporados: propiedades, transiciones y uso.
Componentes personalizados
La mayoría de las aptitudes necesitan integrarse con datos de sistemas remotos o realizar algún procesamiento de backend. Por ejemplo, es posible que una aptitud necesite obtener una lista de productos o guardar información de pedidos. Otro ejemplo podría ser que su aptitud necesitara ejecutar una lógica compleja para la que no se puede utilizar FreeMarker ni un manejador de eventos de entidad. Los componentes personalizados le permiten integrarse con backends, así como realizar tareas que quedan cubiertas en los componentes incorporados.
Para obtener más información sobre cómo crear un componente personalizado, consulte Implantación de componentes personalizados. Para obtener información sobre cómo agregar componentes personalizados para utilizarlos en su aptitud, consulte Adición de paquete de componente a una aptitud. Para obtener información sobre un componente personalizado que se ha agregado a la aptitud, vaya a la página Componentes de la aptitud , amplíe el servicio de componentes y seleccione el componente. Se muestran el nombre del componente, las propiedades y las acciones admitidas. Utilice esta información para crear el estado del componente en el flujo de diálogo.
Consejo:
Dado que es posible que los componentes de diferentes servicios tengan el mismo nombre, puede anteponer al nombre del componente el nombre del servicio seguido de dos puntos (:
) para asegurarse de que hace referencia de forma exclusiva a cada uno de los componentes personalizados que utiliza.
A continuación, se muestra un ejemplo de un estado de componente personalizado en un flujo de diálogo desarrollado en modo YAML. El componente hello.world
procede del servicio custom
.
start:
component: "custom:helloWorld"
properties:
human: "${human.value}"
transitions:
next: "askAge"
Al utilizar el servicio de componente incrustado para alojar los componentes personalizados, puede acceder a los logs de vista y los informes de bloqueo de los componentes desde la página Componentes . Seleccione el servicio y, a continuación, haga clic en Diagnósticos.
Otras Propiedades Disponibles para Componentes Personalizados en Modo YAML
Al desarrollar flujos de diálogo en modo YAML, puede incluir estas propiedades en el estado del componente personalizado además de las propiedades definidas por el componente.
Nombre | Descripción | ¿Obligatoria? |
---|---|---|
autoNumberPostbackActions |
Si se define en true , esta opción prefija números a las opciones de lista y botones. Aunque esta opción no se haya definido en true , se puede aplicar la numeración automática a elementos de tarjeta si la configuración de Activar numeración automática en acciones de devolución del asistente digital está definida en true . El valor por defecto es false .
|
Número |
insightsEndConversation |
Defina esta opción en true para dejar de grabar la conversación para la generación de informes de estadísticas. El valor por defecto es false .
|
Número |
insightsInclude |
Especifica si se debe incluir el estado en los informes de estadísticas. El valor por defecto es true .
|
Número |
translate |
Utilice esta propiedad para sustituir el valor booleano definido para la variable de contexto autotranslate . Si no ha definido la variable autotranslate o si la ha definido en false , puede definir esta propiedad en true para activar la traducción automática solo para este componente. Si define la variable autotranslation en true , puede definir esta propiedad en false para excluir este componente de la traducción automática. Consulte Servicios de traducción en aptitudes. El valor por defecto es el valor de la variable de contexto autotranslate .
|
Número |
Estas propiedades no están disponibles para los estados de los flujos de diálogo que desarrolle con el diseñador de flujos visual.