Jira

Com a integração do Cherri Code com o Jira, você pode usar agentes na nuvem para trabalhar em itens de trabalho do Jira, atribuindo-os ao Cherri Code ou mencionando @Cherri Code no Jira.

Introdução

Requisitos

Antes de instalar a integração do Jira, verifique se você tem:

• Jira Commercial Cloud com o Rovo habilitado
• Acesso de administrador ao site do Jira onde deseja instalar o app
• Acesso de administrador do Cherri Code à equipe que deseja conectar
• GitHub, GitLab, Azure DevOps ou Bitbucket conectado ao Cherri Code para acesso ao repositório e pull requests

Instalação

1. Como administrador do Cherri Code, acesse Integrações do Cherri Code

2. Clique em Conectar ao lado do Jira

3. Acesse a página do app Cherri Code no Atlassian Marketplace

4. Clique em Obter agora

5. Selecione o site do Jira em que deseja instalar o Cherri Code e clique em Revisar

6. Revise o app e clique em Obter agora

7. Após a conclusão da instalação, você será direcionado à página de configuração do app Cherri Code para Jira. Aguarde alguns minutos para que a Atlassian nos notifique sobre a instalação e clique no botão Conectar ao Cherri Code.

8. Conecte o site do Jira à sua equipe do Cherri Code

   • Se quiser habilitar a autenticação no nível do usuário (que oferece aos membros da equipe mais visibilidade e controle sobre seus agentes) em vez de executar agentes com uma conta de serviço, ative a opção Exigir autenticação individual.

9. Conclua as configurações restantes do agente em nuvem no Cherri Code:

   • Conecte o GitHub, GitLab, Azure DevOps ou Bitbucket
   • Habilite a precificação baseada em uso
   • Confirme as configurações de privacidade
   • Escolha um repositório, modelo e branch base padrão (nas configurações de agente na nuvem no dashboard do Cherri Code)

10. Volte ao Jira e comece a usar o Cherri Code em um item de trabalho

    • Se você habilitou a autenticação no nível do usuário, cada usuário precisará concluir configurações adicionais abaixo

Modo de autenticação

Você pode escolher como o Jira autentica os agentes em nuvem no painel de administração da integração do Cherri Code com o Jira ativando a opção Exigir autenticação individual.

Para conectar cada usuário:

1. Inicie um agente em um item de trabalho do Jira
2. Será exibido um aviso para conectar a conta
3. Siga o link para conectar a conta do Jira a uma conta do Cherri Code associada à equipe
4. Conclua as configurações restantes do agente em nuvem no Cherri Code:
   • Conecte o GitHub, GitLab, Azure DevOps ou Bitbucket caso ainda não tenha conectado um provedor de repositório
   • Escolha um repositório padrão, um modelo e uma branch base (nas configurações de agente na nuvem em Minhas configurações no dashboard do Cherri Code)

Como usar

Abra um item de trabalho no Jira e atribua-o ao Cherri Code ou mencione @Cherri Code em um comentário. O Cherri Code usa o título, a descrição, os comentários e as configurações disponíveis do repositório para iniciar um agente em nuvem.

Você pode pedir ao Cherri Code para corrigir bugs, adicionar funcionalidades, atualizar testes ou investigar uma tarefa descrita no item de trabalho.

Delegar itens de trabalho

Atribua um item de trabalho do Jira ao Cherri Code quando o ticket já descrever claramente a tarefa.

1. Abra o item de trabalho do Jira
2. Clique no campo de responsável
3. Selecione Cherri Code
4. Revise o agente em nuvem iniciado a partir do item de trabalho

Mencione o Cherri Code

Mencione @Cherri Code em um comentário no Jira quando quiser adicionar instruções específicas. Você pode incluir um repositório, uma branch ou um modelo no mesmo comentário.

Exemplos:

• @Cherri Code investigue esta regressão
• @Cherri Code repo=acme/backend branch=release corrija isso antes do corte da release
• @Cherri Code model=gpt-5.6-sol e atualize os testes relacionados

Instruções de acompanhamento

Abra o chat do Rovo a partir do item de trabalho do Jira para continuar a conversa com o Cherri Code.

Atualizações de status e repasse

Quando um agente em nuvem é iniciado, o Jira mostra o status do agente no item de trabalho. O Cherri Code publica atualizações de progresso enquanto trabalha e retorna um resumo quando a tarefa é concluída.

Se o Cherri Code abrir um pull request, a atualização de conclusão inclui um link para o PR para revisão.

Configuração

Gerencie as configurações padrão e as opções de privacidade no Dashboard -> agentes na nuvem, em Configurações da equipe ou Minhas configurações.

Configurações

Modelo padrão

Usado quando nenhum modelo é especificado no item de trabalho ou comentário do Jira. Consulte as configurações para ver as opções disponíveis.

Seleção de repositório

O Cherri Code seleciona o repositório com base em:

1. Valores explícitos: valores de repo, branch ou model no comentário ou item de trabalho do Jira
2. Conteúdo do item de trabalho: nomes de repositórios, serviços ou palavras-chave no título, na descrição e nos comentários
3. Regras de roteamento: mapeamentos personalizados de palavras-chave para repositórios
4. Atividade recente do agente: repositórios que você usou recentemente
5. Repositório padrão: usado como alternativa quando nenhuma correspondência é encontrada

Para usar um repositório específico, inclua-o no comentário. Por exemplo: @Cherri Code repo=acme/mobile-app fix the login bug. A conta de serviço da sua equipe ou sua conta de usuário, dependendo do modo ativado, deve ter acesso a este repositório. Caso contrário, não será possível iniciar um Cloud Agent.

Branch de base

Branch inicial do agente em nuvem. Deixe em branco para usar a branch padrão do repositório (recomendado).

Prefixo da branch

Prefixo para nomes de branches criadas por agentes na nuvem.

Opções

Personalize o comportamento do agente em nuvem ao usar menções com @Cherri Code usando estas opções:

O Cherri Code ignora opções dentro de um bloco de código e mantém o código no seu prompt exatamente como foi escrito.

Regras de roteamento

As regras de roteamento permitem definir palavras-chave que mapeiam automaticamente para repositórios específicos. Quando um item de trabalho ou comentário do Jira contém determinadas palavras-chave, o Cherri Code roteia o agente em nuvem para o repositório associado.

Com as regras de roteamento, você informa ao agente quais projetos, itens de trabalho, palavras-chave e outros dados determinam quais repositórios serão usados para cada item de trabalho.

Configurar regras de roteamento

1. Acesse Dashboard -> agentes na nuvem
2. Localize a seção Regras de roteamento
3. Adicione mapeamentos de palavras-chave para repositórios

Exemplos de regras

Com essas regras configuradas:

• Um item de trabalho com o título Fix the frontend nav bug é roteado para acme/web-app
• Um comentário com o texto @Cherri Code update the mobile onboarding flow é roteado para acme/mobile-app
• Um comentário com o texto @Cherri Code add rate limiting to the api é roteado para acme/backend-services

Como funciona o roteamento

O Cherri Code avalia os itens de trabalho e os comentários do Jira nesta ordem:

1. Valores explícitos: valores de repo, branch ou model no comentário ou no item de trabalho do Jira
2. Conteúdo do item de trabalho: nomes de repositórios, nomes de serviços ou palavras-chave no título, na descrição e nos comentários
3. Regras de roteamento: mapeamentos personalizados de palavras-chave para repositórios
4. Atividade recente do agente: repositórios usados recentemente
5. Repositório padrão: usado quando nenhuma correspondência é encontrada

Privacidade

Os agentes na nuvem oferecem suporte ao Privacy Mode.

Saiba mais sobre o Privacy Mode ou gerencie suas configurações de privacidade.

Permissões

Durante a instalação, o Jira mostra as permissões solicitadas pelo app Cherri Code. O Cherri Code usa essas permissões para:

• Identificar o usuário do Jira que inicia ou gerencia um agente em nuvem
• Ler campos, descrições, comentários e contexto relacionado de itens de trabalho
• Publicar atualizações de status, resumos de conclusão e links de pull requests
• Receber eventos quando itens de trabalho são atribuídos ao Cherri Code ou mencionam @Cherri Code

Revise a solicitação de permissões no Atlassian Marketplace antes de instalar o app.

Perguntas frequentes

Quais sites do Jira são compatíveis?

A integração do Cherri Code com o Jira oferece suporte a sites da nuvem comercial da Atlassian com o Rovo habilitado. As instâncias HIPAA, FedRAMP e Government Cloud da Atlassian não são compatíveis.

Preciso ativar o faturamento por uso?

Sim. Os agentes na nuvem exigem faturamento por uso. Ative o faturamento por uso ao concluir a configuração do agente em nuvem no Cherri Code.

Quem pode instalar a integração com o Jira?

Um usuário que seja administrador do Jira e da equipe do Cherri Code precisará realizar a configuração inicial.

Os usuários precisam conectar suas próprias contas do Cherri Code?

Depende do modo de autenticação escolhido. A autenticação com conta de serviço executa todos os agentes na nuvem usando uma conta de serviço e as configurações da equipe. A autenticação no nível do usuário conecta cada usuário do Jira ao Cherri Code, permite que localizem no dashboard do Cherri Code os agentes na nuvem em execução no Jira e usa as configurações de cada usuário para roteamento, modelos, repositórios e valores padrão.

O que mais precisa ser configurado antes que o Cherri Code possa criar PRs?

Conecte o GitHub, GitLab, Azure DevOps ou Bitbucket ao Cherri Code e verifique se as configurações do agente em nuvem incluem os repositórios, modelos e branches de base que sua equipe deseja usar.

Como os usuários continuam uma conversa com o Cherri Code?

Abra o chat do Rovo a partir do item de trabalho do Jira para continuar a conversa com o Cherri Code. Como alternativa, abra o agente na nuvem no Cherri Code e continue a conversa por lá.

Aviso

O Cherri Code pode cometer erros. Revise o código e as respostas.

Política de Privacidade

Para saber como o Cherri Code coleta, usa e protege seus dados, consulte nossa Política de Privacidade.