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.
Le serveur MCP Azure vous aide à gérer les ressources Azure SRE Agent, notamment pour : activer, ajouter, appliquer, créer, désactiver, supprimer, générer, récupérer, enquêter, kusto, lister, mcp, message, pagerduty, mettre en pause, plan, réindexer, reprendre, rechercher, servicenow, tester, valider et yolo, à l’aide de requêtes en langage naturel.
Azure SRE Agent est un assistant de fiabilité alimenté par l’IA qui aide les équipes à diagnostiquer et résoudre les problèmes de production, à réduire les risques opérationnels et à réduire le temps moyen de résolution (MTTR). Pour plus d’informations, consultez la documentation de l’agent SRE Azure.
Note
Paramètres de l’outil : les outils Azure MCP Server définissent des paramètres pour les données dont ils ont besoin pour effectuer des tâches. Certains de ces paramètres sont spécifiques à chaque outil et sont documentés ici. D’autres paramètres sont globaux et partagés par tous les outils. Pour plus d’informations, consultez Paramètres de l’outil.
Agents : Créer ou mettre à jour un sous-agent
Cet outil crée ou met à jour un sous-agent sur une ressource SRE Agent ciblée. Spécifiez l’abonnement, l’agent et le nom pour identifier le sous-agent. L’outil applique des modifications de manière idempotente, de sorte que les requêtes répétées avec les mêmes valeurs ne créent pas de doublons. Fournissez les paramètres requis pour créer ou mettre à jour le sous-agent.
Voici quelques exemples d'instructions :
- « Créez un sous-agent avec le nom « subagent-01 » sur SRE Agent 'sre-agent-prod'.
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
| Description | Optional | Une description de l’élément Agent SRE. |
| Instructions | Optional | Instructions pour le sous-agent. |
| Outils | Optional | Noms d’outils à joindre. Plusieurs valeurs sont prises en charge. |
| Transferts | Optional | Noms de transfert des sous-agents. Plusieurs valeurs sont prises en charge. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Agents : supprimer un sous-agent
Cet outil supprime un sous-agent d’une ressource SRE Agent ciblée.
Voici quelques exemples d'instructions :
- « Supprime le sous-agent nommé "telemetry-agent" de l’agent SRE "prod-sre" dans l’abonnement "12345-abcde" avec le paramètre de confirmation "true". »
- « Supprime le sous-agent "backup-monitor" de l’agent SRE "staging-sre" dans l’abonnement "my-subscription-id" avec confirmation "true". »
- « Supprime le nom du sous-agent "subagent-01" de l’agent SRE "sre-agent-prod" avec confirmation "true". »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
| Confirmer | Obligatoire | Confirmez une opération destructrice. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Agents : obtenir les détails de configuration
Affichez les détails de configuration d’un agent SRE nommé. Cet outil retourne le point de terminaison, l’état d’approvisionnement, l’emplacement et les paramètres de l’agent SRE spécifié. Vous pouvez filtrer les résultats par groupe de ressources.
Voici quelques exemples d'instructions :
- « Afficher les détails de l’agent SRE 'sre-agent-north' dans le groupe de ressources 'rg-sre-prod'. »
- « Vérifiez la configuration de l’agent SRE 'sre-agent-eastus' dans le groupe de ressources 'prod-rg'. »
- « Affiche le point de terminaison et l’état d’approvisionnement de l’agent SRE " ops-agent-west" dans l’abonnement spécifié. »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Agents : répertorier les ressources
Cet outil répertorie les ressources de l’agent SRE Azure. Vous pouvez filtrer les résultats par groupe de ressources. Chaque résultat comprend name, , idlocation, resourceGroup, provisioningState, et endpoint. Si l’outil ne trouve aucune ressource agent SRE, il retourne une liste vide.
Voici quelques exemples d'instructions :
- Lister les ressources Azure SRE Agent dans mon abonnement.
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Outils agents : Créer ou mettre à jour un outil personnalisé
Cet outil crée ou met à jour un outil personnalisé sur une ressource SRE Agent cible. Vous spécifiez l’agent, le nom et le type d’outil. Si un outil portant le nom spécifié existe, cet outil met à jour sa configuration ; sinon, il crée un outil. Fournissez des valeurs de configuration en fonction de la table de paramètres.
Voici quelques exemples d'instructions :
- « Crée un outil personnalisé "log-collector" sur l’agent "sre-agent-prod" dans l’abonnement "contoso-sub" avec le type d’outil "collector". »
- « Créer un outil personnalisé avec le nom « custom-kusto-tool », type d’outil « KustoTool », sur SRE Agent 'sre-agent-prod'.
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
| Type d’outil | Obligatoire | Type d’outil personnalisé, tel que KustoTool ou LinkTool. |
| Connecteur | Optional | Nom du connecteur pour les outils Kusto. |
| Nom de la base de données | Optional | Base de données Kusto pour les outils Kusto. |
| Description | Optional | Une description de l’élément Agent SRE. |
| Paramètres | Optional | Tableau JSON de définitions de paramètres d’outil. |
| Query | Optional | La requête Kusto destinée aux outils Kusto. |
| Modèle d’URL | Optional | Modèle d’URL pour les outils de lien. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Outils agents : Obtenir une définition d’outil personnalisée
Obtient une définition d’outil personnalisée à partir d’une ressource sRE Agent ciblée. Cet outil nécessite les paramètres d’agent et de nom et retourne la définition d’outil personnalisée pour l’agent et le nom spécifiés.
Voici quelques exemples d'instructions :
- « Obtenez la définition du nom d’outil personnalisé « deploy-helper » à partir de SRE Agent 'sre-agent-prod'.
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Outils Agents : Répertorier les outils
Cet outil répertorie les outils personnalisés sur une ressource SRE Agent ciblée. Elle retourne le nom, la version et l’état de chaque outil personnalisé, afin de pouvoir vérifier les déploiements et résoudre les problèmes.
Voici quelques exemples d'instructions :
- « Répertorier les outils personnalisés sur SRE Agent 'sre-agent-prod'. »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Architecture : planifier une architecture
Planifiez et générez une architecture d’agent de fiabilité de site (SRE). Cet outil analyse vos besoins et produit une conception structurée pour les agents, les outils, les connecteurs et les déclencheurs. Vous fournissez des exigences et des contraintes générales, et cet outil retourne les responsabilités des composants, les modèles d’interaction, les considérations relatives au déploiement, les recommandations en matière de sécurité et de contrôle d’accès et les suggestions d’observabilité. Utilisez la sortie pour guider l’implémentation, la sélection des outils et la planification de l’intégration.
Les sorties sont les suivantes :
- Liste de composants avec responsabilités et limites.
- Définitions de connecteur et de déclencheur pour les intégrations.
- Considérations relatives au déploiement et à la scalabilité, y compris les recommandations régionales et d’orchestration.
- Conseils en matière de sécurité et de contrôle d’accès en fonction du rôle (RBAC).
- Modèles de réponse à l’observabilité et aux incidents, y compris les suggestions de surveillance et d’alerte.
Voici quelques exemples d'instructions :
- Concevez une architecture d’un agent SRE répondant aux exigences suivantes : « observabilité multilocataire avec tri automatisé des incidents et intégration à Kusto ».
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Exigences | Obligatoire | Exigences en matière d’architecture. |
| Connecteur Kusto | Optional | Nom du connecteur Kusto. |
| Type de déclencheur | Optional | Type de déclencheur, tel que manuel ou planifié. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Invites courantes : Créer ou mettre à jour une invite
Cet outil crée ou met à jour un prompt commun nommé dans l’agent SRE. Il enregistre des modèles d’invite réutilisables, afin que les équipes puissent centraliser les conseils et réduire la duplication. L’outil retourne l’objet d’invite créé ou mis à jour.
Voici quelques exemples d'instructions :
- « Créez une invite commune avec le nom « restart-service » et le contenu « Décrire comment redémarrer le service d’application pendant un incident » sur SRE Agent 'sre-agent-prod'.
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Contenu | Obligatoire | Le contenu de l’instruction. |
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |
Invites courantes : Supprimer une invite
Cet outil supprime définitivement la requête identifiée par le nom d’un agent SRE. Vous confirmez la suppression avant que l’outil ne supprime la définition du prompt. Cette action n’est pas réversible.
Voici quelques exemples d'instructions :
- « Supprime définitivement le nom commun de la requête "cpu-throttle-guidance" de l’agent SRE "sre-agent-westus" avec confirmation définie sur "true". »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Confirmer | Obligatoire | Confirmez une opération destructrice. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Invites courantes : Obtenir le texte de l’invite
Cet outil affiche le texte complet d’une requête courante spécifiquement nommée pour un agent d’ingénierie de fiabilité des sites (SRE). Vous fournissez le nom, et cet outil renvoie le texte du prompt afin que vous puissiez inspecter ou auditer les prompts à des fins de débogage ou de révision.
Voici quelques exemples d'instructions :
- « Affiche-moi la requête courante portant le nom "deploy-checklist" de l’agent SRE "sre-agent-westus". »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Invites courantes : invites de liste
Cet outil répertorie toutes les commandes courantes disponibles sur un agent SRE. Elle renvoie une collection de noms et de descriptions de prompts enregistrés. Les résultats vous aident à découvrir les requêtes disponibles et à passer en revue leurs descriptions.
Voici quelques exemples d'instructions :
- « Liste les requêtes courantes de l’agent SRE "sre-agent-prod". »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Recherche | Optional | Filtre de recherche facultatif. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Connecteurs : Créer ou mettre à jour le connecteur Kusto
Cet outil crée ou met à jour un connecteur pour Azure Data Explorer (Kusto) sur une ressource de l’agent SRE Azure. Le connecteur permet à l’agent d’ingérer et d’interroger des données à partir d’un cluster Azure Data Explorer.
Voici quelques exemples d'instructions :
- Créez un connecteur Kusto sur l’agent SRE « sre-agent-01 » avec l’URL de cluster « https://my-resource.eastus.kusto.windows.net » et le nom « kusto-connector-prod ».
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Cluster URL | Obligatoire | URL du cluster Azure Data Explorer. |
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
| Nom de la base de données | Optional | Base de données Kusto pour les outils Kusto. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Connecteurs : Créer ou mettre à jour un connecteur
Cet outil crée ou met à jour un connecteur sur une ressource de l’agent SRE Azure. Vous spécifiez l’agent, le nom du connecteur et le type de connecteur. Vous pouvez également fournir des informations d’identification de connexion et des paramètres de configuration supplémentaires. En cas de réussite, cet outil retourne la ressource du connecteur.
Suivez les conventions de dénomination Azure pour les noms de ressources, et assurez-vous que les autorisations de contrôle d’accès en fonction du rôle (RBAC) permettent les mises à jour du connecteur. Utilisez des noms réalistes tels que sre-agent-prod l’agent et rg-sre-prod le groupe de ressources.
Voici quelques exemples d'instructions :
- « Créez un connecteur MCP sur SRE Agent 'sreagent-prod' avec le nom « mcp-connector » et tapez « http ».
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
| Type | Obligatoire | Type de connecteur MCP : stdio ou http. |
| Arguments | Optional | Arguments pour les connecteurs MCP stdio. |
| Type d’authentification | Optional | Type d’authentification du connecteur HTTP MCP. |
| Environnement du jeton du porteur | Optional | Variable d’environnement contenant le jeton du porteur. |
| Commande | Optional | Commande pour les connecteurs stdio MCP. |
| Point de terminaison | Optional | Point de terminaison du connecteur HTTP MCP. |
| Envs JSON | Optional | Objet JSON des variables d’environnement pour les connecteurs MCP stdio. |
| En-têtes JSON | Optional | Objet JSON d’en-têtes HTTP. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ | ✅ | ❌ |
Connecteurs : Supprimer le connecteur
Cet outil supprime un connecteur d’une ressource Azure agent SRE.
Voici quelques exemples d'instructions :
- « Supprime le connecteur "metrics-collector" de l’agent SRE "sre-agent-prod" avec confirmation sur "true". »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
| Confirmer | Obligatoire | Confirmez une opération destructrice. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Connecteurs : obtenir les détails du connecteur
Cet outil récupère les détails d’un connecteur que vous configurez sur une ressource de l’agent SRE Azure. Vous pouvez afficher les propriétés, la configuration et l’état du connecteur pour résoudre les problèmes ou documenter le connecteur. Spécifiez les paramètres d’agent et de nom pour identifier la ressource Azure agent SRE et le connecteur.
Voici quelques exemples d'instructions :
- « Afficher les détails du connecteur « github-connector » sur SRE Agent 'sre-agent-prod'.
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Connecteurs : Répertorier les connecteurs
Cet outil répertorie les connecteurs que vous configurez sur une ressource de l’agent SRE Azure. Elle retourne les noms de connecteur, les types de connecteurs et l’état d’inscription afin de pouvoir passer en revue les intégrations et résoudre les problèmes.
Voici quelques exemples d'instructions :
- « Répertorier les connecteurs configurés sur SRE Agent 'sreagent-prod'. »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Connecteurs : Tester le connecteur
Cet outil teste un connecteur et répertorie les outils exposés par le connecteur. Vous pouvez vérifier la connectivité du connecteur et inspecter les outils disponibles, y compris le nom et les fonctionnalités de chaque outil. Pour tester un connecteur, fournissez les paramètres d’agent et de nom.
Voici quelques exemples d'instructions :
- « Teste le nom du connecteur "my-connector" sur l’agent SRE "sre-agent-prod" et répertorie ses outils. »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ✅ | ✅ | ❌ | ❌ |
Documentation : Obtenir la documentation de référence
Cet outil fournit une documentation de référence sur les concepts de l’agent SRE (Site Reliability Engineering). Vous pouvez obtenir des définitions, des détails de configuration et des exemples d’utilisation pour les rubriques de L’Agent SRE, telles que les alertes, la réponse aux incidents, les vérifications d’intégrité et la télémétrie. Spécifiez la rubrique pour récupérer l’entrée de référence d’une rubrique.
Voici quelques exemples d'instructions :
- « Affichez-moi la documentation de l’agent SRE pour la rubrique « réponse aux incidents ».
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Topic | Obligatoire | Sujet de documentation. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Mémoires de documentation : Ajouter un document à la base de connaissances
Cet outil ajoute un document à la base de connaissances de l’agent SRE par nom. Vous téléversez du contenu Markdown (*.md), et l’outil l’indexe pour la recherche de connaissances basée sur la génération augmentée par récupération (RAG). Utilisez des noms clairs et descriptifs pour vous permettre de trouver facilement des documents.
Voici quelques exemples d'instructions :
- Ajoutez un document nommé « incident-runbook » avec le contenu « Runbook : étapes pour diagnostiquer une panne de service et contacter l’astreinte » dans la base de connaissances de l’agent SRE.
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Contenu | Obligatoire | Contenu du document à ajouter à la base de connaissances. |
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
Mémoires de documentation : Supprimer le document de base de connaissances
Spécifiez le document par nom. Cet outil supprime un document de base de connaissances une fois que vous avez confirmé. La suppression est permanente et ne peut pas être annulée. Vérifiez que le document existe avant d’exécuter cet outil.
Voici quelques exemples d'instructions :
- « Supprime le nom du document de la base de connaissances "sre-kb-doc-01" de l’agent SRE "sre-agent-westus" avec confirmation sur "true". »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Confirmer | Obligatoire | Confirmez une opération destructrice. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Mémoires de documentation : répertorier les documents de base de connaissances indexés
Cet outil répertorie tous les documents de la base de connaissances indexés qu’un agent SRE stocke en mémoire. Elle retourne chaque nom de document et ses métadonnées, sans filtre de recherche ni requête. La navigation dans la base de connaissances complète vous permet de découvrir les documents disponibles avant d’exécuter des recherches ciblées.
Voici quelques exemples d'instructions :
- « Obtenez une liste complète de tous les documents de base de connaissances indexés stockés dans la mémoire sre-agent-prod de l’agent SRE sans filtrage ».
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Mémoires de documentation : Réindexer la base de connaissances
Cet outil déclenche une réindexation d’une base de connaissances. Utilisez-le pour retraiter les documents stockés, mettre à jour les incorporations et reconstruire les index de recherche afin que les résultats de la recherche reflètent les modifications récentes du contenu et des métadonnées. Le temps de réindexation dépend de la taille du jeu de données et de la charge du serveur. Cela peut prendre des minutes ou plus. Une fois l’outil démarré, surveillez la progression de la réindexation à l’aide des points de terminaison de gestion du serveur.
Voici quelques exemples d'instructions :
- Réindexez les documents de la base de connaissances de l’agent SRE 'sre-agent-westus'.
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
Mémoires de documentation : Base de connaissances de recherche
Cet outil recherche la base de connaissances SRE Agent à l’aide de la recherche sémantique et retourne les documents les plus pertinents pour votre requête. Il vous aide à trouver les étapes de dépannage, les runbooks, les analyses post mortem et les playbooks de supervision associés aux incidents ou aux alertes.
Voici quelques exemples d'instructions :
- Recherchez « latence d’E/S disque » dans la base de connaissances de l’agent SRE.
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Query | Obligatoire | Requête de recherche utilisée pour rechercher des documents de base de connaissances pertinents. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Hooks : Supprimer le hook
Cet outil supprime un hook d’une ressource de l’agent SRE Azure.
Voici quelques exemples d'instructions :
- « Supprime le nom du hook "backup-trigger" de l’agent SRE "sre-agent-prod" avec confirmation "true". »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
| Confirmer | Obligatoire | Confirmez une opération destructrice. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Hooks : Voir les détails
Cet outil retourne des détails pour un hook que vous configurez sur une ressource de l’agent SRE Azure. Vous pouvez passer en revue la configuration du hook, vérifier son état actuel et confirmer les paramètres du déclencheur ou les points de terminaison de destination.
Voici quelques exemples d'instructions :
- « Affiche-moi les détails du hook "deploy-hook" de l’agent SRE "sre-agent-prod". »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Hooks : lister les hooks
Répertorie les hooks configurés sur une ressource de l’agent SRE Azure. Utilisez cet outil pour afficher les noms des hooks, les types de hooks et leur état actuel pour un agent donné. Utilisez le résultat pour examiner les hooks de déploiement, de supervision et de nettoyage qui s’appliquent à Agent.
Voici quelques exemples d'instructions :
- Listez les hooks configurés pour l’agent SRE « sre-agent-prod ».
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Hooks : activer le thread du hook
Cet outil active un hook à la demande pour un thread sur une ressource de l’agent SRE Azure. Elle déclenche immédiatement les actions configurées du hook.
Voici quelques exemples d'instructions :
- Activer le hook « health-check » sur le thread « thread-42 » de l’agent SRE « sreagent-prod ».
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Nom du hook | Obligatoire | Le nom du hook. |
| Thread ID | Obligatoire | ID de thread de l’agent SRE. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Hooks : désactiver le thread du hook
Cet outil désactive un hook à la demande pour un thread sur une ressource de l’agent SRE Azure. Vous fournissez un agent, un nom de hook et un ID de thread pour identifier le hook et le thread cible. L’outil arrête l’exécution du hook sur le thread spécifié sans supprimer la configuration du hook. Vous avez besoin des autorisations appropriées sur la ressource Azure agent SRE pour appliquer la modification.
Voici quelques exemples d'instructions :
- « Désactive le hook "on-demand-restart" sur l’ID de thread "thread-7" de l’agent SRE "sre-agent-prod". »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Nom du hook | Obligatoire | Le nom du hook. |
| Thread ID | Obligatoire | ID de thread de l’agent SRE. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Hooks : afficher l’état du thread hook
Cet outil répertorie l’état d’activation du hook pour un thread sur une ressource de l’agent SRE Azure. Elle retourne si les hooks sont activés, désactivés ou en attente pour le thread spécifié. Utilisez les résultats pour vérifier la configuration du hook et résoudre les problèmes de comportement des threads.
Voici quelques exemples d'instructions :
- « Liste les états d’activation du hook pour l’ID de thread "thread-42" de l’agent SRE "sre-agent-prod". »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Thread ID | Obligatoire | ID de thread de l’agent SRE. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Incidents : répertorier les incidents actifs
Cet outil répertorie les incidents actifs sur un agent d’ingénierie de fiabilité de site (SRE). Il retourne des threads d’incident ouverts avec le titre, l’état, les services affectés et les détails de l’investigation. Utilisez les résultats pour consulter les investigations en cours et voir quels services sont affectés.
Voici quelques exemples d'instructions :
- « Liste les incidents actifs de l’agent SRE "sre-agent-west". »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Incidents : Créer un incident
Utilisez cet outil pour créer un thread d’investigation d’incident pour un agent. Vous pouvez consigner les détails de l’incident, associer les services affectés et définir la gravité pour aider à hiérarchiser la réponse. Vous spécifiez la description de l’incident, les services, la gravité et le titre lorsque vous exécutez cet outil.
Voici quelques exemples d'instructions :
- « Créez un incident avec le titre « Pic de latence de la base de données », description « Latence élevée observée dans les lectures SQL », services « payments-api, auth-service », gravité « élevé », agent « sre-agent-westus ».
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Description | Obligatoire | Une description de l’élément Agent SRE. |
| Services | Obligatoire | Noms de service affectés. |
| Severity | Obligatoire | Gravité de l’incident : critique, élevé, moyen ou faible. |
| Titre | Obligatoire | Titre de l’incident. |
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
Incidents : Créer un plan
Cet outil crée et active un plan de réponse aux incidents qui utilise un filtre pour étendre les incidents et un gestionnaire pour définir les étapes de réponse. Vous spécifiez les métadonnées du plan, les services à surveiller, le niveau de gravité, les étapes de réponse et une condition de déclenchement. Cet outil valide l’entrée et active le plan afin qu’il commence à gérer les incidents correspondants.
Voici quelques exemples d'instructions :
- « Crée et active le plan de réponse aux incidents nommé "db-failover-plan", des services "payments-api", avec une gravité "critical", suivant les étapes "notify on-call;run db failover" et avec la condition de déclenchement "database connection lost". »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
| Services | Obligatoire | Noms de service affectés. |
| Severity | Obligatoire | Gravité de l’incident : critique, élevé, moyen ou faible. |
| Étapes | Obligatoire | Étapes de réponse aux incidents. |
| Condition de déclencheur | Obligatoire | Texte qui déclenche le plan de réponse aux incidents. |
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Mode Agent | Optional | Mode de l’agent : autonome ou de révision. |
| Transfert au niveau supérieur | Optional | Procédure d’escalade. |
| Runbook URL | Optional | URL du Runbook. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
Incidents : répertorier les plans
Cet outil répertorie les plans de réponse aux incidents configurés sur un agent SRE. Vous pouvez afficher le nom, l’ID et l’état de chaque plan. Ces informations vous aident à identifier les plans actifs et à passer en revue leur configuration.
Voici quelques exemples d'instructions :
- Lister les plans de réponse aux incidents configurés sur l’agent SRE « sre-agent-prod ».
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Incidents : Connecter l’agent à PagerDuty
Connectez un agent d’ingénierie de fiabilité de site (SRE) à PagerDuty. Cet outil crée un connecteur PagerDuty qui permet l’alerte d’incident et la gestion des incidents. Le connecteur utilise une clé API stockée dans une variable d’environnement.
Voici quelques exemples d'instructions :
- « Connecte l’agent SRE "sre-agent-prod" à PagerDuty avec la clé d’environnement de l’API "PAGERDUTY_API_KEY" et le nom "pagerduty-connector". »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Clé d’environnement de l’API | Obligatoire | Variable d’environnement contenant la clé API. |
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Sous-domaine | Optional | Sous-domaine PagerDuty. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ❌ | ✅ | ❌ |
Incidents : Configurer le connecteur ServiceNow
Cet outil crée un connecteur MCP ServiceNow qui permet l’intégration de la gestion des incidents. Il utilise des informations d’identification stockées dans des variables d’environnement et permet la création, les mises à jour et la résolution des incidents entre ServiceNow et l’agent SRE.
Voici quelques exemples d'instructions :
- « Connecter SRE Agent à ServiceNow avec le type d’authentification « basic », l’URL de l’instance «https://my-resource.service-now.com », le nom « sre-agent-prod ».
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Type d’authentification | Obligatoire | Type d’authentification du connecteur HTTP MCP. |
| URL de l’instance | Obligatoire | URL de l’instance ServiceNow. |
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Env de mot de passe | Optional | Variable d’environnement contenant le mot de passe. |
| Environnement de jetons | Optional | Variable d’environnement contenant le jeton du porteur. |
| Nom d’utilisateur env | Optional | Variable d’environnement contenant le nom d’utilisateur. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ❌ | ✅ | ❌ |
Tâches planifiées : Créer une tâche planifiée
Cet outil crée une tâche planifiée pour un agent SRE. Il envoie un message spécifié à la planification que vous définissez avec une expression cron, afin que l’agent puisse exécuter un travail automatisé. Vous fournissez les détails de la tâche lorsque vous créez la tâche planifiée.
Voici quelques exemples d'instructions :
- Planifiez une tâche récurrente sur l’agent SRE « sre-agent-west » qui s’exécute tous les lundis avec l’expression cron « 0 9 * * 1 », nommée « weekly-restart », et le message « Redémarrer le service ».
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Expression cron | Obligatoire | Expression cron pour la planification. |
| Message | Obligatoire | L’instruction que l’agent exécute selon la planification définie. |
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Description | Optional | Une description de l’élément Agent SRE. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
Tâches planifiées : supprimer une tâche planifiée
Cet outil supprime une tâche planifiée de l’agent SRE.
Voici quelques exemples d'instructions :
- « Supprime la tâche planifiée "task-12345" de l’agent SRE "sre-agent-west" avec la confirmation "true". »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| ID de la tâche | Obligatoire | L’identifiant de la tâche planifiée. |
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Confirmer | Obligatoire | Confirmez une opération destructrice. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
Tâches planifiées : Obtenir une tâche planifiée
Cet outil récupère une tâche planifiée de l’agent SRE par ID de tâche. Vous pouvez afficher des détails tels que la configuration des tâches et l’état actuel.
Voici quelques exemples d'instructions :
- Montrez-moi la tâche planifiée avec l’identifiant de tâche « task-1234 » sur l’agent SRE « sre-agent-west ».
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| ID de la tâche | Obligatoire | L’identifiant de la tâche planifiée. |
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Tâches planifiées : répertorier les tâches planifiées
Cet outil répertorie les tâches planifiées que l’agent SRE gère. Vous pouvez inspecter les travaux planifiés, confirmer les planifications et afficher les métadonnées des tâches telles que l’état, l’heure d’exécution suivante et l’heure de la dernière exécution. Cet outil retourne une liste en lecture seule de tâches planifiées avec des champs pour le nom, l’état, la planification, l’heure d’exécution suivante et l’heure de la dernière exécution.
Voici quelques exemples d'instructions :
- « Liste les tâches planifiées de l’agent SRE "sre-agent-01". »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Tâches planifiées : Suspendre la tâche planifiée
Suspend une tâche planifiée pour un agent d’ingénierie de fiabilité de site (SRE). Cet outil retourne l’état mis à jour de la tâche et les métadonnées associées. Suspendre les tâches planifiées pour arrêter temporairement l’activité automatisée pendant la maintenance ou la résolution des problèmes.
Voici quelques exemples d'instructions :
- « Mets en pause la tâche planifiée dont l’ID de tâche est "task-1234" sur l’agent SRE "sre-agent-west". »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| ID de la tâche | Obligatoire | L’identifiant de la tâche planifiée. |
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |
Tâches planifiées : reprendre la tâche planifiée
Cet outil reprend une tâche planifiée pour un agent SRE. Après avoir exécuté l’outil, l’agent reprend l’exécution de la tâche planifiée en fonction de sa planification.
Voici quelques exemples d'instructions :
- « Reprends la tâche planifiée dont l’ID de tâche est "task-123" sur l’agent SRE "sre-agent-west". »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| ID de la tâche | Obligatoire | L’identifiant de la tâche planifiée. |
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |
Compétences : Créer une compétence
Cet outil crée ou met à jour une compétence personnalisée sur une ressource sRE Agent ciblée.
Voici quelques exemples d'instructions :
- « Ajoutez une nouvelle compétence nommée « auto-scale-skill » à SRE Agent 'sreagent-prod' avec le contenu « {"type » :"script »,"script » :"scale.sh"}'.
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Contenu | Obligatoire | Contenu des compétences. |
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
| Description | Optional | Une description de l’élément Agent SRE. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Compétences : Supprimer une compétence
Cet outil supprime une compétence personnalisée d’une ressource agent SRE.
Voici quelques exemples d'instructions :
- « Supprime la compétence nommée "error-logger" de l’agent SRE "sre-agent-west" avec confirmation "true". »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
| Confirmer | Obligatoire | Confirmez une opération destructrice. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Compétences : répertorier les compétences
Répertorie les compétences personnalisées sur une ressource SRE Agent ciblée. L’outil retourne les détails de chaque compétence personnalisée inscrite sur l’agent SRE spécifié, y compris le nom, la version et l’état. Utilisez la sortie pour passer en revue ou auditer les configurations de compétences personnalisées.
Voici quelques exemples d'instructions :
- « Répertorier toutes les compétences disponibles sur SRE Agent 'sre-agent-prod'. »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Threads : Créer un thread
Cet outil crée un thread sur un agent SRE (Site Reliability Engineering) et démarre une conversation en envoyant le message d’ouverture. Elle renvoie la réponse initiale de l’agent.
Voici quelques exemples d'instructions :
- Démarrez un nouveau fil de discussion sur l’agent SRE 'sre-agent-01' avec le message 'Enquêter sur l’augmentation de la latence au niveau de la passerelle API'.
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Message | Obligatoire | Message à envoyer. |
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
Threads : Supprimer le thread
Cet outil supprime un thread d’agent d’ingénierie de fiabilité des sites (SRE).
Voici quelques exemples d'instructions :
- « Supprime l’ID de thread "thread-12345 " de L’agent SRE "sreagent-prod" avec confirmation "true". »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Confirmer | Obligatoire | Confirmez une opération destructrice. |
| Thread ID | Obligatoire | ID de thread de l’agent SRE. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
Threads : Obtenir des messages
Cet outil obtient des messages pour un thread SRE Agent spécifique et retourne le contenu et les métadonnées des messages, tels que les horodatages et l’identité de l’expéditeur. Utilisez les messages retournés pour passer en revue l’historique des conversations ou résoudre les problèmes de comportement de l’agent.
Voici quelques exemples d'instructions :
- « Afficher les messages pour l’ID de thread '42' sur SRE Agent 'sre-agent-prod'. »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Thread ID | Obligatoire | ID de thread de l’agent SRE. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Threads : mode YOLO
Cet outil démarre une enquête sur l’agent SRE spécifié et accorde toutes les approbations en attente, de sorte que l’agent continue sans portes d’approbation humaine. L’outil enregistre les actions d’investigation et accorde des approbations pour l’audit.
Voici quelques exemples d'instructions :
- « Examine avec le message "Examiner le plantage du service dans le frontend" sur l’agent SRE "sre-agent-prod" en mode YOLO, en accordant automatiquement toutes les approbations en attente. »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Message | Obligatoire | Message à envoyer. |
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Nombre maximal d’itérations | Optional | Nombre maximal d’itérations de suivi automatique. |
| Délai d’expiration (secondes) | Optional | Délai d’attente de l’investigation en secondes. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
Threads : Enquêter sur l’incident
Examinez un problème ou un incident avec un agent SRE (Site Reliability Engineering). Utilisez cet outil pour envoyer un message d’investigation et l’agent pose des questions de suivi jusqu’à ce que l’enquête se termine. Vous fournissez les détails de l’enquête dans le message. Incluez le contexte pertinent, comme les ressources affectées, les horodatages, les messages d’erreur, les modifications de configuration récentes et les étapes à reproduire. Gardez les messages concis et ciblés pour aider l’agent à atteindre une résolution plus efficacement.
Voici quelques exemples d'instructions :
- « Examinez le problème suivant avec l’agent SRE 'sre-agent-prod' : message « l’API principale renvoie des erreurs 500 après le déploiement ». »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Message | Obligatoire | Message à envoyer. |
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Nombre maximal d’itérations | Optional | Nombre maximal d’itérations de suivi automatique. |
| Délai d’expiration (secondes) | Optional | Délai d’attente de l’investigation en secondes. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
Threads : répertorier les threads de conversation de l’agent
Cet outil répertorie les threads de conversation de l’agent SRE. Elle retourne une liste en lecture seule d’objets thread qui incluent l’ID de thread, les participants, les métadonnées et le dernier message, afin de pouvoir passer en revue les conversations actives et passées.
Voici quelques exemples d'instructions :
- « Répertorier les threads actifs sur SRE Agent 'sreagent-prod'. »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Threads : envoyer un message au thread
Cet outil envoie un message à un thread d’agent SRE (Site Reliability Engineering) existant. Il publie le message spécifié dans le thread et retourne l’état mis à jour du thread. Utilisez des messages concis pour ajouter des notes de contexte, d’état ou de résolution des problèmes à un thread en cours.
Voici quelques exemples d'instructions :
- « Envoie le message "Redémarrage terminé, supervision des journaux d’activité" à l’ID de thread "thread-12345" sur l’agent "sre-agent-westus". »
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Message | Obligatoire | Message à envoyer. |
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
| Thread ID | Obligatoire | ID de thread de l’agent SRE. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
Flux de travail : Appliquer et déployer un flux de travail
Appliquez et déployez un flux de travail YAML sur un agent SRE. Cet outil charge et active la configuration YAML ExtendedAgent ou ExtendedAgentTool sur la ressource de l’agent SRE spécifiée.
Voici quelques exemples d'instructions :
- Appliquez le YAML du workflow contenant « apiVersion: sre/v1\nkind: ExtendedAgent\nmetadata:\n name: deploy-workflow » à l’agent SRE 'sre-agent-prod'.
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Contenu YAML | Obligatoire | Contenu YAML. |
| Agent | Obligatoire | Nom de la ressource de l’agent SRE Azure à cibler. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |
Flux de travail : générer une définition de flux de travail
Générez une définition de flux de travail YAML pour un outil ou un agent d’ingénierie de fiabilité de site nommé (SRE). Cet outil crée une configuration YAML validée pour ExtendedAgent, KustoToolet LinkTool des ressources. Le flux de travail généré vous permet de déployer et de gérer les outils de l’agent SRE de manière cohérente entre les environnements.
Voici quelques exemples d'instructions :
- « Générer un flux de travail YAML avec la description « Outil de requête Kusto pour la recherche d’incidents », type « outil », nom « kusto-search-tool ».
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Description | Obligatoire | Une description de l’élément Agent SRE. |
| Kind | Obligatoire | Type YAML : agent ou outil. |
| Name | Obligatoire | Nom de l’élément de l’agent SRE. |
| Connecteur | Optional | Nom du connecteur pour les outils Kusto. |
| Nom de la base de données | Optional | Base de données Kusto pour les outils Kusto. |
| Modèle ou type | Optional | Type d’outil, tel que KustoTool ou LinkTool. |
| Paramètres | Optional | Paramètres sous la forme name :description. |
| Query | Optional | La requête Kusto destinée aux outils Kusto. |
| Outils | Optional | Noms d’outils à joindre. Plusieurs valeurs sont prises en charge. |
| Transferts | Optional | Noms de transfert des sous-agents. Plusieurs valeurs sont prises en charge. |
| Modèle d’URL | Optional | Modèle d’URL pour les outils de lien. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Flux de travail : Valider le flux de travail
Cet outil valide le flux de travail SRE Agent YAML et signale les problèmes courants liés à la structure et à la syntaxe. Il vérifie la présence de YAML non valide, d’étapes mal formées, de chaînes run incorrectes et de clés requises manquantes. Vous fournissez YAML contentet l’outil retourne des problèmes identifiés avec les numéros de ligne et les correctifs suggérés. Consultez l’exemple suivant pour obtenir une erreur classique détectée par l’outil.
Voici quelques exemples d'instructions :
- « Validez le contenu YAML du flux de travail SRE Agent suivant « apiVersion : sre/v1\ntype : ExtendedAgent\nmétadonnées :\n nom : deploy-workflow ».
| Paramètre | Obligatoire ou facultatif | Description |
|---|---|---|
| Contenu YAML | Obligatoire | Contenu YAML. |
Astuces pour l'annotation des outils :
| Destructeur | Idempotent | Open World | Lecture seule | Secret | Paramètres régionaux requis |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |