> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira

> Atribua tíquetes do Jira ao Devin e converta-os em PRs

<div id="setting-up-the-integration">
  ## Configurar a integração
</div>

1. Na sua conta do Devin em app.devin.ai, acesse [Configurações > Conexões > Jira](https://app.devin.ai/settings/connections/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.

<Tip>
  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](#connecting-a-service-account) abaixo.
</Tip>

<div id="how-to-trigger-devin-from-jira">
  ## Como acionar o Devin pelo Jira
</div>

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

<div id="assign-the-ticket-to-devin">
  ### Atribua o ticket ao Devin
</div>

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](https://app.devin.ai/settings/connections/jira) para começar a trabalhar no ticket.

<div id="add-a-playbook-label">
  ### Adicione um rótulo de playbook
</div>

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.

<div id="add-the-devin-label">
  ### Adicione o rótulo "devin"
</div>

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.

<Note>
  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.
</Note>

<div id="mention-devin-in-a-comment">
  ### Mencione `@Devin` em um comentário
</div>

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.

<div id="configuring-the-integration">
  ## Configurando a integração
</div>

<div id="session-mode">
  ### Modo de sessão
</div>

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.

<div id="playbook-labels">
  ### Rótulos de playbook
</div>

Os rótulos de playbook permitem controlar quais [playbooks](/pt-BR/product-guides/using-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.

<div id="automation-triggers">
  ### Gatilhos de automação
</div>

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.

<div id="enterprise-jira-project-mapping">
  ### Enterprise: mapeamento de projetos do Jira
</div>

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.

<div id="interacting-with-devin-in-jira">
  ## Interagindo com Devin no Jira
</div>

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.

<div id="connecting-a-service-account">
  ## Conectando uma conta de serviço
</div>

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. Certifique-se de que a conta de serviço tenha a função de aplicativo **User** para o Jira. Em [Atlassian Admin](https://admin.atlassian.com), vá para **Directory > Service accounts**, selecione a conta de serviço, clique em **⋯ > Allow access** e defina a função do Jira como **User**. Você também pode definir isso ao criar a conta de serviço pela primeira vez. Sem essa função, a conta de serviço não poderá acessar os recursos do Jira.
3. Em [Configurações > Conexões > Jira](https://app.devin.ai/settings/connections/jira), clique em **Conectar conta de serviço** e insira o ID do cliente e o segredo do cliente.