Vista geral

O conetor do Jira Cloud para o Gemini Enterprise oferece acesso aos seus dados do Jira Cloud, o que lhe permite interagir com os seus projetos, problemas e informações do utilizador.

Versões do Jira Cloud compatíveis

O conector do Jira Cloud suporta a versão 2 da API REST do Jira Cloud.

Ações suportadas

Quando o conector do Jira Cloud está ativado, os utilizadores 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 num problema específico do Jira para adicionar feedback, atualizações ou notas.
Atualizar comentário Edita o texto de um comentário existente.
Crie um problema Cria um novo problema num projeto do Jira Cloud. Para criar um, tem de fornecer um resumo, o ID do projeto e o ID do tipo de problema.
Problema com a atualização Atualiza um problema existente no Jira Cloud. Tem de indicar o ID do problema para o identificar e pode modificar vários campos, como o resumo, a descrição e a pessoa a quem é atribuído.

Além destas, estão disponíveis ações adicionais só de leitura.

Âmbitos obrigatórios

Para permitir que o Gemini Enterprise realize pesquisas e ações através do repositório de dados do Jira Cloud, precisa dos seguintes âmbitos:

Modo de ligação Âmbito Finalidade
Pesquisa e ações federadas read:jira-user, read:jira-work Necessário para obter e apresentar resultados da pesquisa e detalhes do utilizador em tempo real.
write:jira-work Permite que o assistente modifique itens de trabalho (por exemplo, atualizando campos de problemas).
write:comment:jira Permite que o assistente publique novos comentários ou respostas diretamente a partir da interface de pesquisa.
write:issue:jira Necessário para criar novos problemas ou fazer edições importantes aos existentes.
Apenas pesquisa federada read:jira-user, read:jira-work Necessário para pesquisar e ver problemas, projetos e perfis de utilizadores.
Carregamento e ações de dados read:jira-work, read:user:jira, read:group:jira, read:avatar:jira Necessário para a ingestão de dados em grande escala e a sincronização de metadados de utilizadores/grupos.
read:issue-security-level:jira, read:issue-security-scheme:jira Essencial para o controlo de acesso; garante que os dados carregados respeitam os limites de segurança do Jira.
read:audit-log:jira Usado para acompanhar as alterações e fazer sincronizações incrementais para manter os dados carregados atualizados.
write:jira-work Necessário para realizar ações de escrita em itens de trabalho no ambiente carregado.
write:comment:jira Necessário para adicionar comentários a problemas através do assistente.
write:issue:jira Permite criar ou modificar problemas.
Carregamento de dados read:jira-work, read:user:jira, read:group:jira, read:avatar:jira Necessário para rastrear e indexar o conteúdo do Jira e as relações entre utilizadores.
read:issue-security-level:jira, read:issue-security-scheme:jira Necessário para mapear autorizações, para que apenas os utilizadores autorizados possam pesquisar os dados carregados.
read:audit-log:jira Necessário para o motor de sincronização identificar os itens que foram atualizados ou eliminados.

Para obter informações sobre como configurar estes âmbitos, consulte o artigo Configure o âmbito mínimo da aplicação.

Limites de taxa para o carregamento de dados

O conetor do Jira Cloud suporta um limite de taxa predefinido de 12 consultas por segundo (QPS) para a ingestão de dados. Estes limites de taxa aplicam-se exclusivamente ao carregamento de dados do conetor do Jira Cloud.

Limitações

Esta secção descreve os problemas conhecidos e as limitações que podem afetar a sua utilização do conector do Jira Cloud.

  • A aplicação de um perímetro dos VPC Service Controls em repositórios de dados do Jira Cloud existentes não é suportada. Para aplicar os VPC Service Controls, tem de eliminar e recriar os arquivos de dados. Para mais informações sobre o VPC Service Controls e como usar ações após a ativação do VPC Service Controls, consulte o artigo Proteja a sua app com o VPC Service Controls.

  • O armazenamento de dados do Jira Cloud só é suportado em localizações globais, nos EUA e na UE.

  • Quando criar uma nova aplicação ou adicionar um arquivo de dados a uma aplicação existente, recomendamos que adicione um arquivo de dados com ações pertencentes a um único tipo de conector. Por exemplo, não associe dois locais de armazenamento de dados do Jira Cloud com ações ativadas à mesma aplicação.

Seguem-se as limitações do conetor de carregamento do Jira Cloud:

  • Para dados não estruturados, cada tipo de suporte tem restrições diferentes. Para mais informações, consulte o artigo Prepare dados para origens de dados personalizadas.

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

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

  • As autorizações de documentos determinadas por campos personalizados de utilizadores ou campos personalizados de grupos não são suportadas.

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

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

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

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

  • Não é possível carregar tabelas de sprints.

  • O modelo de gestão de utilizadores antigo não é suportado para integração com o Jira Cloud. Apenas é suportado o modelo de gestão de utilizadores centralizado. Para mais informações, consulte o guia de consolidação da organização da Atlassian.

  • Quando consulta uma entidade do Jira (por exemplo, um problema), os dados relacionados, como comentários e anexos, não são incluídos automaticamente. Isto deve-se ao facto de serem armazenados e indexados como entidades separadas. A pesquisa baseada no conteúdo de um anexo para encontrar o problema principal não é suportada.

O que se segue?