Visão geral

O repositório de dados do Jira Cloud para o Gemini Enterprise permite acessar seus dados do Jira Cloud e interagir com projetos, problemas e informações do usuário.

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 compatíveis

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 seguintes ações.

Ação Descrição
Criar comentário Cria um 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 do Jira Cloud. Para criar um, você precisa fornecer um resumo, o ID do projeto e o ID do tipo de problema.
Atualizar problema Atualiza um problema existente no Jira Cloud. Você precisa fornecer o ID do problema para identificá-lo e pode modificar vários campos, como resumo, descrição e responsável.
Mudar o status do problema Mudar o status de um problema atual no Jira Cloud. Você precisa fornecer o ID do problema para identificá-lo.

Escopos obrigatórios

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

Para permitir que o Gemini Enterprise faça 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, atualize campos de problemas) e gerencie comentários ou problemas.
Somente pesquisa federada read:jira-user, read:jira-work Permite que o assistente pesquise e veja problemas, projetos e perfis de usuário.
Ingestão e ações de dados read:jira-work Permite que o assistente faça rastreamento e indexação de dados abrangentes de itens de trabalho.
write:jira-work Permite que o assistente execute ações de gravação (criação, atualizações, comentários) em itens de trabalho no ambiente ingerido.
Ingestão de dados read:jira-work Permite que o Google Assistente rastreie e indexe conteúdo do Jira para disponibilizar a 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 de pesquisa.
write:issue:jira Permite que o repositório de dados crie novos problemas ou faça edições importantes nos existentes.
write:attachment:jira Permite que o repositório de dados adicione anexos a solicitações do Jira.
read:issue:jira Permite que o repositório de dados leia problemas.
read:issue-type:jira Permite que o repositório de dados leia 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 propriedades de 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 prioridades.
read:issue.transition:jira Permite que o repositório de dados leia 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 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 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 propriedades de 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 prioridades.
read:issue.transition:jira Permite que o repositório de dados leia 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 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 mostrar perfis de usuários.
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 conteúdo do Jira e relacionamentos de 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.

Para informações sobre 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 oferece 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 seu uso do repositório de dados do Jira Cloud.

  • Ao criar um app ou adicionar um repositório de dados a um já existente, recomendamos associar apenas um repositório de dados a ações pertencentes a um único tipo de conector.
  • Não é possível aplicar um perímetro do VPC Service Controls aos repositórios de dados do Jira Cloud. Para aplicar o VPC Service Controls, é necessário excluir e recriar 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 as regiões global, us e eu.

Confira 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