Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Votre équipe a probablement des tâches récurrentes telles que la vérification de l’intégrité du service chaque matin, l’examen des alertes de nuit, la vérification des expirations de certificat ou la publication de rapports de capacité hebdomadaires. Connectez vos outils, générez un flux de travail et laissez l’agent l’exécuter selon une planification.
Ce que vous avez accompli
- Connecter un outil de notification afin que l’agent puisse envoyer des messages
- Créer un agent personnalisé qui utilise cet outil
- Planifier un examen de santé récurrent qui s’exécute automatiquement
- Consultez le flux de travail complet sur l’Agent Canvas
Prerequisites
| Prérequis | Détails |
|---|---|
| Articles achevés | Créer, configurer et intégrer l’équipe. |
| Rôle de l’agent | Le rôle d’Administrateur Agent SRE couvre chaque étape de cet article. Les autres rôles ne couvrent qu’une partie du travail. Un Auteur peut créer l’agent personnalisé mais pas la tâche planifiée, et un Utilisateur Standard peut créer la tâche planifiée mais pas l’agent personnalisé. Ajouter un connecteur nécessite le rôle d’Administrateur . Voir Rôles et permissions utilisateurs. |
| Un compte depuis lequel envoyer | Un compte Microsoft 365 avec une boîte aux lettres Outlook active. L’agent se connecte à ce compte, et les rapports qu’il envoie arrivent depuis cette adresse. |
| Consentement à l’autorisation du connecteur | Si votre organisation limite les applications que les gens peuvent approuver, un administrateur pourrait devoir consentir à la connexion avant que le connecteur ne se connecte. |
| Contexte Azure pour cet exemple | Accès aux ressources Azure que la tâche vérifie. Un fournisseur de journalisation n’est nécessaire que si la tâche requiert des journaux. L'identité de l'agent nécessite des autorisations appropriées de contrôle d'accès basé sur le rôle (RBAC) Azure pour les données demandées. Voir les autorisations de l’agent. |
| Destinataire | Une adresse e-mail qui peut recevoir le rapport de test. |
Conseil / Astuce
Faites votre première enquête et Automatisez la réponse aux incidents ne sont pas nécessaires pour cet article, mais les réaliser d’abord vous permet de mieux comprendre ce que les flux de travail peuvent automatiser.
Fonctionnement
Automation connecte trois blocs de construction, chacun configuré via le portail :
| Bloc de construction | Qu’est-ce que cela fait ? | Exemple |
|---|---|---|
| Connecteur | Donne à l’agent l’accès à un service externe | Outlook, Teams, Datadog, Splunk |
| Agent personnalisé | Un travailleur spécialisé ayant accès à des outils spécifiques |
health-check-reporter avec l’autorisation d’envoyer des messages |
| Tâche planifiée | Déclenche un agent personnalisé selon une planification périodique | « Tous les matins à 8 h, vérifiez l'état de santé des ressources et envoyez un résumé » |
Dans le portail, le second bloc apparaît comme Agent des douanes.
La procédure pas à pas suivante montre comment créer un rapport de santé du matin envoyé par e-mail, mais les mêmes trois blocs s’appliquent aussi à d’autres tâches récurrentes. Modifiez les instructions et le planning pour consulter les alertes nocturnes, vérifier les expirations des certificats ou publier un résumé hebdomadaire de capacité. Un rapport hebdomadaire envoyé à une liste de distribution donne également à votre direction un dossier permanent que personne n’a à assembler à la main.
Ajouter un connecteur
Les connecteurs permettent à l’agent d’interagir avec les services externes. Commencez par un outil de notification pour que votre agent puisse signaler des résultats. Ces étapes permettent de configurer un connecteur Outlook. Pour Teams, voir Configurer un connecteur Teams.
Deux identités sont concernées avant de commencer. Votre connexion autorise l’agent à agir sur Outlook, c’est pourquoi le courrier qu’il envoie provient de votre compte. L’agent utilise sa propre identité managée attribuée par l’utilisateur pour atteindre Azure et collecter les données de ressources pour le rapport, de sorte que les rôles RBAC attribués à cette identité décident ce que le rapport peut inclure. Azure crée cette identité avec l'agent, donc vous n'en créez pas une ici. Pour plus d’informations, voir Identité de l’agent et permissions de l’agent.
- Allez dans Construire + configurer>Extensions>Connecteurs dans la navigation latérale.
- Sélectionnez Ajouter un connecteur.
- Sélectionnez l’onglet Notifications .
- Sélectionnez le connecteur Office 365 Outlook pour le service Microsoft Outlook.
- Sélectionnez Suivant.
- Connectez-vous et autorisez l’accès, puis sélectionnez Suivant.
- Dans Configurer les outils, sélectionnez l’opération d’envoi d’email. Le rail d’assistants étiquette cette étape Configurer les outils.
- Réglez son autorisation sur Demander.
- Activez la politique de paramètres pour l’opération d’envoi d’email.
- Dans le paramètre du destinataire ou To, saisissez l’adresse du destinataire indiquée dans les prérequis.
- Sélectionnez Suivant.
- Passez en revue la configuration, puis sélectionnez Créer.
Point de contrôle : Le connecteur apparaît dans la liste des connecteurs avec un statut de Connecté.
Important
Ask s’interrompt pour demander votre approbation au cours d’une discussion, mais une tâche planifiée exécutée en mode autonome appelle l’opération sans rien demander. Le verrouillage de l’adresse du destinataire permet d’éviter qu’une exécution sans surveillance n’envoie un e-mail à la mauvaise personne. Pour plus d’informations, consultez Modes d’exécution.
Conseil / Astuce
Vous pouvez également ajouter des connecteurs basés sur le protocole de contexte modèle (MCP) pour Datadog, Splunk, Elasticsearch, Dynatrace, New Relic et des serveurs MCP personnalisés. Voir les connecteurs MCP pour la liste complète.
Créer un agent personnalisé
Les agents personnalisés sont des travailleurs spécialisés ayant accès à des outils spécifiques. Vous les construisez et les connectez sur l’Agent Canvas, un schéma visuel de vos agents personnalisés, de leurs outils et des déclencheurs qui les déclenchent.
- Allez dans Construire + configurer>Flux de travail>Agent Canvas dans la navigation latérale.
- Sélectionnez Créer dans la barre d’outils, puis sélectionnez Agent personnalisé. La boîte de dialogue de création s’ouvre sur deux onglets, Formulaire et YAML.
- Renseignez les champs obligatoires :
-
Nom de l’agent personnalisé : par exemple,
health-check-reporter - Instructions : décrivez ce que fait cet agent des douanes et incluez le destinataire du rapport, par exemple : « Vous êtes un signaliste de contrôle médical. Vérifiez l’état des ressources Azure pour mes applications conteneurs et envoyez le résumé par email àops@example.com. »
-
Nom de l’agent personnalisé : par exemple,
- Sélectionnez Choisir des outils, puis sélectionnez l’outil d’envoi d’e-mails depuis votre connecteur ainsi que les outils Azure dont le rapport a besoin. Les outils sont les opérations individuelles que l’agent peut appeler. Choisir des outils ici remplace les paramètres par défaut de l’outil global pour cet agent personnalisé, et laisser la sélection vide lui permet d’hériter de tous les outils globaux. Voir Outils et Outils et compétences.
- Cliquez sur Créer.
De bonnes instructions indiquent la portée de l’examen, la vérification, et ce qu’il faut faire du résultat. L’instruction d’exemple fonctionne car elle indique quelles ressources consulter, lesquelles chercher, et où va le résumé, donc l’agent n’a pas à deviner l’un des trois. L’onglet YAML affiche la même définition que le texte, donc vous pouvez revoir ou copier ce que vous avez construit.
L’agent personnalisé apparaît comme un nœud sur la toile, et son opération Outlook sélectionnée apparaît dans un nœud toolbox, généralement avec un badge MCP.
Point de contrôle : La toile montre le nœud agent personnalisé et un nœud boîte à outils contenant l’outil Outlook sélectionné.
Conseil / Astuce
Le formulaire d’agent personnalisé vous permet aussi d’attribuer des compétences et des accroches. Les compétences sont des procédures réutilisables que l’agent charge lorsqu’elles sont pertinentes, et les hooks sont des mécanismes de contrôle qui s’exécutent avant ou après une action pour garantir qu’elle reste dans les limites prévues. Voir Créer un sous-agent pour la solution complète, les compétences et les accroches d’agent.
Planifier une tâche périodique
Liez une tâche planifiée à l’agent personnalisé afin qu’elle s’exécute automatiquement.
Sélectionnez le bouton + sur le côté de votre nœud d’agent personnalisé.
Sous le groupe Déclencheur , sélectionnez Ajouter une tâche planifiée. Le dialogue s’ouvre avec le sous-agent Réponse déjà défini sur cet agent.
Renseignez les champs :
Champ Exemple de valeur Nom de la tâche daily-health-reportSous-agent de réponse Votre agent de douane, déjà sélectionné Détails de la tâche Vérifiez l’état de santé des ressources dans mon groupe de ressources. Vérifiez que toutes les applications fonctionnent, vérifiez les métriques CPU et mémoire de la dernière heure, et examinez les journaux d’avertissements récents. Résumez les résultats et envoyez le rapport. Fréquence Quotidien Heure de la journée 8:00 du matin Sélectionnez Créer une tâche.
L’étiquette Heure de la journée indique le fuseau horaire dans lequel se trouve votre navigateur, comme Heure de la journée (PST), mais le planning est enregistré comme UTC sans fuseau horaire. La tâche s’exécute toujours à la même heure UTC, donc après un changement d’heure avancée, elle s’exécute une heure plus tôt ou plus tard que l’heure locale choisie. Si vous définissez la fréquence sur Personnalisé cron, le sélectionneur temporel est remplacé par un champ d’expression Cron (UTC ), et l’expression se lit comme UTC.
Chaque exécution consomme l’utilisation d’agents, et une tâche quotidienne continue de la consommer jusqu’à ce que vous la désactiviez. Choisissez la fréquence la plus basse qui vous donne toujours le signal dont vous avez besoin. Pour la manière dont l’utilisation est mesurée, voir Tarification et facturation.
La toile affiche désormais la chaîne complète du flux de travail.
Vérifiez le résultat
Exécutez la tâche immédiatement pour vérifier que tout fonctionne :
- Allez dans Automatisation dans la navigation latérale, où vous pouvez voir vos tâches planifiées. Les liens plus anciens vers la page des tâches planifiées redirigent ici.
- Sélectionnez la case à cocher à côté de votre tâche.
- Sélectionnez Exécuter maintenant dans la barre d’outils.
- Pour voir l’exécution, sélectionnez le nom de votre tâche pour ouvrir la vue des exécutions, puis sélectionnez le lien Nom du thread. Vous pouvez également trouver le thread sous Conversations dans la barre latérale.
Run soumet maintenant la requête d’exécution et actualise la liste des tâches. Ce que produit l’exécution, des vérifications d’état et des métriques jusqu’au rapport envoyé par e-mail, dépend des outils que vous avez sélectionnés, de l’accès de l’agent à vos ressources et à vos données de télémétrie, ainsi que du bon fonctionnement du connecteur.
Point de contrôle : Une exécution s’affiche pour la tâche. Si l’exécution résout un thread, la vue exécutions affiche un lien nom de thread . Sinon, il n’apparaît aucun fil de discussion trouvé. Si l’exécution réussit et invoque l’outil Outlook, vérifiez que le destinataire reçoit le rapport.
Si la tâche ne s’exécute pas
Une tâche programmée peut se terminer sans produire le résultat attendu. Commencez par l’historique des exécutions.
- Va dans Automatisation et sélectionne le nom de la tâche. Chaque ligne d’exécution affiche l’heure de début, un statut Succès ou Échec , et soit un lien nom de thread , soit Aucun thread trouvé. La ligne n’affiche pas de message d’erreur, alors ouvrez la discussion pour voir ce qui s’est passé.
- Ouvrez le fil le plus récent. Il montre comment l’agent a planifié le travail, quels outils il a appelés, et ce qu’il a conclu.
- Une exécution est marquée comme réussie une fois que son travail est transmis à un thread, de sorte qu’une exécution peut montrer Succès même si l’agent s’est ensuite arrêté, a mis en pause pour approbation ou a rencontré un appel d’outil raté. Lisez le fil avant de faire confiance au statut.
- Si aucune exécution n’apparaît, confirmez que le statut de la tâche est activé et vérifiez le temps d’exécution suivant.
| Ce que vous voyez | Cause la plus probable | Procédure à suivre |
|---|---|---|
| L’exécution indique Succès, mais aucun e-mail n’est reçu | L’opération d’e-mail n’est pas activée sur le connecteur, le paramètre destinataire est bloqué à une adresse différente, ou l’agent n’a jamais atteint l’étape d’envoi | Ouvrez le fil pour voir si l’agent a appelé l’outil Outlook. Ensuite, modifier le connecteur, confirmer que l’opération d’envoi est sélectionnée et vérifier la valeur verrouillée To |
| L’exécution montre Succès, et le fil attend l’approbation | Le niveau d’autonomie de l’agent de la tâche est Révision, donc l’agent fait une pause dans le fil avant d’agir | Ouvrez le thread et approuvez l’action en attente, ou modifiez la tâche et mettez le niveau d’autonomie de l’agent sur Autonome |
| L’exécution montre Aucun fil trouvé | L’exécution a échoué avant de créer un thread | Confirmez que le statut du connecteur est Connecté et que le sous-agent de réponse de la tâche existe toujours, puis sélectionnez Exécuter maintenant pour réessayer |
| Le connecteur n’est pas connecté | L’autorisation a expiré, ou le compte a perdu l’accès à la boîte aux lettres | Modifier le connecteur et se reconnecter à nouveau |
| Le rapport arrive sans aucune donnée de ressources | L’identité de l’agent n’a pas accès aux ressources que la tâche vérifie | Examinez les attributions décrites dans les autorisations de l’agent |
Pour plus de dépannage et de gestion des tâches, voir Créer et modifier des tâches planifiées.
Nettoyer les ressources
Après avoir vérifié le rapport, utilisez Désactiver ou Supprimer pour une tâche planifiée que vous ne prévoyez pas de conserver. Utilisez Retirer ou Déconnecter pour le connecteur. Révoquez la subvention Outlook OAuth quand elle ne sera plus nécessaire.
Vous avez terminé le parcours d'initiation
Vous avez construit un flux de travail de bout en bout. Un connecteur permet à votre agent de contacter Outlook, un agent personnalisé sait quoi vérifier et où le signaler, et une tâche planifiée gère toute la chaîne de façon autonome.
Votre agent peut désormais :
- Automatisez les flux de travail : exécutez des tâches planifiées via des agents personnalisés et des connecteurs.
- Utilisez le contexte de l’équipe : Utilisez les sources de connaissances et les détails de l’équipe que vous avez connectés lors de la configuration et de l’intégration.
Si vous aviez terminé votre première enquête, vous voyiez aussi l’agent diagnostiquer un problème en utilisant votre code, votre télémétrie et votre contexte Azure. Si vous avez complété Automate incident response, il détecte les alertes correspondant à un plan de réponse et les enquête sans qu’on le lui demande.
Fonctionnalités connexes
| Capability | Ce qu’il ajoute |
|---|---|
| Tâches planifiées | Options de planification avancées et gestion des tâches |
| Connecteurs | Comment les connecteurs fournissent des outils à votre agent |
| Agents personnalisés | Comment les agents personnalisés délèguent et se spécialisent |
Contenu connexe
Maintenant que vous êtes en place, explorez Concepts pour comprendre comment fonctionne l’agent, ou essayez un tutoriel pour des conseils pratiques sur les fonctionnalités avancées.
| Où aller | Ce que vous trouverez |
|---|---|
| Concepts | Fonctionnement des rôles, des autorisations, de la mémoire, des connecteurs et du raisonnement de l’agent |
| Capacités | Pages détaillées sur chaque fonctionnalité proposée par l’agent |
| Tutoriels | Guides pas à pas pour l’examen approfondi, les connecteurs, les crochets et bien plus encore |