Tutorial: Subida de documentos de conocimiento en Azure Agente SRE

En este tutorial, usted cargará documentos de conocimiento en su agente de SRE de Azure para que este pueda referirse a ellos durante futuras investigaciones. Aprenderá a guardar los resultados de la investigación directamente en la configuración del conocimiento a través del chat y cómo cargar archivos existentes a través de la interfaz de usuario del portal.

En este tutorial aprenderá a:

  • Convierta una investigación en un runbook reutilizable y almacénelo en Configuración de conocimientos.
  • Comprobar que el contenido cargado está indexado y se puede buscar
  • Carga de archivos o carpetas individuales a través del portal
  • Pruebe que el agente puede recuperar el contenido cargado en una nueva conversación

Tiempo estimado: 10 minutos

Prerrequisitos

  • Un agente de SRE de Azure en estado en ejecución
  • Permisos de escritura en el agente
  • Modo de ejecución del agente establecido en Revisar o Autónomo

Paso 1: 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 ( cualquier conversación en la que 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, a continuación, continúe con el paso 2.

Paso 2: Pedir al agente que cree un runbook

En el mismo subproceso de investigación, pida al agente que pase la información encontrada a un runbook y la guarde en la configuración 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 Knowledge settings as high-memory-runbook.md

El agente:

  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 Configuración de conocimiento y confirma la carga.

El agente confirma que el documento se guardó y proporciona un vínculo de descarga. El runbook está almacenado ahora en la configuración de conocimientos y se ha indexado para realizar búsquedas.

Checkpoint

  • El agente generó un manual operativo estructurado basado en la investigación.
  • El agente confirmó que el documento se guardó.

Paso 3: Verificar en configuración de Knowledge

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

La página Configuración 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.

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

Checkpoint

  • Vaya a Builder → Knowledge settings (Configuración de conocimientos de Builder →)
  • Aparece el documento con ✓ Estado indexado

Paso 4: Carga de archivos a través del portal

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

Carga de archivos individuales

  1. En la página Orígenes 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 archivo para cargarlo.

Carga de una carpeta

También puede arrastrar una carpeta completa (incluidas las subcarpetas anidadas) al área de transferencia.

  1. En la página Orígenes de conocimiento , seleccione Agregar archivo.
  2. Arrastre una carpeta desde el administrador de archivos directamente a la zona de colocación.
  3. El portal extrae todos los archivos admitidos de la carpeta y sus subcarpetas y, a continuación, los enumera en el cuadro de diálogo.
  4. Revise la lista de archivos: quite los archivos que no quiera seleccionando el icono de eliminación situado junto a cada archivo.
  5. Seleccione Agregar archivo para cargar todos los archivos enumerados.

El portal filtra automáticamente los archivos con extensiones no admitidas. Para obtener la lista completa de extensiones y límites de tamaño admitidos, consulte la página de funcionalidad Cargar documentos de conocimiento.

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

Nota:

Al cargar una carpeta, el portal no conserva la estructura de carpetas: los archivos de las subcarpetas aparecen como documentos individuales. Si los archivos de diferentes subcarpetas comparten el mismo nombre, solo se carga el primer archivo.

Checkpoint

  • Se seleccionó Agregar archivo y se mostró el cuadro de diálogo de carga.
  • Subió un archivo o movió una carpeta con éxito.
  • Los archivos aparecen en Orígenes de conocimiento con ✓ Estado indexado .

Paso 5: Probar la recuperación en una nueva conversación

Inicie un nuevo subproceso de chat y haga una pregunta que los documentos cargados deben responder:

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

El agente examina la configuración de conocimientos, localiza el runbook que se ha cargado y apunta a él en la respuesta. Este proceso confirma que el conocimiento está indexado y recuperable.

Checkpoint

  • Inició un nuevo hilo de chat
  • Se ha hecho una pregunta relacionada con el contenido cargado
  • El agente hizo referencia al documento cargado en su respuesta.

Eliminación de un documento de conocimiento

  1. Vaya a Generador → Configuración de conocimientos.
  2. En la lista de documentos, seleccione uno o varios documentos mediante las casillas.
  3. Seleccione Eliminar en la barra de herramientas.
  4. Un cuadro de diálogo de confirmación muestra los documentos que se van a quitar. Seleccione Eliminar para confirmar.

Al eliminar documentos, los quita de la configuración de conocimientos del agente y ya no aparecen en los resultados de búsqueda.

Nota:

No se pueden editar los documentos de conocimientos directamente. Para actualizar un documento, cargue una nueva versión con el mismo nombre de archivo. La nueva versión reemplaza a la versión anterior.

Lo que ha aprendido

  • El agente puede convertir investigaciones reales en runbooks estructurados y guardarlas en Configuración de conocimiento.
  • Puede cargar archivos manualmente a través de la interfaz de usuario del portal en Builder → Configuración de conocimientos. Admite muchos formatos, incluidos PDF, documentos de Office e imágenes.
  • El sistema indexa los documentos cargados para la búsqueda semántica, y están disponibles en futuras conversaciones.
  • Para actualizar los documentos, cárguelos con el mismo nombre de archivo.

Solución de problemas

Error Causa Corregir
"La memoria del agente está deshabilitada. No se pueden cargar documentos". Las configuraciones de conocimiento no están habilitadas en tu agente Póngase en contacto con el administrador para habilitar la configuración de Knowledge.
"No tengo permiso de escritura de la configuración de conocimientos" El agente no pudo encontrar la herramienta de carga Reformule la solicitud: "Guardarlo en la sección de configuración 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" Contenido demasiado grande para un solo documento Dividir 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 su solicitud (por ejemplo, runbook.md)
Recurso Lo que aprendes
Carga de documentos de conocimiento Cómo funciona y por qué importa
Crear una aptitud Desarrollar habilidades procedimentales que complementan documentos de conocimiento
Habilidades Cómo funcionan conjuntamente las aptitudes y los conocimientos
Conocimientos de wiki de ADO Conexión del contenido wiki en directo como origen de conocimiento
  • Last updated on