conector de Microsoft 365 Copilot wiki de DevOps de Azure

El conector de Microsoft 365 Copilot wiki de DevOps de Azure permite a su organización indexar wikis en su instancia del servicio Azure DevOps. Después de configurar el conector, los usuarios finales pueden buscar wikis de proyecto y wikis de código de Azure DevOps en Microsoft Search y Microsoft 365 Copilot.

Este artículo está destinado a administradores de Microsoft 365 o a cualquier persona que configure, ejecute y supervise un conector DevOps Wiki Copilot Azure.

Capacidades

• Indexación de wikis de Azure DevOps
• Permitir que los usuarios finales hagan preguntas relacionadas con wikis de proyecto y wikis de código.
• Use la búsqueda semántica en Copilot para permitir a los usuarios encontrar contenido relevante basado en palabras clave, preferencias personales y conexiones sociales.

Limitaciones

• El conector solo indexa una organización de ADO por conexión.

Filtros de datos personalizados

El conector wiki de Azure DevOps incluye los siguientes filtros de datos personalizados para Copilot Search:

• Ruta de acceso de área
• Asignado a

Requisitos previos

• Debe ser el administrador de búsqueda del inquilino de Microsoft 365 de su organización.

• Para permitir que el conector se conecte a la organización Azure DevOps, debe habilitar el acceso a aplicaciones de terceros a través de OAuth. Para obtener más información, consulte Administración de directivas de seguridad para obtener más información.

  

• Cuenta de servicio: para conectarse a Azure DevOps y permitir que el conector DevOps Wiki Copilot de Azure actualice wikis con regularidad, necesita una cuenta de servicio con los siguientes permisos concedidos. La cuenta de servicio es la entidad de servicio publicada por Microsoft (para la autenticación de credenciales federadas) o la cuenta de administrador de Microsoft 365 iniciada (para Microsoft Entra ID autenticación de OAuth), en función del método de autenticación seleccionado.

  Nombre del permiso	Tipo de permiso	Requerido para
  Visualización de información de nivel de proyecto	Permiso de proyecto	Rastreo Azure Wiki de DevOps. Este permiso es obligatorio para los proyectos que deben indexarse.

Introducción

Elección del nombre para mostrar

Se usa un nombre para mostrar para identificar cada cita en Copilot, lo que ayuda a los usuarios a reconocer fácilmente el archivo o elemento asociado. El nombre para mostrar también significa contenido de confianza. El nombre para mostrar también se usa como filtro de origen de contenido. Hay un valor predeterminado para este campo, pero puede personalizarlo para un nombre que los usuarios de su organización reconozcan.

Proporcionar tipo de autenticación

Para autenticar y sincronizar wikis de Azure DevOps, elija uno de los dos métodos admitidos:

• Credencial federada (recomendada): usa una entidad de servicio de Microsoft Entra publicada por Microsoft como cuenta de servicio de rastreo. Los permisos concedidos a esta entidad de servicio en Azure DevOps determinan lo que el conector puede indexar.
• Microsoft Entra ID OAuth: usa OAuth delegado donde la cuenta de administrador de Microsoft 365 que ha iniciado sesión actúa como cuenta de servicio de rastreo. En este caso, los permisos Azure DevOps asignados a esa cuenta de administrador determinan lo que el conector puede indexar.

Credencial federada (recomendado)

La credencial federada usa una aplicación empresarial publicada por Microsoft como cuenta de servicio de rastreo. Debe conceder a esta entidad de servicio los permisos necesarios en Azure DevOps.

Confirmación de que la aplicación de entidad de servicio está aprovisionada

1. Ve al Centro de administración Microsoft Entra.
2. Busque Graph Connector Federated Credential App o use el identificador de la aplicación: 933838e2-bec1-440f-a634-9363c82e5b6d.
3. Si la aplicación no está aprovisionada, abra la página Conectores de Copilot en el Centro de administración de Microsoft 365. El aprovisionamiento puede tardar varias horas.

Conceder acceso a la aplicación Microsoft Entra a Azure proyectos de DevOps

Conceda a la entidad de servicio acceso a los proyectos Azure DevOps que desea indexar.

1. Vaya a Azure DevOps y seleccione la organización.
2. Seleccione Configuración de la organización.
3. En el panel izquierdo, en General, seleccione Usuarios.
4. Seleccione Agregar usuarios.
5. En Usuarios o entidades de servicio, escriba el identificador de la aplicación: 933838e2-bec1-440f-a634-9363c82e5b6d.
6. Asigne el nivel de acceso Básico , seleccione los proyectos para indexar y agregue la aplicación al grupo Lectores de proyectos (o a un grupo equivalente). Desactive la opción para enviar una invitación por correo electrónico.

Configuración de la autenticación de credenciales federadas

Seleccione Federated Credential (Credencial federada ) como tipo de autenticación y autentíquese cuando se le solicite.

Microsoft Entra ID OAuth

Asegúrese de que la organización de ADO está conectada a Microsoft Entra

El conector DevOps Wiki Copilot de Azure solo indexa el contenido de una organización de ADO conectada con Microsoft Entra del inquilino. Para asegurarse de que la organización de ADO está conectada con Microsoft Entra cuenta, siga estos pasos.

1. Vaya a Azure DevOps y seleccione la organización necesaria.
2. Seleccione Organization settings.
3. En el panel de navegación izquierdo, seleccione Microsoft Entra en el encabezado "General".
4. Asegúrese de que la organización está conectada a la cuenta de Microsoft Entra del inquilino.

Creación de un registro de aplicación Microsoft Entra ID

1. Vaya al Azure Portal e inicie sesión con las credenciales de administrador del inquilino.
2. Vaya a Microsoft Entra ID ->Manage ->Registros de aplicaciones en el panel de navegación y seleccione Nuevo registro.
3. Proporcione un nombre para la aplicación y seleccione Registrar.
4. Anote el identificador de aplicación (cliente). Este identificador se usa para conceder a la aplicación Microsoft Entra acceso a los proyectos de la organización de ADO.
5. Abra permisos de API en el panel de navegación y seleccione Agregar un permiso.
6. Seleccione Azure DevOps y, después, Permisos delegados.
7. Busque los permisos siguientes y seleccione Agregar permisos.
   a. Identidad (lectura)
   b. Código (lectura)
   c. Derechos (lectura)
   d. Proyecto y equipo (lectura)
   e. Gráfico (lectura)
   f. Administración de MemberEntitlement (lectura)
   g. Wiki (lectura)
8. Seleccione Conceder consentimiento de administrador para [TenantName] y confirme seleccionando Sí.
9. Compruebe que los permisos están en el estado "Concedido".
10. Abra Autenticación en el panel de navegación. Seleccione Add a platform y elija Web. Agregue uno de los siguientes URI en "URI de redirección":
    • Para M365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback
    • Para M365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback
11. En Concesión implícita y flujos híbridos, compruebe la opción ID tokens (used for implicit and hybrid flows) y haga clic en Configurar.
12. En el panel de navegación, seleccione Certificados y secretos en Administrar.
13. Seleccione Nuevo secreto de cliente y seleccione un período de expiración para el secreto. Copie el secreto generado (Valor) y guárdelo porque no se muestra de nuevo.
14. Use este secreto de cliente y el identificador de aplicación para configurar el conector.

Conceder acceso a la aplicación Microsoft Entra a los proyectos de la organización de ADO

Debe proporcionar a la aplicación Microsoft Entra el acceso necesario a los proyectos que deben indexarse mediante los pasos siguientes:

1. Vaya a Azure DevOps y seleccione la organización necesaria.
2. Seleccione Organization settings.
3. En el panel de navegación izquierdo, seleccione Users en el encabezado "General".
4. Seleccione Add users.
5. Copie el identificador de aplicación (cliente) obtenido de la aplicación en "Usuarios o entidades de servicio".
6. Conceda el nivel de Basic acceso y seleccione los proyectos para permitir el acceso al índice. Además, agregue al Project Reader grupo Azure DevOps (o equivalente) para garantizar el acceso. Anule la selección de la opción para enviar una invitación por correo electrónico a los usuarios.

Seleccionar organización

Proporcione el nombre de la organización Azure DevOps. El nombre de la organización Azure DevOps es el segmento después de https://dev.azure.com/. Por ejemplo:

• URL: https://dev.azure.com/contoso
• Organización: contoso

Solo se requiere el nombre de la organización: no proporcione la dirección URL completa.

Implementación a un público limitado

Implemente esta conexión en una base de usuarios limitada si desea validarla en Copilot y en otras superficies de búsqueda antes de expandir el lanzamiento a una audiencia más amplia. Para obtener más información sobre el lanzamiento limitado, consulte Lanzamiento preconfigurado.

En este momento, está listo para crear la conexión para Azure wikis de DevOps. Puede hacer clic en Crear para publicar la conexión y indexar wikis desde la organización de DevOps de Azure.

Para otras configuraciones, como permisos de acceso, reglas de inclusión de datos, esquema, frecuencia de rastreo, etc., tenemos valores predeterminados basados en lo que funciona mejor con los datos de ADO. Puede ver los valores predeterminados siguientes:

Si desea editar cualquiera de estos valores, debe elegir la opción "Configuración personalizada".

Configuración personalizada

La configuración personalizada es para aquellos administradores que quieren editar los valores predeterminados de la configuración enumerada en la tabla anterior. Una vez que haga clic en la opción "Configuración personalizada", verá tres pestañas más: Usuarios, Contenido y Sincronización.

Usuarios

Permisos de acceso

El conector DevOps Wiki Copilot de Azure admite permisos de búsqueda visibles para todos los usuarios o solo personas con acceso a este origen de datos. Si elige Todos, los datos indexados aparecerán en los resultados de búsqueda de todos los usuarios. Si elige Solo las personas con acceso a este origen de datos, los datos indexados aparecerán en los resultados de la búsqueda para los usuarios que tengan acceso a él.

Contenido

Elección de proyectos

En este paso, especificará el ámbito de los datos que desea indexar mediante el conector DevOps Wiki Copilot de Azure. A continuación, puede elegir la conexión para indexar toda la organización o proyectos específicos dentro de la organización seleccionada.

Si decide indexar toda la organización, se indizan las wikis de todos los proyectos de la organización. Los nuevos proyectos y wikis se indexan durante el siguiente rastreo después de crearse.

Si decide indexar proyectos individuales, solo se indizan las wikis de los proyectos seleccionados.

Administrar propiedades

Aquí puede agregar o quitar las propiedades disponibles del origen de datos Azure DevOps, asignar un esquema a la propiedad (definir si una propiedad se puede buscar, consultar, recuperar o refinar), cambiar la etiqueta semántica y agregar un alias a la propiedad. Las propiedades seleccionadas de forma predeterminada se enumeran a continuación.

Vista previa de datos

Use el botón vista previa de los resultados para comprobar los valores de ejemplo de las propiedades seleccionadas.

Sincronizar

El intervalo de actualización determina la frecuencia con la que se sincronizan los datos entre el origen de datos y el índice del conector DevOps Wiki Copilot de Azure. Hay dos tipos de intervalos de actualización: rastreo completo y rastreo incremental. Para obtener más información, vea Actualizar configuración.

Puede cambiar los valores predeterminados del intervalo de actualización desde aquí si lo desea.

Configurar la página de resultados de búsqueda

Después de publicar la conexión, debe personalizar la página de resultados de búsqueda con verticales y tipos de resultados. Para obtener información sobre cómo personalizar los resultados de la búsqueda, revise cómo administrar los tipos de resultados y verticales.

También puede usar el diseño de resultados de ejemplo para el conector DevOps Wiki Copilot de Azure. Copie y pegue el json de diseño de resultados para empezar.

Solución de problemas

Después de publicar la conexión, puede revisar el estado en la sección Conectores del Centro de administración. Para obtener información sobre cómo realizar actualizaciones y eliminaciones, consulte Administración del conector.

Para solucionar problemas, consulte Solución de problemas.