Compartir a través de

Tutorial: Conexión de una wiki de Azure DevOps al agente de SRE de Azure

En este tutorial, conectará una wiki de Azure DevOps como origen de conocimiento para el agente de SRE de Azure. Después de completar estos pasos, tu agente puede buscar runbooks y procedimientos en la wiki de tu equipo al responder preguntas durante las investigaciones.

En este tutorial aprenderá a:

  • Conexión de una wiki de Azure DevOps mediante el conector de documentación
  • Elección entre la identidad administrada y la autenticación de token de acceso personal (PAT)
  • Para comprobar la conexión, haga una pregunta al agente que use contenido wiki

Tiempo estimado: 10 minutos

Prerrequisitos

Antes de empezar, asegúrese de que tiene los siguientes recursos y acceso:

  • Un agente de SRE de Azure (ya creado).
  • Un proyecto de Azure DevOps con una wiki que contiene contenido.
  • Una de estas opciones de autenticación:
    • Identidad administrada: agregue la identidad administrada de su agente como usuario en la organización de Azure DevOps (Configuración de la organización>Usuarios>Agregar usuarios> introduzca el identificador de cliente de la identidad).
    • Token de acceso personal (PAT): Generar en Azure DevOps con el ámbito de Código (Lectura).

Obtención de la dirección URL de la wiki

Para conectar la wiki, primero necesita la dirección URL de Azure DevOps.

  1. Vaya al proyecto de Azure DevOps.
  2. Seleccione Wiki en la barra lateral izquierda.
  3. Copie la dirección URL de la barra de direcciones del explorador.

La dirección URL tiene el siguiente aspecto:

https://dev.azure.com/{your-org}/{your-project}/_wiki/wikis/{wiki-name}

También se admiten direcciones URL heredadas:

https://{your-org}.visualstudio.com/{your-project}/_wiki/wikis/{wiki-name}

Sugerencia

Para indexar solo una sección específica de la wiki, vaya primero a esa sección en Azure DevOps y copie la dirección URL. El identificador de página de la dirección URL indica al agente que rastree solo esa página y sus subpáginas. Este enfoque es útil para wikis grandes en las que solo una sección como /Operations o /Runbooks es relevante.

Abrir la página Conectores

Vaya a la configuración de conectores en el portal del agente de SRE de Azure.

  1. Vaya a sre.azure.com.
  2. Seleccionar tu agente.
  3. En la barra lateral izquierda, expanda Generador.
  4. Seleccione Conectores.

Aparece una lista de los conectores existentes, en la que se muestran sus nombres, tipos de servicio y estado de conexión.

Iniciar el Asistente para agregar conectores

Seleccione Agregar conector en la barra de herramientas para abrir un asistente de tres pasos:

  1. Elija un conector: seleccione el tipo de conector.
  2. Configurar el conector: configure el nombre, la dirección URL y la autenticación.
  3. Revisar y agregar: Confirmar y crear.

Selección del conector de documentación

En el selector del conector, busque y seleccione Conector de documentación con el subtítulo Azure DevOps. La descripción del conector lee: "El agente hace referencia a la documentación y los archivos para comprender los proyectos y los procesos".

Seleccione Siguiente para continuar con el formulario de instalación.

Configuración del conector

El título del formulario muestra Configuración del conector de Azure DevOps. Rellene los campos siguientes:

Campo Qué escribir
Nombre Un nombre descriptivo (por ejemplo, ops-wiki o team-runbooks)
Azure DevOps URL La URL de tu wiki del paso anterior

Elección del método de autenticación

Seleccione una de las siguientes opciones de autenticación.

  1. Seleccione Identidad administrada (seleccionada de forma predeterminada).
  2. Elija la identidad administrada en la lista desplegable Identidad administrada (el valor predeterminado es Asignado por el sistema).
  3. Opcionalmente, seleccione Usar identidad administrada como credencial de identidad federada.

Opción B: Token de acceso personal (PAT)

  1. Seleccione Token de acceso personal (PAT) .
  2. Pegue el PAT de Azure DevOps en el campo Token de acceso personal .

Seleccione Siguiente para continuar con el paso de revisión.

Revisión y creación del conector

Revise los detalles del conector en la pantalla de resumen y, a continuación, seleccione el botón Enviar para crear el conector.

El nuevo conector aparece en la lista de conectores con el estado Conectado (marca de verificación verde).

Nota:

La indexación inicial puede tardar unos minutos en función del tamaño de la wiki. El agente puede usar el contenido wiki después de que se complete la indexación.

Comprobación de la conexión

Pruebe la nueva conexión wiki haciendo al agente una pregunta que el contenido wiki pueda responder.

  1. Seleccione Nuevo subproceso de chat en la barra lateral.
  2. Haga una pregunta que el contenido de la wiki pueda responder.

Por ejemplo:

What are our standard procedures for handling a database failover?

El agente busca la wiki junto con otros orígenes de conocimiento e incluye citas vinculadas a la página wiki original en su respuesta. La respuesta incluye un vínculo de cita a la página wiki de origen de Azure DevOps.

Solución de problemas

Use la tabla siguiente para resolver problemas comunes con el conector wiki de Azure DevOps.

Cuestión Solución
El conector muestra Desconectado Compruebe el formato de dirección URL de wiki y las credenciales de autenticación.
El contenido wiki no aparece en las respuestas Espere unos minutos para que se complete la indexación inicial y vuelva a intentarlo.
Error de validación de direcciones URL Asegúrese de que la dirección URL coincida con https://dev.azure.com/{org}/{project}/_wiki/wikis/{wiki-name} o https://dev.azure.com/{org}/{project}/_git/{repo}. También se aceptan direcciones URL heredadas visualstudio.com .
Error de autenticación de PAT Compruebe que el PAT tiene el ámbito Código (Lectura) y no esté caducado.
Error en la identidad administrada Compruebe que la identidad administrada del agente se agregue como usuario en su organización de Azure DevOps (Configuración de la organización>Usuarios).

Paso siguiente

Más información sobre los conocimientos de wiki de ADO

Contenido relacionado

  • Last updated on