Compartir a través de

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

En este tutorial, cargará documentos de conocimiento en la base de conocimiento del agente de SRE de Azure mediante dos métodos: pidiendo al agente que cree un runbook desde una investigación y cargue un archivo a través de la interfaz de usuario del portal.

El agente puede capturar los conocimientos detectados durante las investigaciones y almacenarlos para su uso futuro, creando conocimientos institucionales automáticamente. Para obtener más información, consulte Carga de documentos de conocimiento.

En este tutorial aprenderá a:

  • Transformar una investigación en un procedimiento operativo estructurado y guardarlo en la base de conocimientos
  • Carga manual de un archivo a través de la interfaz de usuario del portal
  • Compruebe que los documentos cargados están indexados y disponibles
  • Confirmación de que el agente recupera el conocimiento cargado en nuevas conversaciones

Tiempo estimado: 15 minutos

Prerrequisitos

Antes de comenzar, asegúrese de que dispone de lo siguiente:

  • Un agente de SRE de Azure (Azure SRE Agent) con el estado En ejecución.
  • Permisos de escritura en el agente.
  • Modo de ejecución del agente establecido en Revisar o Autónomo.

Empezar desde una investigación

Los mejores documentos de conocimiento proceden de investigaciones reales. En lugar de crear contenido desde cero, capture lo que el agente ya ha aprendido.

  1. Vaya a sre.azure.com y seleccione el agente.
  2. En la barra lateral izquierda de Chats, busque un subproceso de investigación anterior donde el agente diagnosticó o resolvió un problema y selecciónelo.

Si aún no tiene un hilo de investigación, inicie un nuevo chat y solicite al agente que investigue algo.

Investigate high memory usage on our container apps

Espere a que se complete la investigación y continúe con el paso siguiente.

Crear de un runbook a partir de la investigación

En el mismo hilo de investigación, pida al agente que pase la información encontrada a un runbook y la guarde en la base de conocimientos. Sea específico sobre el nombre de archivo.

Create a runbook from the investigation we just did. Include the root cause
analysis, the diagnostic steps, mitigations, and escalation triggers.
Save it to the knowledge base as high-memory-runbook.md

El agente realiza las siguientes acciones:

  1. Sintetiza el contexto de investigación en un runbook estructurado.
  2. Genera secciones como Análisis de causa principal, Pasos de diagnóstico, Mitigaciones y Desencadenadores de escalación.
  3. Guarda el documento en la base de conocimiento y confirma la carga.

El agente confirma que el runbook se ha guardado en la base de conocimiento como java-app-high-memory-runbook.md.

El agente confirma que el documento se guardó y proporciona un vínculo de descarga. El manual de ejecución se almacena ahora en la base de conocimientos y se indexará para facilitar la búsqueda.

Sugerencia

Especifique un nombre de archivo con una .md extensión o .txt . Esto controla cómo se denomina el documento en la base de conocimiento y facilita la búsqueda más adelante.

Nota:

Si el agente está en modo de revisión , solicita su aprobación antes de ejecutar la carga. Seleccione Aprobar para continuar.

En este momento, confirme lo siguiente:

  • El agente generó un manual de procedimientos estructurado a partir de la investigación.
  • El agente confirmó que se guardó el documento.

Comprobación del documento en la base de conocimiento

Vaya a la base de conocimiento para confirmar que el documento se indizó.

  1. En la barra lateral izquierda, seleccione Generador para expandir la sección.
  2. Seleccione Base de conocimiento.

La página de la base de conocimiento muestra los documentos de una tabla con columnas para Nombre de archivo, Estado, Tipo y Última modificación. La columna Estado muestra Indexado cuando el documento está indexado y listo para la búsqueda.

Página de base de conocimiento que muestra los archivos cargados con estado indexado, columnas para Nombre de archivo, Estado, Tipo y Última modificación.

Si el estado muestra Pendiente, seleccione Actualizar. La indexación se completa normalmente en unos segundos.

Carga de un archivo a través del portal

También puede cargar archivos directamente. Este método es útil para los runbooks, la documentación o los materiales de referencia existentes que ya tiene tu equipo.

  1. En la página Base de conocimiento , seleccione Agregar archivo.
  2. Arrastre un archivo a la zona de colocación o seleccione Buscar archivos para elegir uno.
  3. Seleccione Agregar un archivo para cargarlo.

Cuadro de diálogo de carga que muestra una zona de arrastrar y soltar con formatos de archivo compatibles y tamaño máximo de 100 MB.

El portal acepta los siguientes tipos de archivo:

  • Texto: .md, .txt, .csv, .json, .xml, .yaml, .yml, .log, .ini, .cfg, .conf, .config, .properties
  • Documentos: .pdf, .docx, .pptx, .xlsx, .doc, .ppt, .xls
  • Imágenes: .png, .jpg, .jpeg, .gif, .bmp, .webp, , .tiff.tif

El tamaño máximo de archivo es de 16 MB por archivo, con hasta 100 MB por carga.

Probar la recuperación en una nueva conversación

Confirme que el agente puede encontrar y usar los documentos cargados.

  1. Seleccione Nuevo subproceso de chat en la barra lateral.
  2. Haga una pregunta que sus documentos cargados deberían responder.

Por ejemplo:

What are the steps for troubleshooting high memory usage on container apps?

El agente examina la base de conocimiento, localiza el runbook que se ha cargado y apunta a él en la respuesta. Esto confirma que el conocimiento está indexado y recuperable.

Captura de conocimientos después de incidentes

Después de resolver cualquier problema, pida al agente que conserve lo que ha aprendido:

Create a runbook from the steps we just used to resolve this incident.
Include the root cause, investigation steps, and the fix.
Save it as incident-12345-resolution.md in the knowledge base.

Con el tiempo, esto crea una biblioteca que permite búsquedas de conocimientos institucionales. Cada incidente pasado se convierte en un recurso para futuros.

Actualizar documentos existentes

Cargue un documento con el mismo nombre de archivo para reemplazar la versión anterior:

Update the high-memory-runbook.md document in the knowledge base.
Add a new section about container memory limits as a common cause.

Cargas por lotes a través de la CLI

Importe varios documentos a la vez mediante la CLI:

# Upload a single file
srectl doc upload --file ./runbooks/high-memory-guide.md

# Upload all .md and .txt files in a folder (recursive)
srectl doc upload --file ./runbooks

Solución de problemas

Use la tabla siguiente para resolver problemas comunes con cargas de documentos de conocimiento.

Error Causa Corregir
"La memoria del agente está deshabilitada. No se pueden cargar documentos". La base de conocimiento no está habilitada en el agente. Póngase en contacto con el administrador para habilitar la base de conocimiento.
"No tengo permiso de escritura en la base de conocimiento" El agente no pudo encontrar la herramienta de carga. Rephrase la solicitud: "Guárdela en la base de conocimiento como filename.md"
"Extensión de archivo no válida. Solo se permiten archivos .md y .txt". El nombre de archivo no termina en .md ni .txt (carga de chat). Utiliza una extensión .md o .txt al pedir al agente que guarde.
"El contenido del documento supera el tamaño máximo de 16 MB" El contenido es demasiado grande para un solo documento. Divídalo en varios documentos más pequeños.
"El nombre de archivo no puede estar vacío" No se proporciona ningún nombre de archivo. Incluya un nombre de archivo en el indicador (por ejemplo, runbook.md).

Paso siguiente

Más información sobre la memoria y el conocimiento

Contenido relacionado

  • Last updated on