Pular para o conteúdo principal

​
Configurar a integração

  1. Na sua conta do Devin em app.devin.ai, acesse Configurações > Integrações > Jira e clique em “Conectar”.
  2. Você será redirecionado para o Jira para revisar as permissões e conceder acesso ao Devin.
  3. Depois de conectar, configure seus rótulos de playbook e, opcionalmente, defina gatilhos de automação na página de configurações.
Depois de conectar, recomendamos conectar uma conta de serviço para que os comentários do Devin apareçam como enviados pelo bot, e não pela sua conta pessoal. Veja Conectando uma conta de serviço abaixo.

​
Como acionar o Devin pelo Jira

Há quatro maneiras de iniciar uma sessão do Devin a partir de um ticket do Jira:

​
Atribua o ticket ao Devin

Atribua o ticket diretamente à conta de serviço do Devin no Jira. O Devin usará o playbook padrão configurado nas configurações da integração com o Jira para começar a trabalhar no ticket.

​
Adicione um rótulo de playbook

Adicione um rótulo de playbook (por exemplo, !plan, !implement, !triage) ao ticket. Devin iniciará uma sessão usando o playbook específico correspondente ao rótulo. Esses rótulos correspondem aos rótulos de playbook configurados nas configurações da sua integração. Você precisa criar esses rótulos manualmente no seu projeto do Jira — copie o nome do rótulo nas configurações da integração.

​
Adicione o rótulo “devin”

Adicione o rótulo devin a qualquer problema do Jira (talvez você precise criar esse rótulo primeiro no seu projeto do Jira). O Devin usará o playbook padrão para começar a trabalhar no ticket.
A integração usa correspondência por limite de palavra (sem diferenciar maiúsculas de minúsculas), então qualquer rótulo que contenha devin como uma palavra independente vai acioná-la — por exemplo, devin, Devin, devin-workshop ou devin-task. Rótulos em que “devin” faz parte de uma palavra maior, como devinworkshop ou devin_workshop, não vão acioná-la.

​
Mencione @Devin em um comentário

Mencione @Devin em um comentário do ticket com instruções específicas. Devin iniciará uma sessão e usará seu comentário como instrução da tarefa, sem aplicar um playbook. Se já houver uma sessão para o ticket, sua mensagem será encaminhada para essa sessão existente.

​
Configurando a integração

​
Modo de sessão

O controle de modo de sessão define como Devin responde aos gatilhos do Jira:
  • Criação direta de sessão (ativada por padrão): Devin cria uma sessão completa e trabalha no problema, publicando atualizações no Jira.
  • Somente escopo (desativado): Devin apenas analisa o ticket e publica um comentário de escopo com um resumo, plano de implementação e estimativa de confiança. Em seguida, você pode clicar no link fornecido para iniciar uma sessão manualmente.

​
Rótulos de playbook

Os rótulos de playbook permitem controlar quais playbooks do Devin ficam disponíveis como rótulos no Jira. Quando você adiciona um playbook, a macro dele (por exemplo, !plan) se torna um rótulo que você pode atribuir a problemas do Jira para acionar o Devin com esse playbook. Os rótulos devem ser criados manualmente no seu projeto do Jira — copie o nome do rótulo nas configurações da integração.
  • Playbook padrão: Um playbook é marcado como padrão. Quando um ticket é acionado sem um rótulo de playbook específico (por exemplo, apenas com o rótulo devin ou ao atribuir o ticket ao Devin), o Devin usa esse playbook padrão.
  • Adicionando playbooks: Clique em “Add playbook” para adicionar outros playbooks. Somente playbooks com macro podem ser adicionados.
  • Removendo playbooks: Remova um playbook para que o rótulo dele deixe de ser usado como gatilho.

​
Gatilhos de automação

Os gatilhos de automação permitem que o Devin comece a trabalhar automaticamente em tickets quando eles atendem a determinadas condições, sem atribuição manual nem aplicação de rótulos. Você pode configurar gatilhos com base em:
  • Projetos: Acionar apenas para tickets em projetos específicos do Jira.
  • Rótulos: Acionar apenas quando um ticket tiver rótulos específicos.
  • Status: Acionar apenas quando um ticket atingir um status específico (e.g. “To Do”, “In Progress”).
  • Playbook: Opcionalmente, especifique qual playbook o Devin deve usar na sessão acionada.
Os gatilhos usam detecção de borda, o que significa que eles só são acionados quando um ticket passa de não atender para atender às condições do gatilho (e.g. quando um rótulo é adicionado ou um status muda), e não para tickets que já atendem a essas condições.

​
Enterprise: mapeamento de projetos do Jira

Em implantações Enterprise com várias organizações do Devin, os administradores podem mapear projetos do Jira para organizações específicas do Devin. Isso garante que os tickets de cada projeto do Jira sejam encaminhados para a organização correta do Devin. Esse mapeamento é necessário para que a integração com o Jira funcione em ambientes Enterprise.

​
Interagindo com Devin no Jira

Assim que Devin começa a trabalhar em um ticket, ele se comunica pelo Jira:
  • Links de PR: Quando Devin cria uma pull request, a URL da PR é adicionada automaticamente como um link remoto no problema do Jira e publicada em um comentário.
  • Link da sessão: Um link direto para a sessão do Devin no app web é fornecido para que você possa acompanhar o progresso em tempo real.
  • Mensagens de acompanhamento: Mencione @Devin em um comentário para dar instruções adicionais ao Devin ou fazer perguntas.

​
Conectando uma conta de serviço

Depois de conectar o Jira com sua conta de administrador, você também pode, opcionalmente, conectar uma conta de serviço usando credenciais de cliente OAuth 2.0. Isso faz com que os comentários do Devin apareçam com uma identidade dedicada de bot, em vez da sua conta pessoal.
  1. Nas configurações de administrador da sua organização Atlassian, crie uma conta de serviço OAuth 2.0 com os seguintes escopos Classic:
    • read:me
    • read:jira-user
    • read:jira-work
    • write:jira-work
  2. Em Configurações > Integrações > Jira, clique em Conectar conta de serviço e insira o ID do cliente e o segredo do cliente.