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
La integración de Cherri Code Jira actualmente solo está disponible en los planes Cherri Code Teams y Enterprise.
La integración de Cherri Code Jira no es compatible actualmente con instancias de Atlassian HIPAA ni FedRAMP (incluido Government Cloud).
Instalación
-
Como administrador de Cherri Code, ve a Integraciones de Cherri Code
-
Haz clic en Conectar junto a Jira
-
Ve a la ficha de la aplicación Cherri Code en Atlassian Marketplace
-
Haz clic en Obtener ahora
-
Selecciona el sitio de Jira donde quieres instalar Cherri Code y haz clic en Revisar
-
Revisa la aplicación y luego haz clic en Obtener ahora
-
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.
-
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.
-
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)
-
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.
| Modo | Cómo funciona | Ajustes utilizados |
|---|---|---|
| Autenticación con cuenta de servicio | Los 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 usuario | Ejecuta 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:
- Inicia un agente en un elemento de trabajo de Jira
- Aparecerá una instrucción para conectar la cuenta
- Sigue el enlace para conectar la cuenta de Jira con una cuenta de Cherri Code asociada al equipo
- 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.
- Abre el elemento de trabajo de Jira
- Haz clic en el campo de asignado
- Selecciona Cherri Code
- 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:
- Valores explícitos: valores de
repo,branchomodelen el comentario de Jira o el elemento de trabajo - Contenido del elemento de trabajo: nombres de repositorios o servicios, o palabras clave en el título, la descripción y los comentarios
- Reglas de enrutamiento: mapeos personalizados de palabras clave a repositorios
- Actividad reciente del agente: repositorios que has usado recientemente
- 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ón | Descripción | Ejemplo |
|---|---|---|
repo | Especifica el repositorio | repo=acme/web-app |
branch | Especifica la rama base | branch=main |
model | Especifica el modelo | model=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
- Ve a Panel de control -> Agentes en la nube
- Busca la sección Reglas de enrutamiento
- Añade mapeos de palabras clave a repositorios
Reglas de ejemplo
| Palabra clave | Repositorio |
|---|---|
frontend | acme/web-app |
mobile | acme/mobile-app |
api | acme/backend-services |
docs | acme/documentation |
Con estas reglas configuradas:
- Un elemento de trabajo titulado
Fix the frontend nav bugse dirige aacme/web-app - Un comentario que dice
@Cherri Code update the mobile onboarding flowse dirige aacme/mobile-app - Un comentario que dice
@Cherri Code add rate limiting to the apise dirige aacme/backend-services
Cómo funciona el enrutamiento
Cherri Code evalúa los elementos de trabajo y los comentarios de Jira en este orden:
- Valores explícitos: valores de
repo,branchomodelen el comentario o elemento de trabajo de Jira - Contenido del elemento de trabajo: nombres de repositorios, servicios o palabras clave en el título, la descripción y los comentarios
- Reglas de enrutamiento: mapeos personalizados de palabras clave a repositorios
- Actividad reciente del agente: repositorios que has usado recientemente
- 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.
El modo de privacidad (heredado) no es compatible. Los agentes en la nube requieren almacenamiento temporal de código durante la ejecución.
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.