Compartir por


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

El agente captura los conocimientos institucionales durante las conversaciones mediante la carga de runbooks, guías de solución de problemas y documentación directamente en la base de conocimiento. Cuando el agente detecta una corrección o resuelve un incidente, genera documentos estructurados y los indexa para la búsqueda semántica, por lo que cada investigación futura se beneficia de las resoluciones anteriores.

Sugerencia

Su agente crea y sube runbooks durante las conversaciones sin necesidad de administrar manualmente los archivos. Adjunte 31 tipos de archivo en chat, incluidos .kql, .bicep.tf, .har, .py, y .xlsx, para el contexto de análisis inmediato. Cargue 28 tipos de archivos en la configuración de conocimientos para disponer de un almacenamiento permanente e indexado en todas las conversaciones futuras. Las resoluciones de incidentes se convierten automáticamente en conocimientos institucionales.

Cómo el agente captura conocimiento

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.

Generación y carga por parte del agente de una guía de solución de problemas durante una conversación

Antes y después

En la tabla siguiente se comparan los flujos de trabajo de captura de conocimiento antes y después de usar la herramienta Cargar documento de conocimiento .

Area 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 30-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 este enfoque sea diferente

A diferencia de las cargas manuales, el agente crea de forma proactiva conocimientos. No es necesario recordar documentar lo que ha aprendido. 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. El agente valida el nombre de archivo y el contenido (máximo 16 MB por archivo).
  2. El agente almacena el documento en la configuración de conocimientos de tu agente.
  3. El agente indexa el contenido para la búsqueda semántica.
  4. El agente confirma la carga con un mensaje de éxito.

Nota:

Si ya existe un documento con el mismo nombre de archivo, el nuevo contenido lo reemplaza. Cárguelo usando el mismo nombre para actualizar 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 contexto inmediato para su análisis, incluidos scripts de solución de problemas, archivos de configuración, seguimientos 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

Cargue archivos a través de >Configuración de conocimientos>Agregar archivo para conservar documentos para que el agente los consulte en conversaciones futuras. 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

Nota:

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 adjuntos del chat admiten código, scripts, infraestructura y formatos web que la configuración de conocimientos no admite.

Documentos generados por el agente

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

El cuadro de diálogo Agregar archivo en Configuración de Conocimiento con los formatos admitidos y la opción de cargar mediante arrastrar y soltar

Ejemplo: documentar el conocimiento sobre 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 la 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.

Prerrequisitos

Antes de usar la herramienta Cargar documento de conocimiento , asegúrese de cumplir los siguientes requisitos.

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 autónoma (las acciones de escritura requieren aprobación en modo de revisión)

Límites

Los límites siguientes se aplican a los documentos de conocimiento cargados.

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
Máximo de archivos 5 por mensaje 1 por acción
Extensiones admitidas 31 28 2 (.md, .txt)
Caracteres de nombre de archivo Letras, números, guiones, caracteres de subrayado, puntos Iguales
Longitud máxima del nombre de archivo 1024 caracteres Iguales

Cuándo usar algo más

En la tabla siguiente se describen los escenarios en los que un enfoque diferente es más adecuado.

Escenario Mejor enfoque
Conexión del contenido wiki en vivo que se mantiene sincronizado Conocimientos de wiki de Azure DevOps
Carga de archivos binarios (PDF, Word, imágenes) Cargar a través deConstructor>Configuración de conocimiento>Agregar archivo
Importación masiva de muchos documentos a la vez Utilice el comando srectl doc upload --file <path> CLI
Mantener actualizados los repositorios de código automáticamente Conexión de un conector de GitHub o Azure DevOps

Empieza ahora

Recurso Lo que aprendes
Carga de documentos de conocimiento Añadir runbooks y documentos a la configuración de conocimientos del agente
Capacidad Lo que agrega
Conocimientos de wiki de Azure DevOps Conectar contenido wiki en vivo que se actualiza automáticamente
Análisis de la causa raíz Investigar problemas y, a continuación, capturar los resultados