La page d'administration Gérer les workflows permet aux administrateurs Looker de gérer les workflows agentiques d'analyse conversationnelle créés par n'importe quel utilisateur de l'instance. La page "Administration" est accessible depuis la section Alertes et programmations du panneau Administration. La page d'administration Gérer les workflows liste des informations sur tous les workflows actifs et inactifs.
Pour afficher la page Gérer les workflows, vous devez disposer d'un rôle qui contient les autorisations see_schedules ou see_alerts et l'autorisation chat_with_agent.
Les utilisateurs peuvent consulter des informations sur les workflows qu'ils ont créés ou pour lesquels ils sont listés comme destinataires sur la page utilisateur Gérer les workflows, accessible depuis le menu de leur profil utilisateur.
Informations sur le workflow
La page d'administration Gérer les workflows fournit des informations sur tous les workflows de l'instance Looker. Les informations sur les workflows s'affichent dans l'onglet Workflows ou Anciens workflows, selon la date de création du workflow.
Workflows
L'onglet Workflows affiche les workflows agentiques actifs et désactivés créés dans Looker 26.14 ou version ultérieure.
| Colonne | Définition |
|---|---|
| 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. |
| Agent de données | Si la source de données associée au workflow est un agent de données, il s'agit du nom de l'agent qui a créé le workflow. |
| Propriétaire | Nom de l'utilisateur qui a créé le workflow. |
| Destination | Destination à laquelle la notification de workflow est envoyée. Les options sont "e-mail" ou "Slack". |
| Fréquence | Fréquence d'exécution 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. |
Anciens workflows
| 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 ont été 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. Pointez 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 désactive le workflow. 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 d'autres actions sur le workflow. Pour en savoir plus, consultez la section Gérer les workflows pour l'instance Looker sur cette page. |
Gérer les workflows pour l'instance Looker
La gestion des workflows peut impliquer les tâches suivantes :
- Gérer son état
- Afficher ses métadonnées sur la page Détails
- Surveiller son activité sur la page Activité
- Modifier ses conditions et ses seuils
Un menu Options est disponible pour chaque workflow. Il propose les sélections suivantes :
Workflows
- Modifier le workflow
- Historique
- Delete
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.
Cliquez sur Historique pour ouvrir la page Exécutions de workflow avec l'historique du workflow sélectionné.
Cliquez sur Supprimer pour supprimer le workflow. Si vous choisissez de supprimer le workflow, vous serez invité à confirmer votre choix.
Anciens workflows
- 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. Lorsque l'état d'un workflow est Actif, la requête du workflow continue de s'exécuter à 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 certains cas, 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 :
- Sur la page d'administration Gérer les workflows, recherchez le workflow à désactiver.
- Sélectionnez le menu Options du workflow.
- 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 affiche un récapitulatif des paramètres et de la configuration du workflow. Les informations affichées dépendent de la version de Looker dans laquelle le workflow a été créé (26.14 ou version ultérieure, onglet Workflows, ou version antérieure à 26.14, onglet Legacy Workflows).
Workflows
Lorsque vous sélectionnez Afficher le workflow dans le menu Options ou que vous cliquez sur le nom du workflow dans l'onglet Workflows, vous pouvez afficher et modifier les paramètres de configuration suivants :
- Source de données : source de données sous-jacente du workflow, qui peut être un agent (agent de données) ou des explorations spécifiques (comme
purchases). - Workflow : nom du workflow.
- Déclencheur : planification ou condition qui déclenche le workflow :
- Répéter : fréquence d'exécution (par exemple, Minutes, Toutes les heures, Tous les jours, Toutes les semaines ou Tous les mois).
- Jour : jour de la semaine ou du mois où le workflow s'exécute.
- Heure : heure spécifique de la journée à laquelle le workflow s'exécute.
- Directives : directives et instructions en langage naturel, étape par étape, que l'agent exécute à chaque exécution du workflow.
- Destination : options de livraison des résultats d'exécution du workflow. Chaque exécution crée une conversation visible dans Conversational Analytics. Voici d'autres options de livraison :
- E-mail : envoie le récapitulatif narratif en langage naturel, les tableaux de données et les rapports PDF aux destinataires spécifiés.
- Slack : envoie le résumé narratif, les blocs de données et les rapports PDF aux canaux Slack ou aux messages directs désignés.
- Liste des destinataires : ajoutez ou supprimez des adresses e-mail ou des destinations Slack individuelles.
Cliquez sur Enregistrer les modifications pour enregistrer les modifications apportées à la configuration du workflow.
Anciens workflows
Lorsque vous sélectionnez un workflow dans l'onglet Anciens workflows, la page Détails affiche les informations sur les anciennes alertes et planifications :
- Contexte sur les conditions qui déclenchent le workflow ou sur ce que signifie le déclenchement du workflow.
- Visualisation des résultats de requête du workflow.
- Menu Plus de la visualisation du workflow, qui inclut l'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 le propriétaire ou le destinataire de l'une des manières suivantes :
- Sélectionnez le menu Options du workflow, puis Afficher le workflow.
- Cliquez sur le nom du workflow.
Sur la page Détails, vous pouvez effectuer les tâches suivantes :
- Sélectionnez le champ de texte pour ajouter du contexte sur le workflow.
- 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.
- Sélectionnez Tester maintenant pour exécuter instantanément une requête de workflow, 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
Accéder à l'historique d'un workflow présente plusieurs avantages clés :
- Vérifiez que l'exécution et la diffusion ont réussi :
- Vérifiez si les exécutions planifiées ou les vérifications de seuil ont eu lieu à l'heure prévue.
- Affichez l'état de chaque exécution (Terminée, En cours d'exécution ou Erreur / Échec).
- Vérifiez les méthodes de diffusion et assurez-vous que les notifications ont bien été envoyées aux destinations prévues (e-mail ou Slack).
- Diagnostiquer et résoudre les erreurs :
- Examinez les messages d'erreur détaillés pour résoudre les problèmes suivants :
- Autorisations utilisateur manquantes (accès au modèle).
- Agents de données supprimées ou Explorations inaccessibles.
- Domaines de messagerie externes ou canaux Slack non autorisés.
- Délais de connexion intermittents ou retards de suppression de la file d'attente.
- Conditions de déclenchement de l'audit et fraîcheur des données :
- Vérification des conditions : vérifiez si les conditions de seuil ont été remplies ou dépassées lors de chaque exécution de l'évaluation.
- Fraîcheur des données : indique si les données de la base de données sous-jacente ont changé entre les exécutions (Fraîches : Oui ou Non). Cela permet d'éviter ou de diagnostiquer les alertes de workflow obsolètes.
- Surveillance des performances :
- Suivez la durée d'exécution des requêtes au fil du temps pour identifier la dégradation des performances, les requêtes lentes ou les goulots d'étranglement de la base de données.
- Auditabilité et conformité :
- Conservez un enregistrement clair des envois de rapports automatisés, des listes de destinataires et des journaux d'exécution dans votre équipe ou votre instance Looker.
Looker exécute une requête de workflow à la fréquence spécifiée. Pour les workflows déclenchés, il vérifie si leurs conditions ont été remplies. Les résultats de ces vérifications deviennent l'historique du workflow. Pour les anciens workflows, cet historique est visible sur la page Activité. Pour les workflows, cet historique est visible sur la page Exécutions de workflow du panneau d'administration.
Workflows
Vous pouvez accéder à la page Exécutions de workflow depuis la page d'administration Gérer les workflows en sélectionnant l'option Historique dans le menu Options.
Anciens workflows
Pour les anciens workflows, 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ée le | Code temporel du lancement de la requête de workflow | Tout code temporel au format DD/MM HH:MM05/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 |
|
| 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 |
|
| Heure de la 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:MMExemple : 05/25 16:01 |
| Condition remplie | Valeur booléenne indiquant si les conditions du workflow ont été remplies |
|
| Déclencheur | Valeur seuil qui déclenche le workflow si elle est atteinte ou dépassée | Toute valeur numérique |
| Observée | La valeur observée qui a rempli ou dépassé les conditions du workflow et qui l'a déclenché | Toute valeur numérique |
| Status | État de la requête de workflow |
|
Sur la page Activité, vous pouvez effectuer les tâches suivantes :
- Affichez la fréquence à laquelle la requête de workflow vérifie ses conditions.
- Affichez l'historique du workflow.
- 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é.
Messages d'erreur et d'avertissement du workflow
La page utilisateur Gérer les workflows affiche les erreurs ou les 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 vers lequel le workflow était envoyé a été déconnecté de l'instance Looker, si le canal Slack vers lequel le workflow était envoyé 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 non actualisée s'affiche.
Plusieurs raisons peuvent expliquer que les données n'aient 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.
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
- Mettre à jour les destinations de notification
- Mise à jour de la fréquence du workflow pour mieux l'adapter aux règles de mise en cache
Pour modifier les paramètres d'un workflow, procédez comme suit :
- Sur la page utilisateur Gérer les workflows, sélectionnez le menu Options du workflow que vous souhaitez modifier.
- Sélectionnez Modifier le workflow pour ouvrir la boîte de dialogue de modification du workflow.
- Modifiez les paramètres du workflow.
- Pour les anciens workflows, sélectionnez Enregistrer l'alerte pour enregistrer vos modifications. Pour les workflows, sélectionnez Enregistrer les modifications 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 à 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 à 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 à recevoir des notifications lorsque les conditions du workflow seront remplies.
Ressources associées
- Présentation de Conversational Analytics
- Paramètres d'administration – Workflows
- Créer un workflow agentique déclenché
- Créer un workflow agentique planifié