Conexión de conocimientos en el agente SRE de Azure

Azure agente de SRE es más eficaz cuando puede usar el mismo contexto que usa el equipo para solucionar problemas de sistemas. Conecte guías de procedimientos, documentación, páginas web y repositorios para que su agente pueda consultarlos durante las investigaciones en lugar de empezar desde cero.

Sugerencia

  • Use La base de conocimiento de Builder > para administrar archivos, páginas web y repositorios en un solo lugar.
  • El conocimiento indizado está disponible automáticamente durante las investigaciones y el chat.
  • Puede cargar documentos directamente, adjuntar archivos en el chat o conectar repositorios para realizar un análisis con reconocimiento del origen.
  • Las fuentes de conocimiento más útiles son aquellas de las que tu equipo ya depende, como los manuales operativos, las notas de arquitectura, las guías de resolución de problemas y el código fuente.

¿Por qué importa el conocimiento?

El agente ya tiene integrado el contexto de Azure a través de herramientas de observabilidad y sistemas conectados. Lo que no tiene de forma predeterminada es el conocimiento interno de su equipo. Este conocimiento incluye el runbook que explica un paso de recuperación común, la nota de arquitectura que identifica una dependencia compartida o el repositorio que revela qué implementación introdujo una regresión.

Al conectar ese conocimiento, el agente puede hacer lo siguiente:

  • Consulte los procedimientos operativos del equipo durante un incidente.
  • Vuelva a usar los pasos de solución de problemas que el equipo ya ha documentado.
  • Correlacionar los síntomas con el código fuente y el contexto de implementación.
  • Responda a preguntas con los mismos documentos y referencias que usan los seres humanos.

Gestionar el conocimiento en la base de conocimientos

Usa Base de conocimientos de Builder > para gestionar las fuentes de conocimiento de tu agente.

La página muestra cada origen con su:

  • Nombre
  • Estado
  • Tipo
  • Fecha de última modificación

Hay tres tipos de origen disponibles:

Tipo de origen Qué proporciona Cómo agregarlo
Files Manuales operativos, guías de solución de problemas, documentos de arquitectura y material de referencia Cargar a través del portal o pedir al agente que guarde un documento durante el chat
Páginas web Documentación externa, direcciones URL de wiki internas y páginas de estado Agregue la dirección URL de la página para que el agente pueda indexar el contenido.
Repositorios Código fuente, archivos de implementación y definiciones de infraestructura Conexión de repositorios de GitHub o Azure DevOps

Comprueba el estado de indexación y su vigencia

Cada origen de conocimiento muestra uno de los siguientes estados:

Situación Meaning
Indexado El contenido se procesa y se puede buscar.
Pendiente El contenido todavía se está procesando
No indexado Error de procesamiento o no se pudo indexar el origen

Cuando se indexa una fuente, pase el cursor sobre el indicador de estado para ver la fecha y hora de Creado el. Esta marca de tiempo es útil cuando quiere confirmar que se ha procesado la versión más reciente de un runbook o documento.

Cargar documentos

Cargue documentos cuando desee que los conocimientos permanezcan disponibles en futuras conversaciones.

Entre los ejemplos típicos se incluyen:

  • Runbooks de incidentes
  • Guías de escalado
  • Referencias de arquitectura
  • Listas de comprobación de solución de problemas

Puede cargar archivos a través del portal o pedir al agente que guarde contenido de una conversación en la base de conocimiento.

Para conocer los límites y formatos de archivo admitidos, consulte Carga de documentos de conocimiento.

Para obtener el flujo de trabajo completo, consulte Carga de documentos de conocimiento.

Compartir archivos en chat

Usa los archivos adjuntos del chat cuando quieras dar al agente un contexto inmediato dentro de una sola conversación. Este enfoque es útil para capturas de pantalla, registros, archivos de configuración y otros materiales que ayudan con la solución de problemas activa.

Sugerencia

Si un archivo que adjunte en el chat debe convertirse en conocimiento a largo plazo, pida al agente que lo guarde en Configuración de conocimientos. El agente puede cargar una copia para que el contenido se indexe y se pueda buscar en conversaciones posteriores.

La siguiente tabla compara las cargas de conocimientos a largo plazo con los archivos adjuntos temporales del chat:

Escenario Subir a la base de conocimientos Compartir en chat
Más adecuado para Guías de procedimientos, procedimientos y documentos que quiera tener disponibles en futuras conversaciones Archivos que quiere que el agente analice en este momento
Ámbito de almacenamiento A nivel de agente y con capacidad de búsqueda en conversaciones futuras A nivel de hilo y disponible en la conversación actual
Cómo agregar Cargue en el portal o pida al agente que guarde el contenido. Arrastrar y colocar, pegar desde el Portapapeles o usar + en el chat
Puede convertirse en conocimiento a largo plazo Conocimiento ya consolidado Sí, si pide al agente que lo guarde.

Para obtener más información, consulte Uso compartido de archivos en chat.

Agregar páginas web

Agregue páginas web cuando las instrucciones importantes se encuentran fuera de los archivos cargados o repositorios.

Entre los candidatos adecuados destacan los siguientes:

  • Artículos de wiki internos
  • Documentación del producto público
  • Páginas de estado del servicio
  • Páginas de referencia mantenidas por el equipo

Después de agregar una dirección URL, el agente indexa el contenido de la página para que pueda hacer referencia a esa información durante futuras investigaciones.

Conexión de repositorios

Conecte repositorios de GitHub o de Azure DevOps cuando su agente necesite contexto con reconocimiento del código fuente.

Los repositorios conectados ayudan al agente:

  • Búsqueda de patrones de error en el código fuente
  • Correlación de incidentes con cambios de código recientes
  • Referencia a archivos de implementación y configuración
  • Uso del contenido del repositorio durante el análisis de la causa principal

Para conectar el código fuente, consulte Conexión del código fuente.

Elección del origen de conocimiento adecuado

Use el tipo de origen que coincida con el tipo de contexto que necesita:

Si necesita conectarse... Use...
Guía de solución de problemas o manual de procedimientos almacenada en un archivo Carga de documentos de conocimiento
Captura de pantalla, registro o archivo de una investigación activa Compartir archivos en chat
Un repositorio de GitHub o Azure DevOps Conexión del código fuente
Sistemas externos como Datadog o Splunk Conectores MCP