Compartir a través de


Conector de Microsoft 365 Copilot de elementos de trabajo de Azure DevOps

El conector de Microsoft 365 Copilot de elementos de trabajo de Azure DevOps permite a su organización indexar elementos de trabajo en su instancia del servicio Azure DevOps. Después de configurar el conector, los usuarios finales pueden buscar elementos de trabajo 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 copilot de Elementos de trabajo de Azure DevOps.

Importante

El conector copilot de elementos de trabajo de Azure DevOps solo admite el servicio en la nube de Azure DevOps. Azure DevOps Server 2019, TFS 2018, TFS 2017, TFS 2015 y TFS 2013 no son compatibles con este conector.

Capacidades

  • Indexación de elementos de trabajo de Azure DevOps
  • Permitir que los usuarios finales hagan preguntas relacionadas con los elementos de trabajo.
  • 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

  • Solo indexa una organización de ADO por conexión.

Requisitos previos

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

  • El conector utiliza la cuenta del Administración M365 que ha iniciado sesión como cuenta de servicio de rastreo. Para conectarse a Azure DevOps y permitir que el conector de Copilot actualice los elementos de trabajo con regularidad, debe conceder a la cuenta de Administración M365 los permisos siguientes.

    Nombre del permiso Tipo de permiso Requerido para
    Visualización de información de nivel de proyecto Permiso de proyecto Rastreo de elementos de trabajo de Azure DevOps. Este permiso es obligatorio para los proyectos que deben indexarse.
    Ver análisis Permiso de proyecto Rastreo de elementos de trabajo de Azure DevOps. Este permiso es obligatorio para los proyectos que deben indexarse.
    Visualización de elementos de trabajo en este nodo Ruta de acceso de área Rastrear elementos de trabajo en una ruta de acceso de área. Este permiso es opcional. Solo se rastrean las rutas de acceso de área para las que la cuenta de usuario tiene permiso.

Importante

La cuenta de rastreo debe tener un nivel de acceso básico . Para más información sobre los niveles de acceso en Azure DevOps, consulte Niveles de acceso admitidos.

Introducción

Captura de pantalla que muestra la pantalla de creación de conexiones para el conector copilot de Elementos de trabajo de Azure DevOps.

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.

Agregar la organización de ADO

El conector Copilot de elementos de trabajo de Azure DevOps permite la indexación de una organización por conexión. Para conectarse al servicio Azure DevOps, proporcione el nombre de la organización que se va a indexar.

Importante

  • Asegúrese de escribir solo el nombre de la organización y no la dirección URL completa de la organización.
  • En el ejemplo siguiente se muestra una entrada incorrecta : https://dev.azure.com/<Organization_name>/
  • En el ejemplo siguiente se muestra una entrada correcta : <Organization_name>

Proporcionar tipo de autenticación

Debe seguir algunos pasos para autenticar y sincronizar elementos de trabajo desde Azure DevOps.

Importante

Microsoft Entra ID OAuth

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

El conector copilot de elementos de trabajo de Azure DevOps 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 una cuenta de Microsoft Entra, 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 una aplicación en 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 ->Identity ->Applications ->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 siguientes permisos en vso y seleccione Agregar permisos.
    a. vso.analytics : análisis (lectura)
    b. vso.graph : gráfico (lectura)
    c. vso.identity : identidad (lectura)
    d. vso.project : proyecto y equipo (lectura)
    e. vso.variablegroups_read : grupos de variables (lectura)
    f. vso.work : elementos de trabajo (lectura)
  8. Seleccione Conceder consentimiento de administrador para [TenantName] y confirme seleccionando .
  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.

Autenticación de la aplicación Microsoft Entra con una cuenta de rastreo

La aplicación Entra debería autenticarse automáticamente con la cuenta de Administración iniciada debido al inicio de sesión único. Microsoft Entra emite un token de acceso a la aplicación. Este token de acceso contiene información sobre el usuario y los permisos delegados que se han concedido. La aplicación usa el token de acceso para realizar solicitudes a Azure DevOps. La aplicación solo puede acceder a los datos y realizar acciones que el usuario que ha iniciado sesión también está autorizado a realizar.

4. Lanzamiento a audiencia limitada

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 los elementos de trabajo de Azure DevOps. Puede hacer clic en Crear para publicar los elementos de trabajo de conexión e índice de la organización de Azure DevOps.

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:

Usuarios Descripción
Permisos de acceso Solo las personas con acceso al contenido del origen de datos.
Identidades de mapa Identidades de origen de datos asignadas mediante identificadores de Microsoft Entra.
Contenido Descripción
Projects Todos los proyectos están indexados.
Administrar propiedades Para comprobar las propiedades predeterminadas y su esquema, consulte el contenido.
Sincronizar Descripción
Rastreo incremental Frecuencia: Cada 15 minutos
Rastreo completo Frecuencia: todos los días

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

Captura de pantalla que muestra la pestaña Usuarios donde puede configurar los permisos de acceso.

Permisos de acceso

El conector de Elementos de trabajo de Azure DevOps 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.

Nota:

Novedades a grupos que rigen los permisos de acceso solo se sincronizan en rastreos completos. Los rastreos incrementales no admiten el procesamiento de actualizaciones de permisos.

Contenido

Captura de pantalla que muestra la pestaña de contenido donde puede configurar proyectos y esquema de conexión.

Elección de proyectos

En este paso, especificará el ámbito de los datos que desea indexar mediante el conector Copilot de elementos de trabajo de Azure DevOps. 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, los elementos de trabajo de todos los proyectos de la organización se indizan. Los nuevos proyectos y elementos de trabajo se indexan durante el siguiente rastreo después de crearlos.

Si decide indexar proyectos individuales, solo se indizan los elementos de trabajo de los proyectos seleccionados.

Nota:

Los proyectos de Azure DevOps se pueden rastrear después de conceder los permisos Ver información de nivel de proyecto y Ver análisis .

Administrar propiedades

Aquí puede agregar o quitar propiedades disponibles del origen de datos de 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.

Source (propiedad) Etiqueta Descripción Esquema
AreaPath Ruta de acceso de área al elemento de trabajo Consulta, recuperación y búsqueda
AssignedTo Nombre de la persona a la que se asigna el elemento de trabajo Consulta, recuperación y búsqueda
Autores Autores Recuperar
ChangedBy Última modificación Nombre de la persona que modificó por última vez el elemento de trabajo Consulta, recuperación
ChangedDate Fecha de la última modificación Consulta, recuperación
CreatedBy Creada por Nombre de persona que creó el elemento de trabajo Consulta, recuperación y búsqueda
CreatedDate Fecha y hora de creación Marca de tiempo cuando se creó el elemento de trabajo Consulta, recuperación
Descripción Contenido Descripción del elemento de trabajo Búsqueda
IconUrl IconUrl Recuperar
Id Identificador de elemento de trabajo Consulta, recuperación y búsqueda
Prioridad Prioridad del elemento de trabajo Consulta, recuperación
ReproSteps Pasos para reproducir una condición descrita en el elemento de trabajo
Estado Estado actual del elemento de trabajo Consulta, recuperación y búsqueda
Etiquetas Consulta, recuperación y búsqueda
TeamProject Recuperar
Título Título Título del elemento de trabajo Recuperar, buscar
URL url Dirección URL del elemento de trabajo Recuperar
WorkItemType Consulta, recuperación y búsqueda

Vista previa de datos

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

Sincronizar

Captura de pantalla que muestra la pestaña Sincronizar donde puede configurar la frecuencia de rastreo.

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 copilot de Elementos de trabajo de Azure DevOps. 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.

Sugerencia

Tipo de resultado predeterminado El conector Copilot de Elementos de trabajo de Azure DevOps registra automáticamente un tipo de resultado una vez publicado el conector. El tipo de resultado usa un diseño de resultados generado dinámicamente en función de los campos seleccionados en el paso 3. Para administrar el tipo de resultado, vaya a Tipos de resultado en el Centro de administración de Microsoft 365. El tipo de resultado predeterminado se denomina "ConnectionIdDefault". Por ejemplo, si el identificador de conexión es AzureDevOps, el diseño del resultado se denomina: "AzureDevOpsDefault" Además, puede optar por crear su propio tipo de resultado si es necesario.

Solución de problemas

Después de publicar la conexión, puede revisar el estado en la pestaña Orígenes de datos del Centro de administración. Para obtener información sobre cómo realizar actualizaciones y eliminaciones, consulte Administración del conector. Puede encontrar pasos de solución de problemas para los problemas más vistos aquí.

Si tiene problemas o quiere proporcionar comentarios, póngase en contacto con Microsoft Graph | Soporte técnico.