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.
Connectez vos wikis Azure DevOps afin que votre agent référence les runbooks et procédures de votre équipe pendant les enquêtes. Le contenu Wiki est indexé et pouvant faire l’objet d’une recherche, et votre agent trouve automatiquement la page appropriée. Le connecteur prend en charge l’authentification par identité managée et par jeton d’accès personnel (PAT).
Le problème : les connaissances ne sont pas utilisées pendant les incidents
Votre équipe investit des centaines d’heures dans l’écriture de runbooks, de guides de résolution des problèmes et de procédures opérationnelles dans des wikis Azure DevOps. Mais quand un incident se déclenche à 3 heures, personne ne recherche le wiki. L’ingénieur d’astreinte ouvre une douzaine d’onglets, vérifie Azure Monitor, puis soit résout le problème de mémoire, soit le fait remonter. La documentation écrite pour exactement cette situation n’est pas touchée.
Les connaissances existent. Le problème est l’accès - pas au wiki, mais à la page droite au bon moment, dans le contexte du problème réel.
Comment l’agent SRE résout ce problème
Connectez votre wiki Azure DevOps une seule fois, et votre agent le recherche automatiquement pendant chaque investigation :
- Indexe vos pages wiki : analyse et indexe toutes les pages de votre wiki Azure DevOps.
- Effectue des recherches contextuelles : lorsqu’un incident survient ou que vous posez une question, votre agent recherche votre wiki simultanément à d’autres sources de connaissances.
- Références spécifiques à des pages : les réponses incluent des citations qui renvoient à la page wiki d’origine.
- Récupère les mises à jour : reconnectez ou actualisez le connecteur pour réindexer le contenu wiki mis à jour.
Avant et après
| Scénario | Avant | Après |
|---|---|---|
| Réponse aux incidents | La personne de garde ne consulte pas le wiki pendant les incidents | Votre agent recherche automatiquement le wiki pour chaque requête |
| Accès aux connaissances | Les connaissances dans wiki ne sont pas utilisées à 3h00 | Les Runbooks s’affichent exactement quand c’est nécessaire |
| Intégration | Les nouveaux membres de l’équipe ne savent pas quelle page wiki vérifier | Votre agent trouve la page appropriée, quelle que soit l’expérience |
| Qualité de la recherche | La recherche Wiki nécessite de connaître les mots clés appropriés | Votre agent comprend le contexte et recherche du contenu associé |
Ce qui rend cela différent
Contrairement aux chargements de fichiers statiques, votre wiki reste actif. Lorsque votre équipe met à jour un runbook dans Azure DevOps, votre agent récupère les modifications. Vous n’avez pas besoin de recharger les fichiers.
Contrairement à la recherche wiki en texte intégral, votre agent comprend le contexte. Il ne correspond pas aux mots clés. Au lieu de cela, il met en corrélation votre question avec le contenu wiki pertinent, en le combinant avec les données de télémétrie en direct d’Azure Monitor, les journaux d’activité de Kusto et d’autres sources connectées.
Contrairement à l’accès wiki basé sur MCP externe, le connecteur de documentation intégré ne nécessite aucune configuration de serveur externe. Vous fournissez l’URL et l’authentification wiki, et votre agent gère le reste.
Fonctionnement
Le connecteur de documentation (Azure DevOps type de service) analyse vos pages wiki et les indexe pour la recherche. Lorsque votre agent reçoit une requête, il recherche le contenu indexé en même temps que d’autres sources de connaissances, telles que les fichiers chargés, les pages web et les référentiels connectés.
Le connecteur prend en charge deux types de contenu Azure DevOps :
| Type de contenu | Modèle d’URL | Ce qui est indexé |
|---|---|---|
| Wiki | https://dev.azure.com/{org}/{project}/_wiki/wikis/{wiki-name} |
Toutes les pages wiki (Markdown) |
| Wiki (délimité) | .../_wiki/wikis/{wiki-name}/{pageId}/Page-Name |
Page spécifique et ses sous-pages |
| Référentiel Git | https://dev.azure.com/{org}/{project}/_git/{repo} |
Fichiers texte (Markdown, docs, code) |
| Wiki obsolète | https://{org}.visualstudio.com/{project}/_wiki/wikis/{wiki-name} |
Identique à ce qui précède (format d’URL hérité) |
Note
Lorsque vous incluez un ID de page dans l’URL wiki, le connecteur indexe uniquement cette page et ses sous-pages. Cette approche est utile pour cibler des sections spécifiques comme /Operations ou /Runbooks sans indexer l’intégralité de votre wiki.
Fonctionnement de la synchronisation de la documentation
Une fois connecté, votre agent conserve automatiquement votre index de documentation à jour. Vous n’avez pas besoin de recharger manuellement quoi que ce soit.
| Aspect | Détails |
|---|---|
| Fréquence de synchronisation | Exploration automatique toutes les 24 heures |
| Formats pris en charge |
.md, , .txt, .rst, .adoc.asciidoc.wiki.textile.org.htm.html.json.yaml.yml.xml.csv( 15 formats de fichier) |
| Processus d’indexation | Les documents sont segmentés, incorporés et indexés pour la recherche sémantique |
| Mises à jour | Les modifications apportées à votre référentiel sont récupérées lors du prochain cycle de synchronisation sans aucune action manuelle requise |
Votre agent traite chaque document en le fractionnant en blocs sémantiquement significatifs, en générant des incorporations de vecteurs et en les stockant dans un index de recherche. Lorsqu’une requête arrive, votre agent effectue une recherche sémantique sur tous les blocs indexés et récupère les passages les plus pertinents, indépendamment des correspondances exactes des mots clés.
Votre équipe peut mettre à jour des runbooks, ajouter de nouvelles procédures ou réorganiser des pages wiki, et votre agent reflète ces modifications dans les 24 heures.
Prerequisites
| Prérequis | Détails |
|---|---|
| Wiki Azure DevOps | Wiki dans votre projet Azure DevOps avec du contenu |
| Authentification | Identité managée (recommandé) ou jeton d’accès personnel (PAT) |
| Permissions | Accès en lecture au wiki |
Options d’authentification
Le tableau suivant décrit les méthodes d’authentification disponibles pour le connecteur wiki Azure DevOps.
| Méthode | Idéal pour | Fonctionnement |
|---|---|---|
| Identité managée | Environnements de production | Utilise l’identité managée attribuée par le système ou attribuée par l’utilisateur de votre agent. Nécessite l’ajout de l’identité en tant qu’utilisateur dans votre organisation Azure DevOps. |
| Jeton d’accès personnel (PAT) | Configuration rapide, test | Générez un PAT dans Azure DevOps avec l’étendue Code (Read). |
Exemple : utiliser un runbook lors d’un incident
Après avoir connecté votre wiki des opérations, demandez à votre agent :
Our payment service is returning 503 errors. What does our runbook say to do?
Votre agent recherche votre wiki, recherche la page « Résolution des problèmes du service de paiement » et répond avec la procédure documentée. La réponse inclut une citation qui renvoie à la page wiki d’origine dans Azure DevOps.