Integración del agente en la nube Copilot con Jira

La GitHub Copilot integración en Jira permite invocar agente en la nube de Copilot sin salir del área de trabajo de Jira. Desde Jira, puedes iniciar agente de nube sesiones y abrir pull requests utilizando el contexto del título, la descripción, las etiquetas, los comentarios y cualquier campo personalizado de Atlassian, como los criterios de aceptación.

Prerrequisitos

• Debe tener una cuenta GitHub con acceso a Copilot a través de un plan Copilot de pago.
• Debe disponer de una cuenta de Jira Cloud, Jira debe ser una aplicación con IA y Rovo debe estar activado para su organización. Consulte Activate AI for apps (Activar IA para aplicaciones ) en la documentación de Atlassian.
• La instalación y la autenticación deben completarse para Jira y GitHub.

Instalación

Para instalar la GitHub Copilot aplicación para Jira y autorizarla para su GitHub organización o cuenta empresarial, necesita:

• Permiso de administrador para el sitio de Jira.
• Permisos de propietario o administrador de GitHub aplicaciones para su GitHub organización.

Esta integración se basa en una aplicación Atlassian Forge y una GitHub aplicación. Ambos son necesarios para la integración. Una vez instalado correctamente, los usuarios autorizados del área de trabajo de Jira con acceso de escritura a un GitHub repositorio podrán desencadenar el agente desde Jira.

Instalación de GitHub Copilot para la aplicación de Jira en GitHub.com

1. Vaya a la GitHub Copilot página de instalación de Jira en Atlassian Marketplace.

2. Haga clic en Obtener ahora.

3. Seleccione el sitio atlassian en el que desea instalar la GitHub aplicación.

4. Haga clic en Revisar para comprobar los detalles de la instalación y, a continuación, haga clic en Obtener ahora.

   Una vez que GitHub Copilot for Jira esté instalado en su sitio de Jira, debe autorizar la aplicación para acceder a su organización y sus repositorios de GitHub.

5. Haga clic en Configurar en el mensaje de confirmación de Jira después de la instalación.

   • Si no se le redirige automáticamente, vaya a la GitHub Copilot página de instalación de Jira en .GitHub Marketplace Haga clic en Instalar.

6. Si aún no ha iniciado sesión en GitHub, haga clic en el texto resaltado Iniciar sesión en GitHub y siga las indicaciones para iniciar sesión en su cuenta de GitHub y autorizar la aplicación.

   • Si su organización o empresa usa el inicio de sesión único (SSO), es posible que tenga que iniciar una sesión de SAML activa para su organización y realizar un paso de autorización adicional.

7. Haga clic en Instalar aplicación para conceder permiso a la aplicación para acceder a la información de la cuenta de GitHub.

8. Elija la organización y los repositorios a los que tiene acceso la aplicación. Sus GitHub organizaciones están habilitadas de forma predeterminada para su espacio de trabajo de Jira. Opcionalmente, en la página Instalar GitHub Copilot para Jira, desmarque la organización y los repositorios a los que no desea que la aplicación tenga acceso.

9. Haga clic en Instalar.

10. Una vez completada la instalación, verá una lista de organizaciones conectadas en la GitHub Copilot página de configuración de aplicaciones para Jira en Jira.

Instalación de GitHub Copilot para la aplicación de Jira en GHE.com

1. Vaya a la GitHub Copilotpágina de instalación de Jira (GHEC con residencia de datos) en Atlassian Marketplace.

2. A la derecha del nombre de la aplicación, haga clic en y escriba SUBDOMAIN.ghe.com en el cuadro de texto . Reemplace SUBDOMAIN por el subdominio de la empresa de GHE.com.

3. Haga clic en Guardar configuración.

4. Haga clic en Obtener ahora.

5. Seleccione el sitio atlassian en el que desea instalar la GitHub aplicación.

6. Haga clic en Revisar para comprobar los detalles de la instalación y, a continuación, haga clic en Obtener ahora.

   Una vez instalado GitHub Copilot para Jira en tu sitio de Jira, debes autorizar la aplicación para acceder a tu organización y repositorios de GitHub.

7. Haga clic en Configurar en el mensaje de confirmación de Jira después de la instalación.

   • Si no se le redirige automáticamente, busque GitHub Copilot la aplicación de Jira en la lista de aplicaciones disponibles para su empresa en SUBDOMAIN.ghe.com/apps/external-app/github-copilot-for-jira. Haga clic en Instalar.

8. Si aún no ha iniciado sesión en GitHub, haga clic en Iniciar sesión en GitHub resaltado y siga las indicaciones para iniciar sesión en su cuenta de GitHub y autorizar la aplicación.

   • Si su organización o empresa usa SSO, es posible que tenga que iniciar una sesión SAML activa para su organización y completar un paso adicional de autorización.

9. Haga clic en Instalar aplicación para conceder permiso a la aplicación para acceder a la información de la cuenta de GitHub.

10. Elija la organización y los repositorios a los que tiene acceso la aplicación. Tus GitHub organizaciones están habilitadas por defecto para tu área de trabajo de Jira. Opcionalmente, en la página Instalar GitHub Copilot para Jira, desmarque las organizaciones y los repositorios a los que no desea que la aplicación acceda.

11. Haga clic en Instalar.

12. Una vez completada la instalación, verá una lista de organizaciones conectadas en la GitHub Copilot página de configuración de aplicaciones para Jira en Jira.

Utilización de la aplicación GitHub Copilot en Jira

La Copilot aplicación debe estar habilitada para una GitHub organización de la que sea miembro para poder empezar a usarla.

La primera vez que use agente en la nube de Copilot en Jira, deberá conectarla a su GitHub cuenta.

Solo los usuarios con acceso de escritura a un repositorio pueden activar agente en la nube de Copilot para que funcione en ese repositorio.

Puede activar agente en la nube de Copilot de varias formas:

• AsignarGitHub Copilot a un elemento de trabajo mediante el campo Responsable.
• Mencione a@GitHub Copilot en un comentario sobre un elemento de trabajo.
• Usa una automatización de Jira. En las reglas de automatización de Jira, seleccione la acción Usar GitHub Copilot y configure el flujo para usar un desencadenador personalizado basado en eventos Jira, como cuando se crea o cambia un elemento de trabajo, o se aplica una etiqueta. Para más información, consulte Trabajar con agentes de IA en Jira en la documentación de Atlassian.

Ejemplo: Activación de agente en la nube de Copilot en un elemento de trabajo de Jira

1. En Jira, abra o cree un elemento de trabajo que contenga requisitos claros que desea delegar en agente en la nube de Copilot.

2. Para especificar un repositorio en el que desea Copilot trabajar, mencione en la descripción del elemento de trabajo o en un comentario.

3. Asigne GitHub Copilot al elemento de trabajo o mencione @GitHub Copilot en un comentario. Por ejemplo:

   @GitHub Copilot create a new API endpoint for user authentication in octo-org/octorepo
   

4. Si no ha conectado previamente la GitHub aplicación en Jira a su GitHub cuenta, siga las indicaciones para autorizar la aplicación para GitHub y Atlassian.

5. Una vez que agente en la nube de Copilot haya empezado a trabajar en la solicitud de extracción, aparecerá un comentario en el panel de chat de Jira. El usuario que inició la sesión del agente puede ver el progreso allí.

6. Puede seguir con instrucciones adicionales para Copilot:

   • Usa el botón Continuar en chat bajo el encabezado Agentes para chatear directamente con Copilot para que realice actualizaciones en la solicitud de extracción actual.
   • Mencione @GitHub Copilot en un comentario sobre el elemento de trabajo para que las actualizaciones se realicen en una nueva solicitud de incorporación de cambios.

Ver la actividad del agente en Jira

Aunque agente de nube funciona sus transmisiones de actividad en directo en el panel de chat de Jira, por lo que puede seguir lo que el agente está haciendo sin salir del elemento de trabajo. La secuencia de actividad incluye un vínculo a la sesión del agente asociado en GitHub.

Redirección de Copilot desde Jira posterior a la sesión

Cuando agente en la nube de Copilot haya completado una sesión, por ejemplo, cuando una solicitud de extracción esté lista para revisión, puede indicarle a Copilot que continúe el trabajo:

• En el panel de chat de Jira, seleccione el vínculo a la sesión del agente asociado en GitHub. Esto abre el panel de agentes en GitHub, donde puedes revisar la sesión y enviar instrucciones de seguimiento para actualizar la pull request existente.
• Agrega una mención o un comentario de seguimiento @GitHub Copilot en el elemento de trabajo de Jira. Esto inicia una nueva sesión y abre una nueva solicitud de incorporación de cambios en lugar de actualizar la existente.

Personalización de agente en la nube de Copilot en Jira

Puede personalizar cómo agente en la nube de Copilot funciona en el área de trabajo de Jira especificando modelos, agentes e instrucciones personalizadas.

Especificación de un modelo

Especifique un modelo cuando desee que una tarea se ejecute en un modelo específico en lugar del predeterminado. Por ejemplo, puede elegir un modelo más ligero para cambios habituales y bien delimitados. Para cambiar el modelo usado por agente en la nube de Copilot para una tarea determinada, incluya el nombre del modelo en las instrucciones para Copilot, consulte Cambio del modelo de IA para GitHub Copilot agente en la nube.

Especificación de un agente personalizado

Especifique un agente personalizado para adaptar agente de nubeel comportamiento de un determinado flujo de trabajo o repositorio. Puede especificar un agente personalizado desde el repositorio GitHub directamente en el ticket de Jira. Para obtener más información, vea Creación de agentes personalizados para agente en la nube de Copilot.

Usar instrucciones personalizadas

Use instrucciones personalizadas para establecer los valores predeterminados que se aplican a cada sesión, como el repositorio de destino, por lo que Copilot no tiene que pausar y solicitar la entrada a mitad de sesión. Puede definir instrucciones personalizadas a nivel de área de trabajo de Jira que se apliquen cada vez que agente en la nube de Copilot se desencadene.

Costos de uso

agente en la nube de Copilot usa GitHub Actions minutos y AI credits.

Para obtener más información, vea Facturación basada en el uso para organizaciones y empresas.

Añadir o eliminar una organización de la aplicación GitHub Copilot de Jira

Un administrador de Jira y GitHub el propietario de la organización pueden habilitar o deshabilitar organizaciones para la integración.

Para cambiar el acceso de la aplicación GitHub Copilot para Jira para una organización:

1. En Jira, vaya a la página de configuración del área de trabajo.
2. Vaya a la página de configuración de aplicaciones de la GitHub Copilot aplicación.
3. Opcionalmente, haga clic en Conectar más GitHub organizaciones para agregar nuevas organizaciones a la lista.
4. Habilite o deshabilite la Copilot aplicación para una o varias de las organizaciones enumeradas.

Solución de problemas

Si tiene problemas, pruebe las siguientes soluciones.

No se puede ver agente en la nube de Copilot y no es posible asignarlo a un elemento de trabajo jira

En Jira, compruebe la configuración de Administración de Atlassian para su organización como se indica a continuación.

1. Jira es una aplicación habilitada para IA, consulte Activación de ia para aplicaciones en la documentación de Atlassian.

Puede veragente en la nube de Copilot, pero no es posible asignarlo a un elemento de trabajo de Jira.

Compruebe que ha conectado su cuenta GitHub personal a la GitHub Copilot aplicación para Jira.

1. En Jira, vaya a la página de configuración de su cuenta personal.
2. En la configuración general, seleccione la GitHub Copilot aplicación de Jira.
3. Si aún no ha iniciado sesión con GitHub, siga las indicaciones para iniciar sesión y autorizar la aplicación.

Al chatear con GitHub Copilot, se le pedirá que inicie sesión.

Para iniciar sesión en GitHub Copilot en la aplicación de Jira, siga los pasos anteriores en Puede ver el agente en la nube de Copilot, pero no es posible asignarlo a un elemento de trabajo de Jira.

Otros usuarios de tu espacio de trabajo pueden asignar agente en la nube de Copilot a un elemento de trabajo de Jira, pero tú no puedes

Si agente en la nube de Copilot no puede acceder a los recursos de su organización en Jira o trabajar con ellos, y su organización usa SSO en GitHub, es posible que deba volver a autorizar la aplicación GitHub Copilot para Jira en su cuenta de GitHub. Para obtener más información, vea Acerca de la autenticación con el inicio de sesión único (SSO).

Para resolver este problema, siga estos pasos para iniciar una nueva sesión de SSO activa para su organización:

1. Vaya a la configuración de la organización en GitHub.
2. En "Inicio de sesión único", busque la organización en la que necesita autenticarse y haga clic en Cerrar sesión y, a continuación, inicie sesión.
   • Si su empresa gestiona el SSO para su organización, iniciar sesión en una organización dentro de la empresa actúa como una sesión de SSO para todas las organizaciones.
3. Vuelva a Jira y actualice la página en la que trabaja.
4. Intente trabajar con agente en la nube de Copilot en Jira de nuevo.

GitHub Copilot no responde

• Compruebe GitHubla página de estado para ver si hay algún incidente activo.
• Compruebe la página de estado de Atlassian para ver si hay incidentes activos.
• Compruebe que agente en la nube de Copilot tiene acceso al repositorio mediante la prueba si puede asignar Copilot a un problema en GitHub.
• Compruebe que la GitHub Copilot aplicación para Jira tiene acceso al repositorio. Consulte Revisión y modificación de aplicaciones de GitHub instaladas.

Lectura adicional

• Acerca de GitHub Copilot agente en la nube
• Administración del acceso al agente de nube de GitHub Copilot
• Configuración de servidores MCP para el repositorio
• Colaboración en elementos de trabajo con agentes de inteligencia artificial en la documentación de Atlassian