Integração do Devin com o Jira

Há duas formas de conectar o Jira Cloud ao Devin. Com ambas, as pessoas podem repassar itens de trabalho do Jira ao Devin e receber pull requests de volta, mas elas diferem na instalação e na forma de acionamento.

​

Qual opção devo usar?

• Os recursos de agente do Jira Cloud estão ativados no seu workspace → use o agente Rovo. O Devin aparece no seletor de responsável e nas @menções como qualquer outro agente, e informa o andamento no cartão de agente do item de trabalho. Ao vincular o site, os eventos de itens de trabalho do Jira também passam a ficar disponíveis como gatilhos para automações do Devin.
• O Rovo está desativado no seu workspace do Jira → use um usuário de serviço. O Devin atua por meio de uma conta de serviço do Jira criada por você e informa o andamento com comentários e links remotos.

As duas opções executam sessões comuns do Devin, funcionam com automações do Devin, seguem os mesmos requisitos e são faturadas da mesma forma.

​

Automações do Devin

As automações do Devin são a forma de iniciar o Devin automaticamente a partir do Jira e funcionam com as duas opções. Depois que um site do Jira é conectado — vinculado pelo app Devin for Jira ou conectado com uma conta de administrador —, os eventos dos itens de trabalho ficam disponíveis como gatilhos do Jira. Escolha um deles ao criar a automação:

• Issue created — um item de trabalho é criado.
• Issue updated — qualquer campo de um item de trabalho é alterado; os campos alterados ficam disponíveis para as condições da automação.
• Label added — um rótulo é adicionado a um item de trabalho, gerando um evento por rótulo.
• Status changed — o status de um item de trabalho muda, ou um item de trabalho é criado já com um status.
• Assigned — um item de trabalho é criado com um responsável, ou o responsável é alterado.
• Comment created — um comentário é criado em um item de trabalho. Comentários publicados pelo próprio Devin não acionam a automação.

As condições podem filtrar por projeto, rótulo, status, responsável, épico (o item pai do item de trabalho) e resumo. Quando a sessão da automação termina, a mensagem final é publicada como comentário no item de trabalho — pelo app Devin, se o site estiver vinculado pelo app, ou pela conexão de usuário de serviço, se o site estiver conectado com uma conta de administrador. Se um site tiver as duas conexões, cada evento é entregue uma única vez, pela conexão de usuário de serviço.

​

Opção 1: agente Rovo do Devin no Jira

O Devin for Jira é um app do Atlassian Forge criado sobre o conector de agentes do Rovo. Depois de instalado e vinculado, o Devin passa a atuar como um agente no seu site do Jira Cloud: atribua um item de trabalho ao Devin ou mencione @Devin em um comentário, e o Devin planeja o trabalho, escreve o código, abre um PR e informa o resultado no próprio item de trabalho.

​

Configuração

A configuração tem duas etapas: primeiro, o app é instalado no seu site do Jira; depois, um administrador do Devin vincula esse site a uma conta do Devin.

​

1. Instale o app no seu site

1. Um administrador do Jira acessa o Devin no Atlassian Marketplace e o instala no seu site do Jira Cloud (your-site.atlassian.net).
2. O administrador do Jira revisa as permissões solicitadas pelo app e confirma. O app lê e grava itens de trabalho e comentários, lê os usuários do Jira e seus endereços de e-mail (para associá-los aos usuários do Devin) e verifica as permissões dos projetos.

Após a instalação do app, o Devin aparece como um agente no site, mas só poderá aceitar trabalho depois que o site for vinculado a uma conta do Devin.

​

2. Vincule o site do Jira à sua conta do Devin

1. No Jira, acesse Settings > Apps e abra a página Devin adicionada pelo app. Ela exibe a mensagem “This site is not connected to a Devin account yet.”
2. Clique em Connect to Devin. Uma página do Devin será aberta em uma nova aba. Faça login no Devin, se solicitado.
3. Confirme se o site do Jira exibido é o seu, escolha a conta do Devin à qual deseja vinculá-lo e clique em Link site.
4. De volta ao Jira, clique em Check again. A página passará a exibir a conta do Devin à qual o site está conectado.

O site vinculado aparece no Devin em Configurações > Conexões > Jira como Devin app for Jira · installed from Jira, com o badge Linked. Para desconectar, abra o menu Actions do site nessa página, escolha Unlink site… e confirme em Unlink site: o Devin deixa imediatamente de aceitar novos trabalhos desse site do Jira, mas as sessões já em execução no Devin não são interrompidas. Para vinculá-lo novamente, um administrador do Jira deve clicar outra vez em Connect to Devin no Jira.

​

Gatilhos

Para iniciar o Devin automaticamente a partir de eventos de itens de trabalho, use as automações do Devin. Também é possível iniciar manualmente uma sessão do Devin a partir de um item de trabalho com o agente Rovo, de duas formas.

​

Atribuir o item de trabalho ao Devin

Selecione Devin no campo de responsável do item de trabalho. O Devin inicia uma sessão e trabalha no item usando o resumo e a descrição dele como tarefa.

• Atribuições repetidas feitas pela mesma pessoa em um intervalo de cinco minutos são tratadas como duplicadas enquanto a tarefa estiver ativa. Atribuir o item de trabalho novamente mais tarde, ou por outra pessoa, pode iniciar outra sessão, mesmo que a primeira ainda esteja em execução.
• Atribuir o item novamente ao Devin depois que ele tiver terminado inicia uma nova sessão.

​

Mencione o Devin com @ em um comentário

Mencione @Devin em um comentário com instruções específicas. O Devin inicia uma sessão que usa seu comentário como a tarefa e a descrição do item de trabalho como contexto. Quando o Devin termina ou para para fazer uma pergunta, ele publica sua mensagem mais recente como um comentário no item de trabalho, direcionado a você. Cada comentário que menciona o Devin inicia uma sessão própria. Para continuar uma sessão que já está em execução, responda no painel do agente.

​

O painel do agente

Enquanto o Devin trabalha, o progresso dele aparece no painel do agente do Jira, no próprio item de trabalho:

• Status ao vivo: O painel do agente mostra o progresso do Devin em tempo real.
• Link da sessão: A primeira mensagem do Devin é um link para a sessão do Devin no web app, onde você pode acompanhar o trabalho ou assumir o controle.
• Mensagens do Devin: As respostas do Devin ficam no cartão, formatadas e com links clicáveis.
• Perguntas: Se o Devin precisar de alguma informação sua, o cartão exibe a pergunta. Responda pelo chat da tarefa no painel do agente do Jira; sua resposta vai para a mesma sessão do Devin.
• Cancelar: Cancelar a tarefa pelo Jira interrompe o Devin e coloca a sessão em suspensão.

Somente o usuário do Jira que iniciou uma tarefa do Devin pode enviar mensagens a ela ou cancelá-la pelo Jira. Se o Devin não puder aceitar um item de trabalho, o cartão informa o motivo — por exemplo, o site do Jira ainda não está vinculado a uma conta do Devin, não foi possível associar sua conta da Atlassian a um usuário do Devin, ou a organização ou o seu usuário não pode consumir mais Agent Compute Units (ACUs) no momento. Corrija o problema e atribua o item de trabalho ao Devin novamente.

​

Links de PR

As respostas do Devin no painel de agente do Jira incluem links de PR, e qualquer PR que o Devin tenha aberto, mas não mencionado, aparece em Pull requests no final da resposta. Em sessões iniciadas por uma @mention, a mensagem final do Devin também é publicada como comentário no item de trabalho; ela só contém o link do PR se o Devin o tiver incluído.

​

Opção 2: Usuário de serviço no Jira

Com esta opção, o Devin se conecta ao seu site do Jira via OAuth e atua por meio de uma conta de serviço do Jira. Nada é instalado no Jira: um administrador do Jira autoriza o Devin nas configurações do Devin, e você cria uma conta de serviço na Atlassian que passa a ser a identidade do Devin no Jira — o usuário a quem você atribui os itens de trabalho e o autor dos comentários do Devin. Use esta opção quando o Rovo estiver desativado no seu workspace do Jira.

​

Configuração

​

1. Conecte com uma conta de administrador

1. No Devin, vá para Configurações > Conexões > Jira, clique em Connect account e escolha Connect with an admin account.
2. Faça login no Atlassian como administrador do Jira e conceda acesso. O Devin registra seus webhooks no site por meio dessa conta.

Até que você adicione uma conta de serviço, os comentários do Devin serão publicados em nome da conta de administrador que conectou o Jira, e não será possível atribuir itens de trabalho ao Devin.

​

2. Adicione uma conta de serviço

1. Configure uma conta de serviço da Atlassian com uma credencial OAuth 2.0 e os seguintes escopos:
   • read:me
   • read:jira-user
   • read:jira-work
   • write:jira-work
2. Conceda à conta de serviço acesso ao aplicativo Jira e permissão para navegar pelos projetos relevantes, adicionar comentários, editar e excluir os próprios comentários e vincular issues. O Devin valida as credenciais e informa as permissões ausentes quando você as salva.
3. Em Configurações > Conexões > Jira, abra o menu da conexão, escolha Add service-account credentials e insira o client ID e o client secret.

A partir de então, os comentários do Devin passam a aparecer em nome da conta de serviço, e atribuir um item de trabalho a ela inicia uma sessão. Substituir ou remover as credenciais não afeta seus webhooks. Normalmente, o Devin publica por meio da conta de serviço configurada. Se não for possível obter o token de acesso dela, o Devin pode usar como alternativa o token OAuth do administrador que conectou o Jira; nesse caso, os comentários podem aparecer em nome desse administrador.

​

3. Crie uma automação

Para iniciar o Devin automaticamente com base em eventos de itens de trabalho, crie uma automação do Devin com um gatilho do Jira — consulte Automações do Devin.

​

Gatilhos

Para iniciar o Devin automaticamente quando itens de trabalho forem criados ou alterados, use as automações do Devin. Você também pode iniciar o Devin manualmente em um item de trabalho:

• Atribua o item de trabalho à conta de serviço. O Devin inicia uma sessão no item de trabalho. Requer uma conta de serviço.
• Adicione o rótulo devin. Ao adicionar o rótulo a um item de trabalho existente, a correspondência não diferencia maiúsculas de minúsculas e considera palavras inteiras: Devin, devin-workshop e devin-task acionam o Devin, mas devinworkshop e devin_workshop não. Quando um item de trabalho é criado já com rótulos definidos, o acionamento por rótulo só ocorre se houver um rótulo exatamente igual a devin (sem diferenciar maiúsculas de minúsculas); devin-workshop não conta.
• Mencione a conta de serviço com @ em um comentário. O Devin inicia uma sessão no item de trabalho e acrescenta o texto do seu comentário à tarefa. Se o Devin já tiver uma sessão ativa para o item de trabalho, seu comentário será encaminhado para essa sessão em vez de iniciar uma nova.

Enquanto o Devin tiver uma sessão para um item de trabalho, novas atribuições e rótulos nesse item são ignorados, e as @menções são direcionadas a essa sessão. Esse vínculo dura 30 dias ou até que uma @menção detecte que a sessão foi encerrada ou apresentou erro.

​

Com qual usuário a sessão é executada

O Devin associa o usuário do Jira que acionou a sessão a um membro da conta do Devin conectada:

1. Primeiro, por meio de uma conta Atlassian vinculada. Os membros podem vincular a própria conta em Configurações > Conexões > Atlassian, permitindo que o Devin leia o Jira como essa pessoa.
2. Caso contrário, pelo endereço de e-mail: um usuário do Jira cujo e-mail corresponda a exatamente um membro da conta é associado a ele, e essa associação fica salva.

A sessão é executada como o usuário do Devin associado, aparece na lista de sessões dele e segue as permissões dele. Se nenhum membro corresponder, ou se o membro associado não tiver permissão para usar sessões do Devin na organização, a sessão será executada como o usuário bot compartilhado do Devin para o Jira. Se o Devin não conseguir escolher uma organização para o item de trabalho, ele avisará em um comentário.

​

Comentários e links de PR

Quando uma sessão é iniciada, o Devin comenta “Devin is working on your request” e adiciona um link para a sessão. Quando o Devin cria um PR, a URL do PR é adicionada como link remoto no item de trabalho e publicada como comentário, junto com o link para a sessão do Devin.

​

Requisitos

Para ambas as opções:

• Jira Cloud. O Devin for Jira é um app Forge e a conexão OAuth usa o Atlassian Cloud OAuth, portanto ambos exigem um site do Jira Cloud. Para Jira auto-hospedado, consulte como conectar um sistema de tickets personalizado pela API.
• Um administrador do Jira para instalar o app ou autorizar a conexão OAuth, e um administrador do Devin (alguém que possa gerenciar integrações da conta do Devin) para vincular o site ou configurar a conexão.
• Um site do Jira por conta do Devin. Um site do Jira só pode ser vinculado a uma conta do Devin, e uma conta do Devin só pode estar vinculada a um site do Jira por vez. Desvincule o site atual antes de vincular outro.
• Repositórios conectados, para que o Devin possa enviar branches e abrir pull requests. O Devin só consegue abrir pull requests em repositórios aos quais tem acesso; conecte primeiro seu provedor de código-fonte, por exemplo, pela integração com o GitHub.

Para o agente Rovo:

• O app Devin for Jira instalado pelo Atlassian Marketplace, com os recursos de agente do Jira Cloud ativados no workspace. Consulte a Opção 1.
• Um plano Devin Core, Team ou Enterprise, com permissão para gerenciar integrações, além de permissão e uso disponível para iniciar sessões.
• Cada pessoa que aciona o Devin precisa ter um usuário no Devin. O Devin associa o usuário do Jira a um membro da conta do Devin vinculada com base na conta Atlassian vinculada dele ou no endereço de e-mail. Se não houver correspondência por nenhum dos dois, a pessoa pode vincular sua conta em Configurações > Conexões > Atlassian. Se ainda assim não funcionar, um administrador deve verificar se a pessoa pertence à conta do Devin vinculada e se o e-mail verificado dela corresponde. Itens de trabalho de usuários do Jira sem correspondência são recusados.
• Permissão para iniciar sessões. O usuário do Devin associado precisa ter permissão para usar sessões do Devin na sua organização. Para quem pertence a mais de uma organização, o Devin usa primeiro a organização de trabalho padrão da pessoa. Defina-a em Configurações > Preferências. Se o Devin não conseguir selecionar uma organização, ele pedirá que a pessoa defina uma como padrão.

Para o usuário de serviço:

• Uma conta de serviço do Jira com os escopos e o acesso de aplicação descritos em Adicionar uma conta de serviço, para que itens de trabalho possam ser atribuídos ao Devin e os comentários do Devin sejam publicados como o bot.
• Uma conta de administrador do Jira para autorizar a conexão. Reconectá-la depois renova a autorização sem perder as credenciais da conta de serviço nem os webhooks.

​

Billing

As sessões iniciadas a partir do Jira são sessões do Devin comuns. Elas consomem ACUs da organização do Devin em que são executadas, na mesma taxa das sessões iniciadas pelo web app ou por qualquer outra integração, e contam para os limites de uso dessa organização. Se a organização não puder iniciar novas sessões por ter atingido o limite de uso, o Devin recusa o item de trabalho no Jira: no cartão, no caso do agente Rovo, ou em um comentário, no caso do usuário de serviço. A instalação do app é gratuita. O uso do Devin é faturado conforme o seu plano do Devin, e o Devin processa o conteúdo do Jira fora da Atlassian.