Flows

Los diálogos complejos suelen incluir varios temas de conversación. Por ejemplo, un agente de reparto de pizzas puede tener pedidos de comida, información de clientes y confirmaciones como temas distintos. Cada tema requiere varias interacciones para que un agente obtenga la información pertinente del usuario final.

Los flujos se usan para definir estos temas y las rutas de conversación asociadas. Todos los agentes tienen un flujo llamado Flujo de inicio predeterminado. Este único flujo puede ser todo lo que necesites para un agente sencillo. Los agentes más complejos pueden requerir flujos adicionales, y diferentes miembros del equipo de desarrollo pueden encargarse de crear y mantener estos flujos. Por ejemplo, los flujos de un agente de reparto de pizzas pueden tener el siguiente aspecto:

Flujo de inicio predeterminado

Cuando creas un agente, se crea automáticamente el Flujo de inicio predeterminado. En el caso de un agente sencillo, puedes usar este flujo como único flujo. En el caso de los agentes más complejos, puedes añadir más flujos y el flujo de inicio predeterminado se puede usar como un punto de entrada sencillo a la conversación.

Nota: El flujo de inicio predeterminado no se puede eliminar.

Cuando uses la API, puedes hacer referencia al flujo de inicio predeterminado con el siguiente ID de flujo:

00000000-0000-0000-0000-000000000000

Página de inicio del flujo

Todos los flujos tienen una página especial llamada Inicio en la consola. Cuando se selecciona un flujo en la consola, la página de inicio se muestra como un nodo en el gráfico. Cuando un flujo se activa por primera vez, esta página se convierte en la página activa actual.

Una página de inicio no tiene parámetros ni mensajes de respuesta como las páginas normales. Sin embargo, puedes enviar un mensaje de una de las siguientes formas:

• Propagación de la intención
• Usa una true condición sencilla en una ruta que tenga una respuesta de cumplimiento o un destino de transición a una página normal con cumplimiento de entrada.
• Eventos personalizados

Referenciar la página de inicio en las solicitudes a la API

Para hacer referencia a la página de inicio de un flujo en las solicitudes de la API de tiempo de ejecución, usa START_PAGE como ID de página.

Para hacer cambios en el tiempo de diseño de una página de inicio a través de la API, usa los métodos de la API get y patch/update para el tipo Flow.

Ir a la referencia de la API Flow

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

Protocolo	V3	V3beta1
REST	Recurso de flujo	Recurso de flujo
RPC	Interfaz de flujo	Interfaz de flujo
C++	FlowsClient	No disponible
C#	FlowsClient	No disponible
Go	FlowsClient	No disponible
Java	FlowsClient	FlowsClient
Node.js	FlowsClient	FlowsClient
PHP	No disponible	No disponible
Python	FlowsClient	FlowsClient
Ruby	No disponible	No disponible

Close

Crear un flujo

Para crear un flujo, sigue estos pasos:

Consola

1. Abre la consola de Dialogflow CX.
2. Elige tu proyecto de Google Cloud.
3. Selecciona tu agente.
4. En la sección Flujos, haz clic en el botón de añadir .
5. Selecciona Crear flujo.
6. Introduce un nombre visible para el flujo.
7. Haz clic en el flujo que acabas de crear.

API

Consulta el método create del tipo Flow. Ir a la referencia de la API Flow

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

Protocolo	V3	V3beta1
REST	Recurso de flujo	Recurso de flujo
RPC	Interfaz de flujo	Interfaz de flujo
C++	FlowsClient	No disponible
C#	FlowsClient	No disponible
Go	FlowsClient	No disponible
Java	FlowsClient	FlowsClient
Node.js	FlowsClient	FlowsClient
PHP	No disponible	No disponible
Python	FlowsClient	FlowsClient
Ruby	No disponible	No disponible

Close

Datos de flujo

Para acceder a los datos de un flujo, siga estos pasos:

Consola

1. Abre la consola de Dialogflow CX.
2. Elige el proyecto de Google Cloud del agente.
3. Busca el agente en la lista.
4. Haz clic en el nombre visible del agente.
5. Haz clic en el flujo de la sección Flujos.
6. Las páginas del flujo se rellenan en la sección Páginas. Consulta la guía de páginas para obtener información sobre cómo editar páginas.
7. Haz clic en el flujo del gráfico.
8. Aparecerá un panel de edición de flujo. Usa este panel para consultar y editar datos de flujo adicionales.
9. Haz clic en Guardar para guardar los cambios.

API

En el caso de los flujos, consulta get y patch/update para el tipo Flow. Ir a la referencia de la API Flow

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

Protocolo	V3	V3beta1
REST	Recurso de flujo	Recurso de flujo
RPC	Interfaz de flujo	Interfaz de flujo
C++	FlowsClient	No disponible
C#	FlowsClient	No disponible
Go	FlowsClient	No disponible
Java	FlowsClient	FlowsClient
Node.js	FlowsClient	FlowsClient
PHP	No disponible	No disponible
Python	FlowsClient	FlowsClient
Ruby	No disponible	No disponible

Close

En el caso de las páginas, consulte los métodos get y patch/update del tipo Page. Ir a la referencia de la API Page

Selecciona un protocolo y una versión para la referencia de la página:

Protocolo	V3	V3beta1
REST	Recurso de página	Recurso de página
RPC	Interfaz de la página	Interfaz de la página
C++	PagesClient	No disponible
C#	PagesClient	No disponible
Go	PagesClient	No disponible
Java	PagesClient	PagesClient
Node.js	PagesClient	PagesClient
PHP	No disponible	No disponible
Python	PagesClient	PagesClient
Ruby	No disponible	No disponible

Close

Los siguientes datos están asociados a los flujos:

• Páginas: la lista de páginas que componen el flujo.
• Rutas: se puede llamar a todas estas rutas cuando la página de inicio del flujo esté activa. Las rutas con un requisito de intención se pueden seguir cuando otras páginas del flujo estén activas. Para obtener más información, consulta Ámbito del controlador de estado y Rutas a nivel de flujo.
• Gestores de eventos: se puede llamar a estos gestores cuando el flujo esté activo. Para obtener más información, consulta Gestores de eventos a nivel de flujo.

Para obtener más información sobre cómo se aplican los datos en los distintos niveles, consulta los niveles de aplicación de datos.

Configuración del flujo

Los siguientes ajustes están disponibles para los flujos:

• Nombre visible: nombre del flujo legible por humanos.
• Descripción: descripción del flujo.
• Ajustes de aprendizaje automático También se puede acceder a los ajustes de aprendizaje automático del flujo y se describen en los ajustes de aprendizaje automático del agente.
• Detección automática de idioma La detección automática de idioma te permite especificar en qué idiomas de los usuarios finales deben reconocer y responder automáticamente los agentes conversacionales (Dialogflow CX). Para obtener más información, consulta la documentación sobre la detección automática de idioma.

• Bloqueo de flujo: No se puede editar un flujo bloqueado, incluidos los siguientes cambios en sus recursos secundarios:

  1. No se pueden crear, editar ni eliminar páginas.
  2. Las versiones no se pueden crear, editar ni eliminar.
  3. Los grupos de rutas a nivel de flujo no se pueden crear, editar ni eliminar.
  4. Los grupos de rutas a nivel de agente a los que se haga referencia en un flujo bloqueado o en cualquier página de un flujo bloqueado no se pueden eliminar, pero sí se pueden editar.
  Nota: Este ajuste no se puede cambiar si el bloqueo está habilitado a nivel de agente.

• Ajustes de voz avanzados: Estos ajustes de voz avanzados pueden anular opcionalmente los mismos ajustes de voz del agente.

• Ajustes de adaptación de voz: ajustes de adaptación de voz a nivel de flujo con instrucciones más detalladas en la sección sobre la adaptación de voz manual.

• Parámetros de entrada: parámetros del cuaderno de estrategias de la tarea que se ponen a disposición del flujo.

• Parámetros de retorno: parámetros que el flujo devuelve a un cuaderno de estrategias de tareas.

Para obtener más información sobre cómo se aplican los datos en los distintos niveles, consulta los niveles de aplicación de datos.

Para acceder a los ajustes del flujo, sigue estos pasos:

Consola

1. Abre la consola de Dialogflow CX.
2. Elige tu proyecto de Google Cloud.
3. Selecciona tu agente.
4. Coloca el cursor sobre el flujo en la sección Flujos.
5. Haz clic en el botón de opciones .
6. Selecciona Configuración del flujo.
7. Consulta o edita los ajustes.
8. Haz clic en Guardar para guardar los cambios.

API

Consulta los métodos get y patch/update del tipo Flow. Ir a la referencia de la API Flow

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

Protocolo	V3	V3beta1
REST	Recurso de flujo	Recurso de flujo
RPC	Interfaz de flujo	Interfaz de flujo
C++	FlowsClient	No disponible
C#	FlowsClient	No disponible
Go	FlowsClient	No disponible
Java	FlowsClient	FlowsClient
Node.js	FlowsClient	FlowsClient
PHP	No disponible	No disponible
Python	FlowsClient	FlowsClient
Ruby	No disponible	No disponible

Close

Eliminar un flujo

Para eliminar un flujo, sigue estos pasos:

Consola

1. Abre la consola de Dialogflow CX.
2. Elige tu proyecto de Google Cloud.
3. Selecciona tu agente.
4. Coloca el cursor sobre el flujo en la sección Flujos.
5. Haz clic en el botón de configuración .
6. Selecciona Eliminar.

API

Consulta el método delete del tipo Flow. Ir a la referencia de la API Flow

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

Protocolo	V3	V3beta1
REST	Recurso de flujo	Recurso de flujo
RPC	Interfaz de flujo	Interfaz de flujo
C++	FlowsClient	No disponible
C#	FlowsClient	No disponible
Go	FlowsClient	No disponible
Java	FlowsClient	FlowsClient
Node.js	FlowsClient	FlowsClient
PHP	No disponible	No disponible
Python	FlowsClient	FlowsClient
Ruby	No disponible	No disponible

Close

Entrenar un flujo

Para entrenar un flujo, sigue estos pasos:

Consola

1. Abre la consola de Dialogflow CX.
2. Elige tu proyecto de Google Cloud.
3. Selecciona tu agente.
4. Haz clic en Configuración del agente.
5. Abre la pestaña ML.
6. Para entrenar un solo flujo, haga clic en Entrenar en la fila correspondiente.
7. Para entrenar varios flujos, selecciónalos con las casillas y, a continuación, haz clic en Entrenar el modelo de PLN del flujo seleccionado.

API

Consulta el método train del tipo Flow. Ir a la referencia de la API Flow

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

Protocolo	V3	V3beta1
REST	Recurso de flujo	Recurso de flujo
RPC	Interfaz de flujo	Interfaz de flujo
C++	FlowsClient	No disponible
C#	FlowsClient	No disponible
Go	FlowsClient	No disponible
Java	FlowsClient	FlowsClient
Node.js	FlowsClient	FlowsClient
PHP	No disponible	No disponible
Python	FlowsClient	FlowsClient
Ruby	No disponible	No disponible

Close

Exportar un flujo

Puedes exportar un flujo de dos formas:

• Exportación de datos: exporta tu flujo como datos sin procesar, por lo que se puede importar a cualquier agente. Cuando exportas un flujo, también se exportan los recursos a los que hace referencia (intenciones, entidades y webhooks). Cuando siga los pasos que se indican a continuación, elija el formato de datos datos sin procesar.

• Exportación de diagrama (vista previa): exporta tu flujo como un diagrama visual. El formato de exportación es XML de draw.io, por lo que puedes importar el diagrama en Lucidchart, diagrams.net o cualquier otra herramienta de diagramas que pueda importar el formato draw.io. Cuando sigas los pasos que se indican a continuación, elige el formato de datos XML.

  Nota: La exportación de diagramas no está disponible para los agentes que usen CMEK.

Puedes exportar un flujo con las siguientes opciones:

• Incluir flujos referenciados:exporta el flujo de destino y todos los niveles de flujos referenciados. Los flujos a los que se hace referencia incluyen los flujos a los que hace referencia el flujo de destino, además de los flujos a los que hacen referencia los flujos a los que se hace referencia posteriormente, sin una profundidad máxima. Durante la importación, se importarán todos los flujos exportados y se conservarán las transiciones entre ellos.

Para exportar un flujo, sigue estos pasos:

Consola

1. Abre la consola de Dialogflow CX.
2. Elige tu proyecto de Google Cloud.
3. Selecciona tu agente.
4. Coloca el cursor sobre el flujo en la sección Flujos.
5. Haz clic en el botón de opciones .
6. Selecciona Exportar flujo.
7. Sigue las instrucciones para completar el proceso.

API

Consulta el método export del tipo Flow. Ir a la referencia de la API Flow

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

Protocolo	V3	V3beta1
REST	Recurso de flujo	Recurso de flujo
RPC	Interfaz de flujo	Interfaz de flujo
C++	FlowsClient	No disponible
C#	FlowsClient	No disponible
Go	FlowsClient	No disponible
Java	FlowsClient	FlowsClient
Node.js	FlowsClient	FlowsClient
PHP	No disponible	No disponible
Python	FlowsClient	FlowsClient
Ruby	No disponible	No disponible

Close

Importar un flujo

Cuando importa un flujo de un agente de origen a un agente de destino, los recursos globales a los que hace referencia el flujo (intenciones, entidades y webhooks) se importan junto con los datos específicos del flujo. Si el agente de destino tiene recursos globales con los mismos nombres visibles que el agente de origen, Agentes conversacionales (Dialogflow CX) proporciona un resumen de estos recursos, junto con tres opciones para resolver los conflictos de estos recursos:

• Sustituir recursos: los recursos del agente de origen sobrescribirán los del agente de destino.
• Importar como recursos nuevos: los recursos del agente de origen se añadirán con un sufijo distintivo en el nombre.
• Conservar recursos originales: los recursos del agente de destino no cambiarán.

Para importar un flujo, sigue estos pasos:

Consola

1. Abre la consola de Dialogflow CX.
2. Elige tu proyecto de Google Cloud.
3. Selecciona tu agente.
4. En la sección Flujos, haz clic en el botón de añadir .
5. Selecciona Importar flujo.
6. Sigue las instrucciones para completar el proceso.

API

Consulta el método import del tipo Flow. Ir a la referencia de la API Flow

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

Protocolo	V3	V3beta1
REST	Recurso de flujo	Recurso de flujo
RPC	Interfaz de flujo	Interfaz de flujo
C++	FlowsClient	No disponible
C#	FlowsClient	No disponible
Go	FlowsClient	No disponible
Java	FlowsClient	FlowsClient
Node.js	FlowsClient	FlowsClient
PHP	No disponible	No disponible
Python	FlowsClient	FlowsClient
Ruby	No disponible	No disponible

Close