Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Conecte sus wikis de Azure DevOps para que su agente haga referencia a los runbooks y procedimientos de su equipo durante las investigaciones. El contenido wiki se indexa y se puede buscar, y el agente encuentra automáticamente la página correcta. El conector admite tanto la identidad administrada como la autenticación de token de acceso personal (PAT).
El problema: los conocimientos no se utilizan en incidentes.
Su equipo invierte cientos de horas escribiendo runbooks, guías de solución de problemas y procedimientos operativos en wikis de Azure DevOps. Pero cuando un incidente se desencadena a las 3 a.m., nadie busca la wiki. El ingeniero de guardia abre una docena de pestañas, comprueba Azure Monitor y lo resuelve de memoria o decide escalar el problema. La documentación escrita para esta situación permanece sin tocar.
El conocimiento existe. El problema es el acceso, no a la wiki, sino a la página correcta en el momento adecuado, en el contexto del problema actual.
Cómo resuelve el agente de SRE este problema
Conecte la wiki de Azure DevOps una vez y el agente lo busca automáticamente durante cada investigación:
- Indexa las páginas wiki : rastrea e indexa todas las páginas de la wiki de Azure DevOps.
- Búsquedas contextuales — Cuando formulas una pregunta o se desencadena un incidente, tu agente busca en tu wiki junto con otros orígenes de conocimiento.
- Páginas específicas de referencias: las respuestas incluyen citas vinculadas a la página wiki original.
- Recoge actualizaciones : vuelva a conectar o actualizar el conector para volver a indexar el contenido wiki actualizado.
Antes y después
| Escenario | antes de | después de |
|---|---|---|
| Respuesta a incidentes | La persona en la llamada no busca wiki durante incidentes | El agente busca wiki automáticamente para cada consulta. |
| Acceso al conocimiento | El conocimiento en la wiki queda sin utilizar a las 3:00 a. m. | Los runbooks se presentan exactamente cuando es necesario |
| Incorporación | Los nuevos miembros del equipo no saben qué página wiki comprobar | El agente encuentra la página pertinente independientemente de la experiencia. |
| Calidad de búsqueda | La búsqueda wiki requiere conocer las palabras clave correctas. | El agente entiende el contexto y busca contenido relacionado. |
Lo que hace que esto sea diferente
A diferencia de las cargas de archivos estáticos, la wiki permanece activa. Cuando el equipo actualiza un runbook en Azure DevOps, el agente recoge los cambios. No es necesario volver a cargar archivos.
A diferencia de la búsqueda wiki de texto completo, el agente entiende el contexto. No coincide con las palabras clave. En su lugar, correlaciona la pregunta con el contenido wiki pertinente, combinándolo con telemetría activa de Azure Monitor, registros de Kusto y otros orígenes conectados.
A diferencia del acceso wiki basado en MCP externo, el conector de documentación integrado no requiere ninguna configuración de servidor externo. Proporcione la dirección URL de wiki y la autenticación, y el agente controla el resto.
Cómo funciona
El conector de documentación (Azure DevOps tipo de servicio) rastrea las páginas wiki y las indexa para la búsqueda. Cuando el agente recibe una consulta, busca el contenido indexado junto con otros orígenes de conocimiento, como archivos cargados, páginas web y repositorios conectados.
El conector admite dos tipos de contenido de Azure DevOps:
| Tipo de contenido | Patrón de URL | ¿Qué se indexa? |
|---|---|---|
| Wiki | https://dev.azure.com/{org}/{project}/_wiki/wikis/{wiki-name} |
Todas las páginas wiki (Markdown) |
| Wiki (delimitado) | .../_wiki/wikis/{wiki-name}/{pageId}/Page-Name |
Página específica y sus subpáginas |
| Repositorio Git | https://dev.azure.com/{org}/{project}/_git/{repo} |
Archivos de texto (Markdown, docs, código) |
| Wiki obsoleta | https://{org}.visualstudio.com/{project}/_wiki/wikis/{wiki-name} |
Igual que lo anterior (formato de dirección URL heredada) |
Nota:
Cuando se incluye un identificador de página en la dirección URL de wiki, el conector solo indexa esa página y sus subpáginas. Este enfoque es útil para dirigirse a secciones específicas como /Operations o /Runbooks sin indexar toda la wiki.
Funcionamiento de la sincronización de documentación
Una vez conectado, el agente mantiene actualizado el índice de documentación automáticamente. No es necesario volver a cargar manualmente nada.
| Aspecto | Detalles |
|---|---|
| Frecuencia de sincronización | Rastreo automático cada 24 horas |
| Formatos admitidos |
.md, .txt, .rst, .adoc, .asciidoc, .wiki, .textile, .org, .htm, .html, .json, .yaml, .yml, .xml, .csv (15 formatos de archivo) |
| Proceso de indexación | Los documentos se fragmentan, incrustan e indexan para la búsqueda semántica |
| Actualizaciones | Los cambios en el repositorio se detectan en el siguiente ciclo de sincronización sin requerir acción manual. |
El agente procesa cada documento dividiéndola en fragmentos semánticamente significativos, generando incrustaciones de vectores y almacenándolas en un índice de búsqueda. Cuando llega una consulta, el agente realiza una búsqueda semántica en todos los fragmentos indexados y recupera los pasajes más relevantes, independientemente de las coincidencias exactas de palabra clave.
El equipo puede actualizar runbooks, agregar nuevos procedimientos o reorganizar páginas wiki, y el agente refleja esos cambios en un plazo de 24 horas.
Prerrequisitos
| Requisito | Detalles |
|---|---|
| Wiki de Azure DevOps | Wiki del proyecto de Azure DevOps con contenido |
| Autenticación | Identidad administrada o token de acceso personal (PAT) (recomendado) |
| Permisos | Acceso de lectura a la wiki |
Opciones de autenticación
En la tabla siguiente se describen los métodos de autenticación disponibles para el conector wiki de Azure DevOps.
| Método | Más adecuado para | Cómo funciona |
|---|---|---|
| Identidad administrada | Entornos de producción | Usa la identidad administrada asignada por el sistema o asignada por el usuario del agente. Requiere agregar la identidad como usuario en la organización de Azure DevOps. |
| Token de acceso personal (PAT) | Configuración rápida, pruebas | Generar un PAT en Azure DevOps con el ámbito Código (lectura). |
Ejemplo: uso de un runbook durante un incidente
Después de conectar la wiki de operaciones, pregunte al agente:
Our payment service is returning 503 errors. What does our runbook say to do?
Tu agente busca en tu wiki, encuentra la página "Solución de problemas del servicio de pago" y responde con el procedimiento documentado. La respuesta incluye una referencia que enlaza a la página wiki original de Azure DevOps.