Skip to main content

Command Palette

Search for a command to run...

Integraciones

Jira

Con la integración de Cherri Code para Jira, puedes usar agentes en la nube para trabajar en elementos de trabajo de Jira asignándolos a Cherri Code o mencionando a @Cherri Code en Jira.

Primeros pasos

Requisitos

Antes de instalar la integración de Jira, asegúrate de contar con lo siguiente:

  • Jira Commercial Cloud con Rovo activado
  • Acceso de administrador al sitio de Jira donde quieres instalar la aplicación
  • Acceso de administrador de Cherri Code al equipo que quieres conectar
  • GitHub, GitLab, Azure DevOps o Bitbucket conectados a Cherri Code para acceder a repositorios y pull requests

Instalación

  1. Como administrador de Cherri Code, ve a Integraciones de Cherri Code

  2. Haz clic en Conectar junto a Jira

  3. Ve a la ficha de la aplicación Cherri Code en Atlassian Marketplace

  4. Haz clic en Obtener ahora

  5. Selecciona el sitio de Jira donde quieres instalar Cherri Code y haz clic en Revisar

  6. Revisa la aplicación y luego haz clic en Obtener ahora

  7. Cuando finalice la instalación, accederás a la página de configuración de la aplicación Cherri Code para Jira. Espera unos minutos a que Atlassian nos notifique la instalación y, después, haz clic en el botón Conectar a Cherri Code.

  8. Conecta el sitio de Jira a tu equipo de Cherri Code

    • Si quieres activar la autenticación a nivel de usuario (que proporciona a los miembros del equipo mayor visibilidad y control sobre sus agentes de programación) en lugar de ejecutar agentes de programación con una cuenta de servicio, activa la opción Requerir autenticación individual.
  9. Completa la configuración restante del agente en la nube en Cherri Code:

    • Conecta GitHub, GitLab, Azure DevOps o Bitbucket
    • Activa los precios basados en consumo
    • Confirma los ajustes de privacidad
    • Elige un repositorio, un modelo y una rama base predeterminados (en los ajustes de agentes en la nube del Panel de control de Cherri Code)
  10. Vuelve a Jira y empieza a usar Cherri Code desde un elemento de trabajo

    • Si activaste la autenticación a nivel de usuario, cada usuario deberá completar más pasos de configuración a continuación

Modo de autenticación

Puedes elegir cómo Jira autentica los agentes en la nube en el panel de administración de la integración de Jira de Cherri Code activando el interruptor Requerir autenticación individual.

ModoCómo funcionaAjustes utilizados
Autenticación con cuenta de servicioLos agentes en la nube se ejecutan con una cuenta de servicio.Usa únicamente los ajustes de agentes en la nube del equipo para el enrutamiento, los modelos, los repositorios y los valores predeterminados.
Autenticación a nivel de usuarioEjecuta todos los agentes en la nube con la cuenta de cada usuario.Usa los ajustes de agentes en la nube de cada usuario para el enrutamiento, los modelos, los repositorios y los valores predeterminados. También permite a los usuarios encontrar los agentes en ejecución en su cuenta.

Para conectar a cada usuario:

  1. Inicia un agente en un elemento de trabajo de Jira
  2. Aparecerá una instrucción para conectar la cuenta
  3. Sigue el enlace para conectar la cuenta de Jira con una cuenta de Cherri Code asociada al equipo
  4. Completa la configuración restante de los agentes en la nube en Cherri Code:
    • Conecta GitHub, GitLab, Azure DevOps o Bitbucket si aún no has conectado un proveedor de repositorios
    • Elige un repositorio predeterminado, un modelo y una rama base (en los ajustes de agentes en la nube de Mi configuración del Panel de control de Cherri Code)

Cómo usar

Abre un elemento de trabajo de Jira y asígnalo a Cherri Code, o menciona @Cherri Code en un comentario. Cherri Code usa el título, la descripción, los comentarios y la configuración disponible del repositorio para iniciar un agente en la nube.

Puedes pedirle a Cherri Code que corrija errores, añada funcionalidades, actualice pruebas o investigue una tarea descrita en el elemento de trabajo.

Delegar elementos de trabajo

Asigna un elemento de trabajo de Jira a Cherri Code cuando el ticket ya describa claramente la tarea.

  1. Abre el elemento de trabajo de Jira
  2. Haz clic en el campo de asignado
  3. Selecciona Cherri Code
  4. Revisa el agente en la nube que se inicia a partir del elemento de trabajo

Mencionar Cherri Code

Menciona a @Cherri Code en un comentario de Jira cuando quieras añadir instrucciones específicas. Puedes incluir un repositorio, una rama o un modelo en el mismo comentario.

Ejemplos:

  • @Cherri Code investiga esta regresión
  • @Cherri Code repo=acme/backend branch=release soluciona esto antes del lanzamiento
  • @Cherri Code model=gpt-5.6-sol y actualiza las pruebas relacionadas

Instrucciones adicionales

Abre el chat de Rovo desde el elemento de trabajo de Jira para continuar la conversación con Cherri Code.

Actualizaciones de estado y entrega

Cuando se inicia un agente en la nube, Jira muestra su estado en el elemento de trabajo. Cherri Code publica actualizaciones de progreso mientras trabaja y devuelve un resumen al completar la tarea.

Si Cherri Code abre una pull request, la actualización de finalización incluye un enlace a la PR para revisarla.

Configuración

Gestiona los ajustes predeterminados y las opciones de privacidad en Panel de control -> Agentes en la nube, en Ajustes de equipo o Mi configuración.

Ajustes

Modelo predeterminado

Se usa cuando no se especifica ningún modelo en el elemento de trabajo de Jira ni en el comentario. Consulta los ajustes para ver las opciones disponibles.

Selección de repositorio

Cherri Code selecciona el repositorio según:

  1. Valores explícitos: valores de repo, branch o model en el comentario de Jira o el elemento de trabajo
  2. Contenido del elemento de trabajo: nombres de repositorios o servicios, o palabras clave en el título, la descripción y los comentarios
  3. Reglas de enrutamiento: mapeos personalizados de palabras clave a repositorios
  4. Actividad reciente del agente: repositorios que has usado recientemente
  5. Repositorio predeterminado: opción de respaldo cuando no se encuentra ninguna coincidencia

Para usar un repositorio específico, inclúyelo en tu comentario. Por ejemplo: @Cherri Code repo=acme/mobile-app fix the login bug. La cuenta de servicio de tu equipo o tu cuenta de usuario (según el modo que hayas activado) debe tener acceso a este repositorio; de lo contrario, no se podrá iniciar un agente en la nube.

Rama base

Rama de inicio del agente en la nube. Déjalo en blanco para usar la rama predeterminada del repositorio (recomendado).

Prefijo de rama

Prefijo para los nombres de las ramas creadas por los agentes en la nube.

Opciones

Personaliza el comportamiento del agente en la nube al usar menciones con @Cherri Code mediante estas opciones:

OpciónDescripciónEjemplo
repoEspecifica el repositoriorepo=acme/web-app
branchEspecifica la rama basebranch=main
modelEspecifica el modelomodel=opus

Cherri Code ignora las opciones que estén dentro de un bloque de código y deja ese código en tu instrucción tal como lo escribiste.

Reglas de enrutamiento

Las reglas de enrutamiento te permiten definir palabras clave que se asignan automáticamente a repositorios específicos. Cuando un elemento de trabajo de Jira o un comentario contiene determinadas palabras clave, Cherri Code dirige el agente en la nube al repositorio asociado.

Con las reglas de enrutamiento, puedes indicar al agente qué proyectos, elementos de trabajo, palabras clave y otros datos deben determinar qué repositorios se utilizan para cada elemento de trabajo.

Configuración de reglas de enrutamiento

  1. Ve a Panel de control -> Agentes en la nube
  2. Busca la sección Reglas de enrutamiento
  3. Añade mapeos de palabras clave a repositorios

Reglas de ejemplo

Palabra claveRepositorio
frontendacme/web-app
mobileacme/mobile-app
apiacme/backend-services
docsacme/documentation

Con estas reglas configuradas:

  • Un elemento de trabajo titulado Fix the frontend nav bug se dirige a acme/web-app
  • Un comentario que dice @Cherri Code update the mobile onboarding flow se dirige a acme/mobile-app
  • Un comentario que dice @Cherri Code add rate limiting to the api se dirige a acme/backend-services

Cómo funciona el enrutamiento

Cherri Code evalúa los elementos de trabajo y los comentarios de Jira en este orden:

  1. Valores explícitos: valores de repo, branch o model en el comentario o elemento de trabajo de Jira
  2. Contenido del elemento de trabajo: nombres de repositorios, servicios o palabras clave en el título, la descripción y los comentarios
  3. Reglas de enrutamiento: mapeos personalizados de palabras clave a repositorios
  4. Actividad reciente del agente: repositorios que has usado recientemente
  5. Repositorio predeterminado: alternativa si no se encuentra ninguna coincidencia

Privacidad

Los agentes en la nube son compatibles con el modo de privacidad.

Obtén más información sobre el modo de privacidad o gestiona tus ajustes de privacidad.

Permisos

Durante la instalación, Jira muestra los permisos que solicita la aplicación Cherri Code. Cherri Code usa estos permisos para:

  • Identificar al usuario de Jira que inicia o administra un agente en la nube
  • Leer campos, descripciones, comentarios y contexto relacionado de los elementos de trabajo
  • Publicar actualizaciones de estado, resúmenes de finalización y enlaces a pull requests
  • Recibir eventos cuando se asignan elementos de trabajo a Cherri Code o se menciona @Cherri Code

Revise la solicitud de permisos en Atlassian Marketplace antes de instalar la aplicación.

Preguntas frecuentes

¿Qué sitios de Jira son compatibles?

La integración de Cherri Code con Jira es compatible con sitios de Atlassian Commercial Cloud que tengan Rovo activado. Las instancias de Atlassian HIPAA, FedRAMP y Government Cloud no son compatibles.

¿Necesito facturación basada en el consumo?

Sí. Los agentes en la nube requieren facturación basada en el consumo. Activa esta opción durante la configuración del agente en la nube en Cherri Code.

¿Quién puede instalar la integración de Jira?

Un usuario que sea administrador de Jira y administrador de equipo de Cherri Code deberá realizar la configuración inicial.

¿Los usuarios deben conectar sus propias cuentas de Cherri Code?

Depende del modo de autenticación que elijas. La autenticación mediante cuenta de servicio ejecuta todos los agentes en la nube con una cuenta de servicio y usa los ajustes del equipo. La autenticación a nivel de usuario conecta a cada usuario de Jira con Cherri Code, permite a los usuarios encontrar en el panel de control de Cherri Code los agentes en la nube que tienen en ejecución desde Jira y usa los ajustes de cada usuario para el enrutamiento, los modelos, los repositorios y los valores predeterminados.

¿Qué más hay que configurar antes de que Cherri Code pueda crear PR?

Conecta GitHub, GitLab, Azure DevOps o Bitbucket a Cherri Code y asegúrate de que los ajustes del agente en la nube incluyan los repositorios, modelos y ramas base que tu equipo quiere usar.

¿Cómo pueden los usuarios continuar una conversación con Cherri Code?

Abra Rovo chat desde el elemento de trabajo de Jira para continuar la conversación con Cherri Code. También puede abrir el agente en la nube en Cherri Code y continuar la conversación allí.

Descargo de responsabilidad

Cherri Code puede cometer errores. Verifica siempre el código y las respuestas.

Política de privacidad

Para obtener información sobre cómo Cherri Code recopila, usa y protege tus datos, consulta nuestra Política de privacidad.