Visão geral

O repositório de dados do Jira Cloud para o Gemini Enterprise permite pesquisar e realizar ações nos seus projetos, problemas e informações de usuários.

Versões compatíveis do Jira Cloud

O repositório de dados do Jira Cloud é compatível com a versão 2 da API REST do Jira Cloud.

Ações permitidas

Quando o repositório de dados do Jira Cloud está ativado, os usuários finais podem usar comandos de linguagem natural no Gemini Enterprise para realizar as ações a seguir.

Ação Descrição
Criar comentário Cria um novo comentário em um problema específico do Jira para adicionar feedback, atualizações ou notas.
Atualizar comentário Edita o texto de um comentário.
Criar problema Cria um problema em um projeto na nuvem do Jira. Para criar um, você precisa fornecer um resumo, o ID do projeto e o ID do tipo de problema.
Problema de atualização Atualiza um problema no Jira Cloud. É necessário fornecer o ID do problema para identificá-lo, e você pode modificar vários campos, como o resumo, a descrição e o responsável.
Mudar o status do problema Muda o status de um problema no Jira Cloud. Você precisa fornecer o ID do problema para identificá-lo.
Fazer upload do anexo Faz upload de um anexo para um problema especificado do Jira.
Atribuir problema Atribui um problema do Jira a um usuário especificado.
Problemas com links Cria um link entre dois problemas do Jira (por exemplo, bloqueia, é bloqueado por, está relacionado a).
Criar projeto Cria um novo projeto do Jira com um nome, uma chave, um tipo de projeto e um modelo especificados.
Atualizar projeto Atualiza as configurações de um projeto do Jira, como nome, chave, descrição ou líder.
Criar registro de trabalho Adiciona uma entrada de registro de trabalho de controle de tempo a um problema do Jira.
Atualizar registro de trabalho Atualiza uma entrada de registro de trabalho em um problema do Jira.
Acessar quadro Recebe um quadro no Jira.
Receber problemas para o quadro Recebe problemas de um quadro no Jira.
Listar quadros Lista os quadros no Jira.

Escopos obrigatórios

Para permitir que o Gemini Enterprise realize pesquisas e ações usando o repositório de dados do Jira Cloud, você precisa dos seguintes escopos:

Escopos clássicos

Modo de conexão Permissão Finalidade
Pesquisa e ações federadas read:jira-user, read:jira-work Permite que o assistente busque e mostre resultados da pesquisa e detalhes do usuário em tempo real.
write:jira-work Permite que o assistente modifique itens de trabalho (por exemplo, atualizando campos de problemas), gerencie comentários ou problemas e faça upload de anexos.
manage:jira-project Permite que o assistente gerencie as configurações do projeto do Jira e crie novos objetos para envolvidos no projeto, como versões e componentes. Obrigatório para as ações de criação e atualização de projetos.
Somente pesquisa federada read:jira-user, read:jira-work Permite que o assistente pesquise e visualize problemas, projetos e perfis de usuário.
Ingestão e ações de dados read:jira-work Permite que o assistente faça uma ampla indexação e rastreamento de dados de itens de trabalho.
write:jira-work Permite que o assistente realize ações de gravação (criação, atualizações, comentários e anexos) em itens de trabalho no ambiente de ingestão.
Ingestão de dados read:jira-work Permite que o assistente rastreie e indexe o conteúdo do Jira para disponibilizá-lo na pesquisa.

Escopos granulares

Modo de conexão Permissão Finalidade
Pesquisa e ações federadas write:comment:jira Permite que o repositório de dados poste novos comentários ou respostas diretamente da interface do Gemini Enterprise.
write:issue:jira Permite que o repositório de dados crie novos problemas ou faça edições importantes nos atuais.
write:attachment:jira Permite que o repositório de dados faça upload de anexos para problemas do Jira.
write:project:jira Permite que o repositório de dados crie e atualize projetos do Jira.
write:issue-worklog:jira Permite que o repositório de dados crie e atualize registros de trabalho de problemas.
write:issue-link:jira Permite que o repositório de dados crie e atualize links entre problemas.
read:issue:jira Permite que o repositório de dados leia problemas.
read:issue-type:jira Permite que o repositório de dados leia os tipos de problemas.
read:comment:jira Permite que o repositório de dados leia comentários.
read:comment.property:jira Permite que o repositório de dados leia as propriedades dos comentários de problemas.
read:project:jira Permite que o repositório de dados leia projetos.
read:priority:jira Permite que o repositório de dados leia as prioridades.
read:issue.transition:jira Permite que o repositório de dados leia as transições de problemas.
read:issue-meta:jira Permite que o repositório de dados leia metadados de problemas.
read:board-scope.admin:jira-software Permite que o repositório de dados leia a configuração, os recursos do projeto, os filtros, as propriedades e os filtros rápidos de um quadro.
read:board-scope:jira-software Permite que o repositório de dados leia quadros, problemas em um quadro, problemas de um backlog, relatórios e versões.
read:issue-details:jira Permite que o repositório de dados leia os detalhes do problema.
read:jql:jira Permite que o repositório de dados leia consultas da linguagem de consulta do Jira (JQL).
Somente pesquisa federada read:issue:jira Permite que o repositório de dados leia problemas.
read:issue-type:jira Permite que o repositório de dados leia os tipos de problemas.
read:comment:jira Permite que o repositório de dados leia comentários.
read:comment.property:jira Permite que o repositório de dados leia as propriedades dos comentários de problemas.
read:project:jira Permite que o repositório de dados leia projetos.
read:priority:jira Permite que o repositório de dados leia as prioridades.
read:issue.transition:jira Permite que o repositório de dados leia as transições de problemas.
read:issue-meta:jira Permite que o repositório de dados leia metadados de problemas.
read:board-scope.admin:jira-software Permite que o repositório de dados leia a configuração, os recursos do projeto, os filtros, as propriedades e os filtros rápidos de um quadro.
read:board-scope:jira-software Permite que o repositório de dados leia quadros, problemas em um quadro, problemas de um backlog, relatórios e versões.
read:sprint:jira-software Permite que o repositório de dados leia detalhes do sprint.
read:issue-details:jira Permite que o repositório de dados leia os detalhes do problema.
read:jql:jira Permite que o repositório de dados leia consultas da linguagem de consulta do Jira (JQL).
Ingestão e ações de dados read:user:jira, read:group:jira, read:avatar:jira Permite sincronizar metadados de usuários/grupos e exibir perfis de usuário.
read:issue-security-level:jira, read:issue-security-scheme:jira Permite o controle de acesso, garantindo que os dados ingeridos respeitem os limites de segurança do Jira.
read:audit-log:jira Permite rastrear mudanças e realizar sincronizações incrementais para manter os dados ingeridos atualizados.
write:comment:jira Permite adicionar comentários a problemas usando o repositório de dados.
write:issue:jira Permite que o assistente crie ou modifique problemas.
Ingestão de dados read:user:jira, read:group:jira, read:avatar:jira Permite rastrear e indexar o conteúdo do Jira e as relações entre usuários.
read:issue-security-level:jira, read:issue-security-scheme:jira Permite mapear permissões para que apenas usuários autorizados possam pesquisar os dados ingeridos.
read:audit-log:jira Permite que o mecanismo de sincronização identifique quais itens foram atualizados ou excluídos.
read:sprint:jira-software Permite que o repositório de dados leia detalhes do sprint.

Para saber como configurar esses escopos, consulte Configurar o escopo mínimo do aplicativo.

Limites de taxa para ingestão de dados

O repositório de dados do Jira Cloud é compatível com um limite de taxa padrão de 12 consultas por segundo (QPS) para ingestão de dados. Esses limites de taxa se aplicam exclusivamente à ingestão de dados do repositório de dados do Jira Cloud.

Limitações

Esta seção descreve problemas e limitações conhecidos que podem afetar o uso do repositório de dados do Jira Cloud.

  • Ao criar um app ou adicionar um repositório de dados a um app, recomendamos associar apenas um repositório de dados a ações que pertencem a um único tipo de conector.
  • Não é possível aplicar um perímetro do VPC Service Controls em repositórios de dados atuais do Jira Cloud. Para aplicar o VPC Service Controls, exclua e recrie os repositórios de dados. Para mais informações sobre o VPC Service Controls e como usar ações depois de ativar o VPC Service Controls, consulte Proteger seu app com o VPC Service Controls.
  • O repositório de dados do Jira Cloud é compatível apenas com os locais global, us e eu.

Estas são as limitações do repositório de dados de ingestão do Jira Cloud:

  • Para dados não estruturados, cada tipo de mídia tem restrições diferentes. Para mais informações, consulte Preparar dados para fontes de dados personalizadas.

  • Para dados estruturados, cada documento não pode exceder 500 KB.

  • Não é possível conceder permissões de Browse project ou de nível de segurança a papéis de app com funções específicas e não vazias.

  • As permissões de documento determinadas por campos personalizados de usuário ou grupo não são aceitas.

  • O Jira Cloud não permite restrições nos níveis de registro de trabalho.

  • O Jira Cloud não indexa anexos em PDF com mais de 2.000 páginas.

  • Os anexos adicionados a comentários particulares não herdam as restrições de acesso (ACLs) dos comentários.

  • Apenas os 20 comentários anteriores de um problema no Jira Cloud são buscados.

  • Não é possível ingerir tabelas de sprint.

  • O modelo legado de gerenciamento de usuários não é compatível com a integração ao Jira Cloud. Somente o modelo de gerenciamento de usuários centralizado é compatível. Para mais informações, consulte o guia de consolidação da organização da Atlassian.

  • Ao consultar uma entidade do Jira (por exemplo, um exemplar), os dados relacionados, como comentários e anexos, não são incluídos automaticamente. Isso acontece porque eles são armazenados e indexados como entidades separadas. Não é possível pesquisar com base no conteúdo de um anexo para encontrar o problema principal.

A seguir