AI Duplicate Detector & Issue Assistant - Documentação
Atualizado: 2026-06-30
Visão geral
O AI Duplicate Detector & Issue Assistant faz duas coisas pela sua equipe do Jira. Primeiro, encontra e ajuda você a resolver issues duplicadas — na issue que você está visualizando, em todo o seu backlog e automaticamente quando novas issues são criadas. Segundo, atua como um assistente de IA em cada issue, transformando o conteúdo da issue em resumos, critérios de aceitação, subtarefas, estimativas, casos de teste, traduções e muito mais — com a opção de aplicar o resultado diretamente à issue.
Tudo é executado dentro da plataforma da Atlassian, no Forge. A IA é fornecida pelo Anthropic Claude por meio da API LLM nativa do Forge da Atlassian — nenhum conteúdo de issue é enviado a um serviço externo à Atlassian, e seus dados nunca são usados para treinar nenhum modelo.
Funcionalidades em resumo
| Funcionalidade | Onde | O que faz |
|---|---|---|
| Detecção de duplicadas | Painel da issue | Lista as issues abertas que descrevem o mesmo problema, cada uma com uma pontuação de correspondência e um motivo. |
| Combinar duplicada | Painel da issue | Marca uma candidata como duplicada: vincula as duas issues, adiciona uma nota, move os observadores (watchers) e fecha a duplicada. Requer confirmação. |
| Varredura do backlog | Página do projeto | Analisa em uma única passagem as issues abertas do projeto e agrupa as prováveis duplicadas. |
| Detecção automática | Automática | Quando uma nova issue é criada, o aplicativo verifica a existência de duplicadas e, se encontrar alguma, publica um comentário na nova issue. |
| Ações de IA | Painel da issue | Assistentes de IA sob demanda (veja abaixo). Alguns podem gravar o resultado de volta na issue. |
Primeiros passos
- Instale o aplicativo a partir do Atlassian Marketplace no seu site do Jira Cloud.
- Abra qualquer issue do Jira. O aplicativo adiciona um painel AI Duplicate Detector que lista automaticamente possíveis duplicadas e exibe o menu de ações de IA.
- Abra a página AI Duplicate Scan de um projeto (na barra lateral do projeto) para varrer todo o backlog em busca de grupos de duplicadas.
Na primeira vez que você usar o aplicativo, o Jira pode pedir que você conceda permissão. Todas as leituras e gravações ocorrem em seu nome, portanto o aplicativo só consegue ver e alterar issues às quais você já tem permissão de trabalho.
Detecção e combinação de duplicadas
O aplicativo encontra duplicadas em três etapas, inteiramente dentro da plataforma da Atlassian:
- Busca de candidatas. Usando o resumo e as palavras-chave da issue, o aplicativo executa uma busca no Jira (JQL) para reunir um pequeno conjunto de issues abertas que possam estar relacionadas.
- Avaliação por IA. Cada candidata é comparada com a issue atual pelo modelo de IA, que pontua a probabilidade de ser uma duplicada e redige um motivo breve.
- Classificação. Somente correspondências de alta confiança são mantidas e exibidas, ordenadas por pontuação. Se nada corresponder, o painel informa que nenhuma duplicada foi encontrada.
Combinando uma duplicada
Ao lado de cada candidata há uma ação Marcar como duplicada e combinar. Como o Jira não possui uma única operação de "combinar", o aplicativo executa as etapas que uma pessoa faria: vincula a candidata à issue atual como Duplicate, adiciona uma nota, move os observadores da candidata para a issue atual e transiciona a candidata para um status fechado/concluído (com a resolução Duplicate, quando disponível).
Varredura do backlog e detecção automática
- Varredura do backlog (página do projeto): Abra AI Duplicate Scan a partir do projeto e clique em Scan for duplicates. O aplicativo lê as issues abertas do projeto e, em uma única passagem de IA, agrupa as que parecem duplicadas entre si. Abra o painel de qualquer issue para combinar.
- Detecção automática (novas issues): Quando uma issue é criada, o aplicativo verifica em segundo plano a existência de duplicadas. Se encontrar alguma, publica um comentário na nova issue listando-as — assim as duplicadas são detectadas no momento da criação. A IA só é chamada quando a busca inicial do Jira realmente encontra candidatas, o que mantém o processamento no mínimo.
Ações de IA
Em qualquer issue, abra o menu Ações de IA do painel para executar uma das opções abaixo. Os resultados aparecem no painel; quando indicado, você pode aplicá-los à issue.
| Ação | O que produz | Pode ser aplicada à issue? |
|---|---|---|
| Summarize | Um resumo curto e os pontos principais, incluindo comentários recentes. | Adicionar como comentário |
| Acceptance Criteria | Uma checklist de critérios de aceitação. | Adicionar como comentário |
| Rewrite Issue | Uma versão mais clara e mais bem estruturada da descrição. | Substituir a descrição (com confirmação) |
| Suggest Sub-tasks | Uma divisão em títulos de subtarefas. | Criar subtarefas |
| Estimate Story Points | Uma estimativa de pontos com confiança e justificativa. | Definir story points |
| Generate Test Cases | Uma tabela de casos de teste (título, passos, resultado esperado). | Adicionar como comentário |
| Translate | A issue traduzida para o idioma que você escolher. | Adicionar como comentário |
| Triage | Prioridade, categoria e equipe sugeridas, com motivo. | Adicionar como comentário |
| Split Epic | Stories filhas sugeridas para um epic. | Adicionar como comentário |
| Analyze Bug | Gravidade, passos de reprodução e possíveis causas. | Adicionar como comentário |
As ações que gravam no Jira só o fazem quando você clica explicitamente no botão de aplicar. Rewrite Issue substitui a descrição existente, por isso pede confirmação antes. Adicionar como comentário está sempre disponível e nunca altera o conteúdo existente.
Modelo de IA
O aplicativo usa o Anthropic Claude, acessado exclusivamente por meio da API LLM nativa do Forge da Atlassian. Nenhum conteúdo de issue é enviado a um serviço de IA externo à plataforma Atlassian, e seus dados nunca são usados para treinar nenhum modelo. A IA é usada somente no momento da solicitação, para produzir o resultado que você pediu.
Permissões e tratamento de dados
Scopes solicitados:
read:jira-work— lê a issue atual e busca candidatas e issues do backlog.write:jira-work— apenas para ações que você aciona: adicionar comentários, criar subtarefas, atualizar a descrição, definir story points, vincular issues e transicionar uma duplicada para fechada.write:issue.watcher:jira— move os observadores de uma duplicada para a issue canônica durante uma combinação.storage:app— armazena em cache os resultados de duplicadas para que a mesma issue não seja reanalisada desnecessariamente.
- Todas as leituras e gravações no Jira são realizadas em nome do usuário atual, portanto o aplicativo só pode acessar ou alterar issues às quais esse usuário já tem permissão de trabalho.
- O aplicativo é executado inteiramente no Atlassian Forge (sem servidor). Ele não opera servidores nem bancos de dados externos; a criptografia, a hospedagem e a autenticação são fornecidas pela plataforma Forge.
- O aplicativo não coleta credenciais nem tokens de API, e não armazena dados pessoais além do cache temporário de resultados de duplicadas.
Privacidade, termos e suporte
- Política de Privacidade: pokutsoft.com/legal/atlassian/ai-duplicate-detector/privacy/
- Termos de Uso: pokutsoft.com/legal/atlassian/ai-duplicate-detector/terms/
- Suporte: pokutsoft.com/legal/atlassian/ai-duplicate-detector/support/