Gérer vos workflows agentiques

La page utilisateur Gérer les workflows vous permet de gérer et d'afficher des informations sur les workflows agentiques d'analyse conversationnelle actifs et inactifs que vous avez créés ou pour lesquels vous avez été ajouté en tant que destinataire.

Pour accéder à la page utilisateur Gérer les workflows, sélectionnez le menu Profil, puis Workflows. Cette page n'apparaît dans le menu de votre profil que si un administrateur Looker vous a accordé les autorisations create_alerts et see_alerts.

Informations sur le workflow

La page utilisateur Gérer les workflows fournit des informations sur les workflows dont vous êtes propriétaire ou pour lesquels vous êtes listé comme destinataire :

Colonne Définition
Nom du workflow Titre du workflow, défini par l'agent lors de son lancement. L'agent génère un titre de workflow par défaut en fonction du contenu de la conversation. Cliquez sur le nom du workflow pour ouvrir la page Détails de ce workflow.
Propriétaire Nom de l'utilisateur qui a créé le workflow.
Durée moy. d'exécution Durée de la requête de workflow en secondes.
Condition remplie Oui ou Non, selon que les conditions du workflow ont été remplies ou non lors de la dernière exécution de la requête du workflow. Le symbole -- s'affiche si la requête de workflow n'a pas encore été exécutée ou si elle a été exécutée, mais qu'il n'a pas été possible de déterminer si les conditions du workflow étaient remplies. Cette colonne affiche des icônes d'avertissement ou d'erreur liées aux avertissements ou erreurs qui s'affichent lorsque la requête de workflow est exécutée ou que la notification de workflow est envoyée. Placez le pointeur sur l'icône d'avertissement ou d'erreur pour afficher le message d'erreur associé, le cas échéant.

Une icône d'avertissement indiquant qu'un workflow est obsolète signifie que les données de la vignette du tableau de bord n'ont pas changé entre les deux dernières requêtes de workflow. Pour en savoir plus sur ce message, consultez la section Messages d'erreur et d'avertissement des alertes sur cette page.
Fréquence Fréquence à laquelle le workflow est exécuté pour vérifier si les conditions ont été remplies ou dépassées.
État Cette colonne indique si le workflow est actif ou désactivé.

Un workflow est marqué comme Désactivé lorsqu'un utilisateur désactive son propre workflow depuis sa page utilisateur ou lorsqu'un administrateur Looker le désactive. Si vous désactivez le workflow, les notifications seront mises en pause pour tous les destinataires.
Activité Lien vers la page Activité du workflow.
Menu Options Menu à partir duquel vous pouvez effectuer des actions supplémentaires sur le workflow. Pour en savoir plus, consultez la section Options de gestion des workflows sur cette page.

Gérer les workflows pour l'instance Looker

La gestion des workflows peut impliquer les tâches suivantes :

Un menu Options est disponible pour chaque workflow. Il inclut les options suivantes :

  • Afficher le workflow
  • Modifier le workflow
  • Désactiver le workflow (si le workflow est actif)
  • Activer le workflow (s'il est désactivé)

Cliquez sur Afficher le workflow pour ouvrir la page Détails.

Cliquez sur Modifier le workflow pour ouvrir et modifier les paramètres du workflow. Cliquez sur Enregistrer le workflow pour enregistrer vos modifications ou sur Annuler pour fermer la fenêtre d'édition sans enregistrer.

Gérer l'état d'un workflow

Bien que vous ne puissiez pas supprimer définitivement un workflow, vous pouvez contrôler s'il est actif ou non. Lorsque l'état d'un workflow est Actif, la requête du workflow continue de s'exécuter selon la fréquence spécifiée dans le workflow afin de vérifier si ses conditions ont été remplies. Si les conditions sont remplies, les destinataires du workflow sont avertis par la méthode de notification spécifiée dans le workflow. Lorsque l'état d'un workflow est défini sur Désactivé, aucune requête de workflow n'est exécutée et aucune notification n'est envoyée. La page Détails d'un workflow désactivé n'affiche aucun résultat dans la visualisation du workflow.

Dans certaines circonstances, un propriétaire de workflow ou un administrateur Looker peut avoir besoin de désactiver manuellement un workflow. Voici quelques exemples :

  • Suspendre temporairement les notifications de workflow pour reconfigurer les conditions de workflow
  • Résoudre les messages d'erreur ou d'avertissement
  • Résoudre les échecs de diffusion des notifications

Pour désactiver un workflow, procédez comme suit :

  1. Sur la page utilisateur Gérer les workflows, recherchez le workflow à désactiver.
  2. Sélectionnez le menu Options du workflow.
  3. Sélectionnez Désactiver le workflow.

Vous pouvez réactiver le workflow à tout moment en suivant ces étapes et en sélectionnant Activer le workflow.

Afficher les détails du workflow

La page Détails est une boîte de dialogue qui affiche un récapitulatif des informations sur le workflow. Vous pouvez y consulter les informations suivantes :

  • Contexte sur les conditions qui déclenchent le workflow ou sur ce que signifie le déclenchement du workflow.
  • Visualisation des résultats de la requête de workflow.
  • Menu Plus de la visualisation du workflow, qui comporte une option Explorer à partir d'ici. Sélectionnez cette option pour ouvrir une exploration prédéfinie avec la requête de workflow.
  • Le bouton Tester maintenant, qui exécute une requête de workflow instantanée.

Sur la page utilisateur Gérer les workflows, vous pouvez afficher la page Détails des workflows dont vous êtes propriétaire ou destinataire de l'une des manières suivantes :

  1. Sélectionnez le menu Options du workflow, puis Afficher le workflow.
  2. Cliquez sur le nom du workflow.

Sur la page Détails, vous pouvez effectuer les tâches suivantes :

  1. Sélectionnez le champ de texte pour ajouter du contexte sur le workflow.
  2. Sélectionnez le menu Plus, puis l'option Explorer à partir d'ici pour ouvrir une exploration préconfigurée avec la requête de workflow.
  3. Sélectionnez Tester maintenant pour exécuter une requête de workflow instantanément, sans avoir à attendre la fréquence spécifiée du workflow. Si les conditions du workflow sont remplies, une notification est envoyée à son propriétaire et à tous les destinataires supplémentaires.

Cliquez sur OK pour fermer la page Détails.

Surveiller l'activité des workflows

Looker exécute une requête de workflow à la fréquence spécifiée pour vérifier si ses conditions ont été remplies. Les résultats de ces vérifications deviennent l'historique du workflow, qui est visible sur la page Activité.

Le tableau de la page Activité inclut les informations suivantes sur chaque job de requête de workflow :

Titre Définition Valeurs possibles
Exécuté à Code temporel du lancement de la requête de workflow Tout code temporel au format DD/MM HH:MM

Exemple: 05/30 18:25
Durée d'exécution Durée d'exécution de la requête de workflow Toute durée au format 0.81s
Originale Valeur booléenne indiquant si la requête de workflow a vérifié les données qui ont changé entre les deux requêtes de workflow les plus récentes
  • Yes (si les données ont été modifiées)
  • No (si les données n'ont pas changé)
Source Origine des données à partir desquelles la requête du workflow a vérifié la valeur seuil indiquée dans les conditions du workflow
  • query
  • cache
  • stale cache
  • Si query, cache ou stale cache ne s'appliquent pas, la valeur Source sera vide.
Heure source Code temporel de la ligne de base de données à partir de laquelle la requête de workflow a vérifié la valeur de seuil Tout code temporel au format DD/MM HH:MM

Exemple : 05/25 16:01
Condition remplie Booléen indiquant si les conditions du workflow ont été remplies ou non
  • Yes (conditions remplies)
  • No (les conditions n'ont pas été remplies)
Déclencheur Valeur seuil qui déclenche le workflow si elle est atteinte ou dépassée N'importe quelle valeur numérique
Observé La valeur observée qui a respecté ou dépassé les conditions du workflow et qui l'a déclenché N'importe quelle valeur numérique
Status État de la requête de workflow
  • Complete
  • Running
  • Not Started

Sur la page Activité, vous pouvez effectuer les tâches suivantes :

  1. Affichez la fréquence à laquelle la requête de workflow vérifie ses conditions.
  2. Affichez l'historique du workflow.
  3. Utilisez le bouton Tester maintenant pour exécuter une requête de workflow instantanée. Si le workflow est déclenché, une notification est envoyée à son propriétaire et à tous les destinataires supplémentaires.

Cliquez sur OK pour fermer la page Activité.

Modifier les conditions du workflow

Dans certains cas, le propriétaire d'un workflow ou un administrateur Looker peut avoir besoin de modifier manuellement la configuration du workflow. Voici quelques exemples :

  • Activer ou désactiver l'analyse des facteurs clés optimisée par Gemini, qui s'affiche dans la notification
  • Ajuster les seuils et les conditions des métriques qui déclenchent le workflow à mesure que les besoins de l'organisation évoluent
  • Modifier les destinations des notifications
  • Mise à jour de la fréquence du workflow pour mieux s'aligner sur les règles de mise en cache

Pour modifier les paramètres d'un workflow, procédez comme suit :

  1. Sur la page Gérer les workflows, sélectionnez le menu Options du workflow que vous souhaitez modifier.
  2. Sélectionnez Modifier le workflow pour ouvrir la boîte de dialogue de modification du workflow.
  3. Modifiez les paramètres du workflow.
  4. Sélectionnez Enregistrer l'alerte pour enregistrer vos modifications.

Effet de la suppression d'agents, de conversations, d'explorations ou de tableaux de bord sur les workflows

La suppression d'un agent de données ou d'une conversation affecte le workflow associé de la manière suivante :

  • Si un utilisateur supprime la conversation avec l'agent qui génère le workflow, ce workflow reste actif. Tous les destinataires de notifications de workflow continueront de recevoir des notifications lorsque les conditions du workflow seront remplies.
  • Si un utilisateur supprime l'agent qui génère le workflow, celui-ci reste actif. Tous les destinataires de notifications de workflow continueront de recevoir des notifications lorsque les conditions du workflow seront remplies.
  • Si un utilisateur supprime l'exploration ou le tableau de bord contenant les données que le workflow surveille, ce workflow reste actif. Tous les destinataires de notifications de workflow continueront de recevoir des notifications lorsque les conditions du workflow seront remplies.

Messages d'erreur et d'avertissement concernant les workflows

La page utilisateur Gérer les workflows affiche les erreurs ou avertissements qui s'affichent lorsque le workflow est exécuté ou que la notification de workflow est envoyée. Le cas échéant, les messages d'erreur s'affichent lorsque vous pointez sur l'icône d'avertissement ou d'erreur dans la colonne Condition remplie.

Échec de l'envoi des notifications avec la configuration existante

Pour les workflows configurés pour envoyer des notifications à Slack ou à l'application mobile Looker, le message d'erreur Notification delivery failed with existing configuration s'affiche lorsque le workflow détermine que les conditions du workflow ont été remplies, mais que la notification n'a pas pu être envoyée. Cet échec peut se produire si la configuration Slack a changé depuis la création du workflow (par exemple, si l'espace de travail Slack auquel le workflow était associé a été déconnecté de l'instance Looker, si le canal Slack auquel le workflow était associé a été supprimé ou si Looker ne peut pas se connecter aux intégrations).

Avertissement : Interrogation de données récentes

Une icône d'avertissement dans la colonne Condition remplie indique que les données sur lesquelles le workflow est basé n'ont pas changé entre les deux dernières requêtes de workflow. Si vous pointez sur cette icône, le message Avertissement d'alerte obsolète s'affiche.

Il existe plusieurs raisons possibles pour lesquelles les données n'ont pas changé entre les requêtes. Si cet avertissement persiste, contactez votre développeur Looker pour vérifier que les règles de mise en cache définies pour les explorations de l'agent sont alignées sur le paramètre de fréquence du workflow.