Carga de documentos de conocimiento en el Agente de SRE de Azure

Sugerencia

  • El agente crea y carga runbooks durante las conversaciones sin administración manual de archivos.
  • Adjunte 31 tipos de archivo en chat, incluidos .kql, .bicep.tf, .har, .py, y .xlsx, para el contexto de análisis inmediato.
  • Sube 28 tipos de archivo a los Ajustes de Conocimientos para un almacenamiento persistente e indexado en todas las conversaciones futuras.
  • Las resoluciones de incidentes se convierten automáticamente en conocimientos institucionales

El problema: el conocimiento muere con la conversación

Cada incidente que resuelve el equipo genera un conocimiento valioso: lo que salió mal, qué comandos lo corrigió y qué comprobar primero la próxima vez. Pero ese conocimiento vive en hilos de chat, memoria de los ingenieros y análisis postmortem que nadie lee a las 3 a.m.

Su equipo tiene runbooks, pero están obsoletos. ¿El arreglo descubierto durante el incidente de anoche? Está en la cabeza de alguien, o enterrado en una conversación que desaparece de la vista para la próxima semana. La próxima vez que se produzca el mismo problema, un ingeniero diferente comienza desde cero.

Cómo resuelve el agente este problema

El agente puede cargar documentos en los ajustes de conocimiento durante las conversaciones mediante la herramienta Cargar Documento de Conocimiento. Cuando el agente detecta una corrección, crea una guía de solución de problemas o sintetiza los resultados de la investigación, almacena ese conocimiento directamente y hace que se pueda buscar en cada conversación futura.

"Create a runbook from the steps we just followed to fix this database
connection pool exhaustion issue and save it to Knowledge settings."

El agente genera un runbook estructurado y lo sube en cuestión de segundos. El documento se indexa automáticamente y se vuelve accesible para futuras investigaciones.

Antes y después

antes de después de
Captura de conocimiento Posterior al incidente: el ingeniero escribe un manual de operaciones (quizás) El agente captura la solución a medida que sucede.
Hora de documentar De 30 a 60 minutos para redactar un runbook. Segundos. El agente genera y carga en línea.
Actualización del conocimiento Los runbooks pasan a obsoletos en semanas La configuración de parámetros de conocimiento mejora con cada resolución
Accesibilidad Conocimientos atrapados en la cabeza del ingeniero o en el hilo de chat. Buscable por el agente en todas las conversaciones futuras
Coherencia de formato Varía según el autor Documentación estructurada y coherente cada vez

Lo que hace que esto sea diferente

A diferencia de las cargas manuales, el agente crea conocimientos de forma proactiva. No es necesario recordar documentar lo que ha aprendido porque el agente lo hace como parte de la conversación.

A diferencia del historial de chat, los documentos cargados se indexan para la búsqueda semántica. Cuando se produce un problema similar meses más tarde, el agente encuentra el runbook pertinente automáticamente a través de la recuperación inteligente, sin desplazarse por hilos antiguos.

A diferencia de los conectores wiki, los documentos cargados no requieren servicios externos. El conocimiento reside directamente en los ajustes de conocimiento del agente, disponible al instante sin demoras de sincronización.

Cómo funciona

La herramienta Cargar documento de conocimiento acepta tres parámetros:

Parámetro Obligatorio Descripción
Nombre de archivo Nombre con .md o .txt extensión (por ejemplo, database-pool-runbook.md)
Contenido Texto completo del documento en formato markdown o texto sin formato
Iniciar la indexación Opcional (valor predeterminado: true) Si se debe hacer que el documento se pueda buscar inmediatamente

Cuando el agente carga un documento:

  1. Valida el nombre de archivo y el contenido (hasta 16 MB por archivo).
  2. Almacena el documento en la configuración de conocimientos del agente.
  3. Indexa el contenido de la búsqueda semántica.
  4. Confirma la carga con un mensaje de confirmación.

Nota:

Si ya existe un documento con el mismo nombre de archivo, el nuevo contenido lo reemplaza. Este proceso facilita que el agente actualice los conocimientos. Suba con el mismo nombre para refrescar el contenido.

Formatos de archivos admitidos

El agente controla los archivos a través de tres métodos, cada uno de los cuales admite diferentes formatos.

Archivos adjuntos del chat

Arrastre archivos a cualquier chat para dar al agente un contexto inmediato para el análisis: scripts de resolución de problemas, archivos de configuración, trazas de red, etc.

Categoría Extensiones
Images .png, .jpg, .jpeg, .gif, , .webp, .svg
Documents .txt, .md, .pdf, .docx, , .pptx, .xlsx
Datos y configuración .json, .csv, .log, .yaml, .yml, .xml, .ini, .conf.env
Web y red .html, .har
Código y scripts .ts, .js, .py, .sh, , .sql, .kql
Infraestructura .bicep, .tf

Límites: 10 MB por archivo · 50 MB totales por mensaje · 5 archivos por mensaje

Cargas de configuraciones de conocimiento

Para conservar documentos para que el agente haga referencia en conversaciones futuras, cargue archivos a través de la configuración del generador → Knowledge → Agregar archivo. El sistema indexa archivos cargados para la búsqueda semántica.

Categoría Extensiones
Images .png, .jpg, .jpeg, .gif, .webp, .bmp, , .tiff.tif
Documents .txt, .md, .pdf, .docx, .pptx, .xlsx, .doc, .ppt.xls
Datos y configuración ** .json, .csv, .log, .yaml, .yml, .xml, .ini, .conf, .cfg, .config, .properties

Límites: 16 MB por archivo · 100 MB por carga

Cargas de carpetas

Para cargar todos los archivos admitidos a la vez, arrastre una carpeta completa a la zona de colocación de carga. Este proceso incluye archivos en subcarpetas anidadas. El portal extrae automáticamente todos los archivos de la jerarquía de carpetas y filtra los tipos de archivo no admitidos.

Funcionamiento de las cargas de carpetas:

  1. El sistema extrae todos los archivos de las subcarpetas anidadas en una lista plana.
  2. El sistema solo incluye archivos con extensiones admitidas y filtra de forma silenciosa los tipos no admitidos.
  3. El sistema desduplica los archivos con nombres duplicados de subcarpetas diferentes y mantiene solo el primer archivo.
  4. El sistema carga e indexa cada archivo individualmente para la búsqueda.

Nota:

Los archivos cargados aparecen como documentos individuales en fuentes de conocimiento. No se mantiene la jerarquía de carpetas original. Un archivo en runbooks/networking/dns-troubleshooting.md aparece como dns-troubleshooting.md.

La carga de la configuración de conocimientos acepta formatos de Office compatibles con versiones anteriores (.doc, .ppt, .xls) y formatos de imagen adicionales (.bmp, .tiff, .tif) que no aceptan adjuntos de chat. Los datos adjuntos del chat admiten código, scripts, infraestructura y formatos web que las configuraciones de conocimiento no permiten.

Documentos generados por el agente

Cuando tu agente crea documentos durante las conversaciones (mediante la herramienta Cargar documento de conocimiento), genera archivos .md o .txt y los guarda directamente en la configuración de conocimiento. Este proceso se produce cuando se le pide al agente que "guarde esto como un runbook".

Ejemplo: captación del conocimiento de incidentes

Durante una investigación de incidentes, pregunte al agente:

We just resolved the high CPU issue on web-app-prod. It was caused by a
memory leak in the connection pool. Create a troubleshooting guide from
what we learned and upload it to Knowledge settings.

El agente genera una guía de solución de problemas estructurada con:

  • Pasos para determinar el ámbito: cómo identificar el problema.
  • Mitigaciones rápidas: acciones inmediatas para reducir el impacto.
  • Análisis de causa principal: qué investigar.
  • Pasos de resolución: corrección que funcionó.
  • Prevención: Cómo evitar la recurrencia.

La próxima vez que se produzca un problema de CPU similar, el agente hace referencia automáticamente a este documento durante la investigación, convirtiendo la experiencia de un ingeniero en conocimientos compartidos del equipo.

Lo que necesitas

Requisito Detalles
Versión del agente 26.1.57.0 o posterior
Configuración de conocimientos Habilitado en el agente
Permisos de escritura El agente necesita acceso de escritura a la configuración de conocimientos
Modo de ejecución Revisión o Automático. Las acciones de escritura requieren aprobación en modo de revisión.

Límites

Atributo Archivos adjuntos del chat Cargas de configuraciones de conocimiento Herramienta del agente
Tamaño máximo del archivo 10 MB 16 MB 16 MB
Total máximo 50 MB por mensaje 100 MB por carga N/A
Máximo de archivos 5 por mensaje Sin límite (tamaño total limitado a 100 MB) 1 por acción
Carga de carpetas No soportado ✓ Arrastre carpetas para cargar todos los archivos a la vez No soportado
Extensiones admitidas 31 28 2 (.md, .txt)
Caracteres de nombre de archivo N/A Letras, números, guiones, caracteres de subrayado, puntos Iguales
Longitud máxima del nombre de archivo N/A 1024 caracteres Iguales

Cuándo usar algo más

Escenario Mejor enfoque
Conexión del contenido wiki en vivo que se mantiene sincronizado Conocimientos de wiki de ADO
Carga de archivos binarios (PDF, Word, imágenes) Cargar a través de Constructor → Configuración de conocimiento → Agregar archivo
Importación masiva de muchos documentos a la vez Carga varios archivos a través de Builder → Configuración de Knowledge → Agregar archivo
Mantener actualizados los repositorios de código automáticamente Conexión de un conector de GitHub o ADO
Capacidad Lo que agrega
Conocimientos de wiki de ADO Conectar contenido wiki en vivo que se actualiza automáticamente
Análisis de la causa raíz Investigación de problemas y captura de los resultados