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

Ação Descrição
Criar comentário Cria um novo comentário em um problema especificado do Jira para adicionar feedback, atualizações ou observações.
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, forneça um resumo, o ID do projeto e o ID do tipo de problema.
Problema de atualização Atualiza um problema no Jira Cloud. Forneça o ID do problema para identificá-lo e modifique vários campos, como resumo, descrição e responsável.
Mudar o status do problema Muda o status de um problema no Jira Cloud. Forneça o ID do problema para identificá-lo.
Fazer upload de anexo Faz upload de um anexo para um problema especificado do 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.
Somente pesquisa federada read:jira-user, read:jira-work Permite que o assistente pesquise e visualize problemas, projetos e perfis de usuários.
Ingestão de dados e ações read:jira-work Permite que o assistente realize rastreamento e indexação 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 ingerido.
Ingestão de dados read:jira-work Permite que o assistente rastreie e indexe o conteúdo do Jira para disponibilidade de 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 faça upload de anexos para problemas 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 de problemas.
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: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 detalhes de problemas.
read:jql:jira Permite que o repositório de dados leia consultas da linguagem de consulta do Jira (JQL).
Ingestão de dados e ações 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 o conteúdo do Jira e as relações do usuário.
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 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 o uso do repositório de dados do Jira Cloud.

  • Ao criar um novo app ou adicionar um repositório de dados a um app atual, 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, 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.

Confira a seguir 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. A pesquisa com base no conteúdo de um anexo para encontrar o problema pai é indisponível.

A seguir