Implementación del conector Atlassian Jira Cloud Copilot

El conector de Microsoft 365 Copilot de Atlassian Jira Cloud permite a su organización indexar problemas de Jira. Después de configurar el conector y el contenido de índice desde el sitio jira, los usuarios pueden buscar esos elementos en Microsoft Search y Microsoft 365 Copilot experiencias.

En este artículo se describen los pasos para implementar y personalizar el conector de Atlassian Jira Cloud.

Para obtener información sobre la configuración del servicio Jira Cloud, consulte Configuración del servicio Jira Cloud para la ingesta de conectores.

Requisitos previos

Antes de implementar el conector de Atlassian Jira Cloud, asegúrese de que el entorno de Jira Cloud está configurado en su organización. En la tabla siguiente se resumen los pasos para configurar el entorno de Jira Cloud e implementar el conector.

Antes de implementar el conector, asegúrese de cumplir los siguientes requisitos previos:

• Debe ser el administrador de búsqueda del inquilino de Microsoft 365 de su organización.
• Asegúrese de que conoce la dirección URL de la instancia de Jira Cloud para su organización. Para conectarse a los datos de Jira, necesita la dirección URL de la instancia de Jira de su organización.
• Para conectarse a Jira y permitir que el conector Atlassian Jira Cloud Copilot actualice los problemas con regularidad, necesita una cuenta de servicio con los siguientes permisos concedidos.

Implementación del conector

Para agregar el conector Atlassian Jira Cloud para su organización:

1. En el Centro de administración de Microsoft 365, en el panel izquierdo, elija Conectores de Copilot>.
2. Vaya a la pestaña Conectores y, en el panel izquierdo, elija Galería.
3. En la lista de conectores disponibles, elija Atlassian Jira Cloud.

Establecer el nombre para mostrar

El nombre para mostrar se usa para identificar referencias en las respuestas de Copilot para ayudar a los usuarios a reconocer el archivo o elemento asociado. El nombre para mostrar también significa contenido de confianza y se usa como filtro de origen de contenido.

Puede aceptar el nombre para mostrar predeterminado de Atlassian Jira Cloud o personalizar el valor para usar un nombre para mostrar que reconocen los usuarios de su organización.

Para obtener más información sobre los nombres para mostrar y las descripciones de los conectores, consulte Mejora de la detección de Copilot con contenido de conectores Microsoft 365 Copilot.

Establecimiento de la dirección URL de la instancia

Para conectarse a los datos de la nube de Jira, necesita la dirección URL de la instancia de Jira de su organización. La dirección URL de la instancia de Jira de su organización suele ser similar a la siguiente: https://<your-organization-domain>.atlassian.net.

Si aún no tiene una instancia, consulte Atlassian Jira para crear una instancia de prueba.

Elegir tipo de autenticación

Para autenticar y sincronizar problemas desde Jira, elija uno de los siguientes métodos de autenticación admitidos:

• Autenticación básica : escriba el nombre de usuario de la cuenta (normalmente el identificador de correo electrónico) y el token de API para autenticarse mediante la autenticación básica. Para obtener información sobre cómo generar un token de API, consulte Administración de tokens de API para la cuenta de Atlassian.

• Atlassian Jira OAuth 2.0 (recomendado): para usar Jira OAuth para la autenticación:

  1. Registre una aplicación en Atlassian Jira para que la aplicación Microsoft Search y Microsoft 365 Copilot puedan acceder a la instancia. Para obtener más información, vea Habilitar OAuth 2.0.
  2. Inicie sesión en la consola de Atlassian Developer con su cuenta de administrador de Atlassian Jira.
  3. Elija Crear y seleccione Integración de OAuth 2.0.
  4. Proporcione un nombre adecuado para la aplicación y cree la nueva aplicación.
  5. Vaya a Permisos en el panel de navegación de la izquierda. Seleccione Agregar para Jira API y seleccione Configurar. En Permisos granulares, agregue los ámbitos necesarios.
  6. Vaya a Autorización desde el panel de navegación de la izquierda para agregar la dirección URL de devolución de llamada:
     1. Para Microsoft 365 Enterprise:https://gcs.office.com/v1.0/admin/oauth/callback
     2. Para Microsoft 365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback
  7. Seleccione Guardar.
  8. Vaya a Configuración en el panel izquierdo para obtener el identificador de cliente y el secreto. Complete el paso de configuración de conexión mediante el id. de cliente y el secreto.

Implementación

Para implementarse en una audiencia limitada, elija el botón de alternancia situado junto a Lanzamiento a audiencia limitada y especifique los usuarios y grupos a los que se va a implementar el conector. Para obtener más información, consulte Lanzamiento provisional para conectores de Microsoft 365 Copilot.

Elija Crear para implementar la conexión. El conector Atlassian Jira Cloud Copilot comienza a indexar contenido de inmediato.

A continuación se muestran los valores predeterminados para el conector:

Usuarios

• Permisos de acceso: solo las personas con acceso al contenido en el origen de datos.
• Identidades de mapa: identidades de origen de datos asignadas mediante identificadores de Microsoft Entra.

Contenido

• Proyectos de sitio: todos los proyectos están indexados.
• Filtrar datos: todos los problemas se indizan. No se aplica ningún filtro de tiempo ni criterios JQL.
• Administrar propiedades: para comprobar las propiedades predeterminadas y su esquema, consulte Personalización de la configuración de contenido.

Sync

• Rastreo incremental: frecuencia: cada 15 minutos
• Rastreo completo: frecuencia: todos los días

Después de crear la conexión, puede revisar el estado en la sección Conectores de la Centro de administración de Microsoft 365.

Personalización de la configuración (opcional)

Puede personalizar los valores predeterminados para la configuración del conector de Atlassian Jira Cloud. Para personalizar la configuración, en la página del conector del Centro de administración, elija Configuración personalizada.

Personalización de la configuración de usuario

Permisos de acceso

El conector Atlassian Jira Cloud Copilot admite permisos de búsqueda visibles para todos los usuarios o solo para las 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 búsqueda de los usuarios que tengan acceso a ellos. En Atlassian Jira, los permisos de seguridad se definen mediante esquemas de permisos de proyecto que contienen grupos de nivel de sitio y roles de proyecto. La seguridad de nivel de problema también se puede definir mediante esquemas de permisos de nivel de problema.

Asignación de identidades

El método predeterminado para asignar las identidades de origen de datos con Microsoft Entra ID es hacer que el identificador de correo electrónico de los usuarios de Jira sea el mismo que el nombre principal de usuario (UPN) o la dirección de correo electrónico de los usuarios de Microsoft Entra ID. Si la asignación predeterminada no funciona para su organización, puede proporcionar una fórmula de asignación personalizada. Para obtener más información, consulte Asignación de identidades de AD que no son Azure.

• Elija la opción Microsoft Entra ID si el identificador de correo electrónico de los usuarios de Jira es el mismo que el UPN de los usuarios de Microsoft Entra ID.
• Elija la opción No Microsoft Entra ID si el identificador de correo electrónico de los usuarios de Jira es diferente del UPN y el correo electrónico de los usuarios en Entra ID.

Personalización de la configuración de contenido

Elección de proyectos y filtrado de datos

• Proyectos de sitio: puede elegir la conexión para indexar todo el sitio jira o solo proyectos específicos.
  • Si decide indexar todo el sitio jira, los problemas de Jira en todos los proyectos del sitio se indizan. Los nuevos proyectos y problemas se indexan durante el siguiente rastreo después de crearlos.
  • Si elige proyectos individuales, solo se indizan los problemas de Jira en los proyectos seleccionados.

• Filtrar datos: puede elegir filtrar los problemas de Jira que se indexen de dos maneras:
  • Especifique el período de tiempo de modificación del problema. Esta opción solo indexa los problemas de Jira que se crean o modifican en el período de tiempo seleccionado de forma gradual en función del rastreo actual.
  • Use el filtro JQL para indexar solo tipos de problemas de Jira específicos mediante issueType in (Bug, Improvement).

Administrar propiedades

Puede agregar o quitar propiedades disponibles del origen de datos jira, 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. En la tabla siguiente se enumeran las propiedades seleccionadas de forma predeterminada.

Vista previa de datos

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

Personalización de intervalos de sincronización

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 Atlassian Jira Cloud Copilot. A continuación se muestran los dos tipos de intervalos de actualización:

• Rastreo incremental: cada 15 minutos
• Rastreo completo: todos los días

Puede cambiar los valores predeterminados del intervalo de actualización. Para obtener más información, consulte Directrices para la configuración de sincronización.

Contenido relacionado

• Introducción al conector de Atlassian Jira Cloud
• Solución de problemas con el conector Atlassian Jira Cloud
• Configuración de conectores de Copilot en el Centro de administración de Microsoft 365