Configuración del administrador: Workflows

En la página de administrador Administrar flujos de trabajo, los administradores de Looker pueden administrar los flujos de trabajo basados en agentes de Conversational Analytics que creó cualquier usuario en la instancia. Se puede acceder a la página de administrador desde la sección Alertas y programas del panel Administrador. En la página Administrador Administrar flujos de trabajo, se muestra información sobre todos los flujos de trabajo activos e inactivos.

Para ver la página Administrar flujos de trabajo, debes tener asignado un rol que contenga los permisos see_schedules o see_alerts y el permiso chat_with_agent.

Los usuarios pueden ver información sobre los flujos de trabajo que crearon o para los que se los incluye como destinatarios en la página de usuario Administrar flujos de trabajo, que está disponible en el menú de su perfil de usuario.

Información del flujo de trabajo

La página de administrador Administrar flujos de trabajo proporciona información sobre todos los flujos de trabajo en la instancia de Looker. La información del flujo de trabajo se muestra en la pestaña Flujos de trabajo o en la pestaña Flujos de trabajo heredados, según cuándo se creó el flujo de trabajo.

Workflows

En la pestaña Agentic Workflows, se muestran los Agentic Workflows activos y los inhabilitados que se crearon en Looker 26.14 o versiones posteriores.

Columna Definición
Flujo de trabajo Es el título del flujo de trabajo, que establece el agente cuando se inicia el flujo de trabajo. El agente genera un título predeterminado para el flujo de trabajo basado en el contenido de la conversación. Haz clic en el nombre del flujo de trabajo para abrir la página Detalles de ese flujo de trabajo.
Agente de datos Si la fuente de datos asociada al flujo de trabajo es un agente de datos, es el nombre del agente que creó el flujo de trabajo.
Propietario Nombre del usuario que creó el flujo de trabajo.
Destino Es el destino al que se envía la notificación del flujo de trabajo. Las opciones son correo electrónico o Slack.
Frecuencia Es la frecuencia con la que se ejecuta el flujo de trabajo.
Menú de opciones Un menú desde el que puedes realizar acciones adicionales en el flujo de trabajo. Obtén más información en la sección Opciones de administración del flujo de trabajo de esta página.

Flujos de trabajo heredados

Columna Definición
Nombre del flujo de trabajo Es el título del flujo de trabajo, que establece el agente cuando se inicia el flujo de trabajo. El agente genera un título predeterminado para el flujo de trabajo basado en el contenido de la conversación. Haz clic en el nombre del flujo de trabajo para abrir la página Detalles de ese flujo de trabajo.
Propietario Nombre del usuario que creó el flujo de trabajo.
Tiempo de ejecución prom. Duración de la consulta del flujo de trabajo en segundos.
Se cumplió la condición Un Sí o un No que indica si se cumplieron las condiciones del flujo de trabajo cuando se ejecutó la consulta del flujo de trabajo por última vez. Se muestra el símbolo -- si la consulta del flujo de trabajo aún no se ejecutó o si se ejecutó, pero no se pudo determinar si se cumplieron las condiciones del flujo de trabajo. En esta columna, se muestran íconos de advertencia o de error relacionados con las advertencias o los errores que surgen cuando se ejecuta la consulta del flujo de trabajo o se entrega la notificación del flujo de trabajo. Coloca el puntero sobre el ícono de advertencia o error para ver el mensaje de error asociado, si corresponde.

Un ícono de advertencia con una advertencia de flujo de trabajo inactivo indica que los datos del mosaico del panel no cambiaron entre las dos consultas de flujo de trabajo más recientes. Obtén más información sobre este mensaje en la sección Mensajes de error y advertencia de las alertas de esta página.
Frecuencia Es la frecuencia con la que se ejecuta el flujo de trabajo para verificar si se cumplieron o superaron las condiciones.
Estado En esta columna, se indica si el flujo de trabajo está activo o inhabilitado.

Un flujo de trabajo se marca como Inhabilitado cuando un usuario inhabilita su propio flujo de trabajo desde su página de usuario o cuando un administrador de Looker inhabilita el flujo de trabajo. Si inhabilitas el flujo de trabajo, se pausarán las notificaciones para todos los destinatarios del flujo de trabajo.
Actividad Un vínculo que te dirige a la página Actividad del flujo de trabajo
Menú de opciones Un menú desde el que puedes realizar acciones adicionales en el flujo de trabajo. Obtén más información en la sección Administra flujos de trabajo para la instancia de Looker en esta página.

Administra flujos de trabajo para la instancia de Looker

La administración del flujo de trabajo puede incluir las siguientes tareas:

En línea con cada flujo de trabajo, se encuentra un menú Opciones con las siguientes selecciones:

Workflows

  • Editar flujo de trabajo
  • Historial
  • Borrar

Haz clic en Editar flujo de trabajo para abrir y modificar la configuración del flujo de trabajo. Haz clic en Save Workflow para guardar los cambios o en Cancel para cerrar la ventana de edición sin guardar.

Haz clic en Historial para abrir la página Ejecuciones de flujo de trabajo con el historial del flujo de trabajo seleccionado.

Haz clic en Borrar para borrar el flujo de trabajo. Si decides borrar el flujo de trabajo, se te pedirá que confirmes tu elección.

Flujos de trabajo heredados

  • Ver flujo de trabajo
  • Editar flujo de trabajo
  • Inhabilitar flujo de trabajo (si el flujo de trabajo está activo)
  • Habilitar flujo de trabajo (si el flujo de trabajo está inhabilitado)

Haz clic en Ver flujo de trabajo para abrir la página Detalles.

Haz clic en Editar flujo de trabajo para abrir y modificar la configuración del flujo de trabajo. Haz clic en Save Workflow para guardar los cambios o en Cancel para cerrar la ventana de edición sin guardar.

Administra el estado de un flujo de trabajo

Si bien no puedes borrar un flujo de trabajo de forma permanente, puedes controlar si está activo. Cuando el Estado de un flujo de trabajo es Activo, la consulta del flujo de trabajo sigue ejecutándose según la frecuencia especificada en el flujo de trabajo para verificar si se cumplieron sus condiciones. Si se cumplen las condiciones, los destinatarios del flujo de trabajo reciben una notificación con el método especificado en el flujo de trabajo. Cuando el Estado de un flujo de trabajo es Inhabilitado, no se ejecutará ninguna consulta de flujo de trabajo ni se enviarán notificaciones. En la página Detalles de un flujo de trabajo inhabilitado, no se muestran resultados en la visualización del flujo de trabajo.

En algunas circunstancias, es posible que el propietario de un flujo de trabajo o el administrador de Looker deban inhabilitar un flujo de trabajo de forma manual, lo que puede incluir lo siguiente:

  • Pausar temporalmente las notificaciones de flujo de trabajo para reconfigurar las condiciones del flujo de trabajo
  • Soluciona problemas relacionados con mensajes de error o advertencias
  • Cómo resolver errores en la entrega de notificaciones

Para inhabilitar un flujo de trabajo, sigue estos pasos:

  1. En la página Administrador Administrar flujos de trabajo, busca el flujo de trabajo que se debe inhabilitar.
  2. Selecciona el menú Opciones del flujo de trabajo.
  3. Selecciona Disable Workflow.

Puedes volver a habilitar el flujo de trabajo en cualquier momento. Para ello, sigue estos pasos y selecciona Habilitar flujo de trabajo.

Cómo ver los detalles del flujo de trabajo

En la página Detalles, se muestra un resumen de la configuración del flujo de trabajo. La información que se muestra depende de si el flujo de trabajo se creó en Looker 26.14 o versiones posteriores (pestaña Workflows) o en versiones anteriores a la 26.14 (pestaña Legacy Workflows).

Workflows

Cuando seleccionas Ver flujo de trabajo en el menú Opciones o haces clic en el nombre del flujo de trabajo en la pestaña Flujos de trabajo, puedes ver y editar los siguientes parámetros de configuración del flujo de trabajo:

  • Fuente de datos: Es la fuente de datos subyacente del flujo de trabajo, ya sea un agente (agente de datos) o Exploraciones específicas (como purchases).
  • Flujo de trabajo: Es el nombre del flujo de trabajo.
  • Activador: Es la programación o la condición que inicia el flujo de trabajo:
    • Repetir: Es la frecuencia de ejecución (por ejemplo, Minutos, Por hora, Diariamente, Semanalmente o Mensualmente).
    • Día: Es el día de la semana o del mes en el que se ejecuta el flujo de trabajo.
    • Hora: Hora específica del día en la que se ejecuta el flujo de trabajo.
  • Directivas: Son las directivas e instrucciones paso a paso en lenguaje natural que el agente ejecuta durante cada ejecución del flujo de trabajo.
  • Destino: Son las opciones de entrega de los resultados de la ejecución del flujo de trabajo. Cada ejecución crea una conversación nueva visible en Conversational Analytics. Las opciones de publicación adicionales incluyen las siguientes:
    • Correo electrónico: Envía el resumen narrativo en lenguaje natural, las tablas de datos y los informes en PDF a los destinatarios de correo electrónico especificados.
    • Slack: Entrega el resumen narrativo, los bloques de datos y los informes en PDF a los canales de Slack o mensajes directos designados.
    • Lista de destinatarios: Agrega o quita direcciones de correo electrónico de destinatarios individuales o destinos de Slack.

Haz clic en Guardar cambios para guardar las modificaciones en la configuración del flujo de trabajo.

Flujos de trabajo heredados

Cuando seleccionas un flujo de trabajo en la pestaña Flujos de trabajo heredados, la página Detalles muestra información heredada sobre las alertas y la programación:

  • Contexto sobre qué condiciones activan el flujo de trabajo o qué significa que se active.
  • Es una visualización de los resultados de la consulta del flujo de trabajo.
  • El menú Más en la visualización del flujo de trabajo, que tiene una opción para Explorar desde aquí. Selecciona esta opción para abrir una exploración preconfigurada con la consulta del flujo de trabajo.
  • El botón Probar ahora, que ejecuta una consulta instantánea del flujo de trabajo

En la página de usuario Administrar flujos de trabajo, puedes ver la página Detalles de los flujos de trabajo que te pertenecen o de los que eres destinatario de una de las siguientes maneras:

  1. Selecciona el menú Opciones del flujo de trabajo y, luego, Ver flujo de trabajo.
  2. Haz clic en el nombre del flujo de trabajo.

En la página Detalles, puedes realizar las siguientes tareas:

  1. Selecciona el campo de texto para agregar contexto sobre el flujo de trabajo.
  2. Selecciona el menú Más y, luego, la opción Explorar desde aquí para abrir una función Explorar preestablecida con la consulta del flujo de trabajo.
  3. Selecciona Probar ahora para ejecutar una consulta de flujo de trabajo al instante, sin tener que esperar la frecuencia especificada del flujo de trabajo. Si se cumplen las condiciones del flujo de trabajo, se enviará una notificación a su propietario y a los destinatarios adicionales.

Haz clic en Listo para cerrar la página Detalles.

Supervisa la actividad del flujo de trabajo

Acceder al historial de un flujo de trabajo ofrece varias ventajas clave:

  • Verifica que la ejecución y la entrega se hayan realizado correctamente:
    • Confirma si las ejecuciones programadas o las verificaciones de umbral se realizaron a tiempo.
    • Consulta el estado de cada ejecución (Completada, En ejecución o Error / Con errores).
    • Verifica los métodos de entrega y confirma que las notificaciones llegaron a los destinos previstos (correo electrónico o Slack).
  • Diagnostica y soluciona errores:
    • Inspecciona los mensajes de error detallados para resolver problemas como los siguientes:
    • Faltan permisos del usuario (acceso al modelo).
    • Se borraron agentes de datos o no se puede acceder a los Exploradores.
    • Dominios de correo electrónico externos o canales de Slack no autorizados
    • Tiempos de espera de conexión intermitentes o demoras en la eliminación de la cola
  • Condiciones de activación de la auditoría y actualidad de los datos:
    • Verificaciones de condiciones: Consulta si se cumplieron o superaron las condiciones de umbral durante cada ejecución de la evaluación.
    • Actualidad de los datos: Identifica si los datos de la base de datos subyacente cambiaron entre ejecuciones (Actuales: Sí o No), lo que ayuda a prevenir o diagnosticar alertas de flujo de trabajo obsoletas.
  • Supervisión del rendimiento:
    • Realiza un seguimiento de la duración del tiempo de ejecución de las consultas a lo largo del tiempo para identificar la degradación del rendimiento, las consultas de ejecución lenta o los cuellos de botella de la base de datos.
  • Auditabilidad y cumplimiento:
    • Mantén un registro claro de las entregas de informes automatizados, las listas de destinatarios y los registros de ejecución en todo tu equipo o instancia de Looker.

Looker ejecuta una consulta de flujo de trabajo con la frecuencia especificada. En el caso de los flujos de trabajo activados, verifica si se cumplieron sus condiciones. Los resultados de estas verificaciones se convierten en el historial del flujo de trabajo. En el caso de los flujos de trabajo heredados, este historial se puede ver en la página Actividad. En el caso de los flujos de trabajo, este historial se puede ver en la página Ejecuciones de flujo de trabajo del panel de administración.

Workflows

Puedes acceder a la página Ejecuciones de flujo de trabajo desde la página Administrador Administrar flujos de trabajo. Para ello, selecciona la opción Historial en el menú Opciones.

Flujos de trabajo heredados

En el caso de los flujos de trabajo heredados, la tabla de la página Actividad incluye la siguiente información sobre cada trabajo de consulta del flujo de trabajo:

Encabezado Definición Valores posibles
Fecha y hora de ejecución Es la marca de tiempo del momento en que se inició la consulta del flujo de trabajo. Cualquier marca de tiempo en el formato DD/MM HH:MM

Ejemplo: 05/30 18:25
Hora y fecha de ejecución Cuánto tiempo tardó en ejecutarse la consulta del flujo de trabajo Cualquier duración en el formato 0.81s
Fresh Es un valor booleano que indica si la consulta del flujo de trabajo verificó datos que habían cambiado entre las dos consultas del flujo de trabajo más recientes.
  • Yes (si cambiaron los datos)
  • No (si los datos no cambiaron)
Fuente Origen de los datos a partir de los cuales la consulta del flujo de trabajo verificó el valor del umbral que se indicó en las condiciones del flujo de trabajo
  • query
  • cache
  • stale cache
  • Si no se aplican query, cache o stale cache, el valor de Source estará en blanco.
Hora de origen Es la marca de tiempo de la fila de la base de datos desde la que la consulta del flujo de trabajo verificó el valor del umbral. Cualquier marca de tiempo en el formato DD/MM HH:MM

Ejemplo: 05/25 16:01
Se cumplió la condición Es un valor booleano que indica si se cumplieron las condiciones del flujo de trabajo.
  • Yes (se cumplieron las condiciones)
  • No (no se cumplieron las condiciones)
Activador Es el valor de umbral que activaría el flujo de trabajo si se alcanza o supera. Cualquier valor numérico
Observado Es el valor observado que cumplió o superó las condiciones del flujo de trabajo y lo activó. Cualquier valor numérico
Estado Es el estado de la consulta del flujo de trabajo.
  • Complete
  • Running
  • Not Started

En la página Actividad, puedes realizar las siguientes tareas:

  1. Consulta la frecuencia con la que la consulta del flujo de trabajo verifica sus condiciones.
  2. Consulta el historial del flujo de trabajo.
  3. Usa el botón Probar ahora para ejecutar una consulta instantánea del flujo de trabajo. Si se activa el flujo de trabajo, se enviará una notificación a su propietario y a los destinatarios adicionales.

Haz clic en Listo para cerrar la página Actividad.

Mensajes de error y advertencia del flujo de trabajo

En la página de usuario Administrar flujos de trabajo, se muestran los errores o las advertencias que surgen cuando se ejecuta el flujo de trabajo o se entrega la notificación del flujo de trabajo. Si corresponde, los mensajes de error aparecen cuando mantienes el puntero sobre el ícono de advertencia o el ícono de error en la columna Condición cumplida.

No se pudo entregar la notificación con la configuración existente

En el caso de los flujos de trabajo configurados para enviar notificaciones a Slack o a la app para dispositivos móviles de Looker, aparece el mensaje de error Notification delivery failed with existing configuration cuando el flujo de trabajo determina que se cumplieron las condiciones del flujo de trabajo, pero no se pudo enviar la notificación. Este error puede ocurrir si cambió algo en la configuración de Slack desde que se creó el flujo de trabajo, por ejemplo, si el espacio de trabajo de Slack al que se enviaba el flujo de trabajo se desconectó de la instancia de Looker, si se borró el canal de Slack al que se enviaba el flujo de trabajo o si Looker no se puede conectar a las integraciones.

Advertencia: Se consultan datos actualizados

Un ícono de advertencia en la columna Condición cumplida indica que los datos en los que se basa el flujo de trabajo no cambiaron entre las dos consultas de flujo de trabajo más recientes. Si mantienes el puntero sobre este ícono, se mostrará el mensaje Advertencia de alerta por inactividad.

Existen algunas explicaciones posibles de por qué los datos no cambiaron entre las búsquedas. Si esta advertencia persiste, habla con tu desarrollador de Looker para verificar que las políticas de almacenamiento en caché definidas para los Explorar del agente estén alineadas con el parámetro de configuración de frecuencia del flujo de trabajo.

Cómo modificar las condiciones del flujo de trabajo

En algunas circunstancias, es posible que el propietario del flujo de trabajo o el administrador de Looker deban modificar la configuración del flujo de trabajo de forma manual, lo que puede incluir lo siguiente:

  • Habilitar o inhabilitar el análisis de los factores clave potenciado por Gemini, que aparece en la notificación
  • Ajustar los umbrales y las condiciones de las métricas que activan el flujo de trabajo a medida que evolucionan las necesidades de la organización
  • Actualiza los destinos de las notificaciones
  • Actualizamos la frecuencia del flujo de trabajo para que se alinee mejor con las políticas de almacenamiento en caché

Para modificar la configuración de un flujo de trabajo, sigue estos pasos:

  1. En la página de usuario Administrar flujos de trabajo, selecciona el menú Opciones del flujo de trabajo que deseas modificar.
  2. Selecciona Edit Workflow, que abre el diálogo de edición del flujo de trabajo.
  3. Realiza los cambios en la configuración del flujo de trabajo.
  4. En el caso de los flujos de trabajo heredados, selecciona Guardar alerta para guardar los cambios. En el caso de los flujos de trabajo, selecciona Guardar cambios para guardar los cambios.

Efecto de borrar agentes, conversaciones, exploraciones o paneles en los flujos de trabajo

Borrar un agente de datos o una conversación afecta el flujo de trabajo asociado de las siguientes maneras:

  • Si un usuario borra la conversación con el agente que genera el flujo de trabajo, este permanecerá activo. Todos los destinatarios de las notificaciones del flujo de trabajo seguirán recibiendo notificaciones cuando se cumplan las condiciones del flujo de trabajo.
  • Si un usuario borra el agente que genera el flujo de trabajo, este permanecerá activo. Todos los destinatarios de las notificaciones del flujo de trabajo seguirán recibiendo notificaciones cuando se cumplan las condiciones del flujo de trabajo.
  • Si un usuario borra la exploración o el panel que contiene los datos que supervisa el flujo de trabajo, este permanecerá activo. Todos los destinatarios de las notificaciones del flujo de trabajo seguirán recibiendo notificaciones cuando se cumplan las condiciones del flujo de trabajo.