Visão geral

O conector 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 conector do Jira Cloud é compatível com a versão 2 da API REST do Jira Cloud.

Ações compatíveis

Quando o conector 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 específico 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, 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.

Além dessas, outras ações somente leitura estão disponíveis.

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:

Modo de conexão Escopo Finalidade
Pesquisa e ações federadas read:jira-user, read:jira-work Necessário para buscar e mostrar 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).
write:comment:jira Permite que o assistente poste novos comentários ou respostas diretamente na interface de pesquisa.
write:issue:jira Necessário para criar novos problemas ou fazer edições importantes nos atuais.
Somente pesquisa federada read:jira-user, read:jira-work Obrigatório para pesquisar e visualizar problemas, projetos e perfis de usuário.
Ingestão de dados e ações 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 usuários/grupos.
read:issue-security-level:jira, read:issue-security-scheme:jira Essencial para o controle de acesso, garante que os dados ingeridos respeitem os limites de segurança do Jira.
read:audit-log:jira Usado para rastrear mudanças e realizar sincronizações incrementais para manter os dados ingeridos atualizados.
write:jira-work Necessário para realizar ações de gravação em itens de trabalho no ambiente ingerido.
write:comment:jira Necessário para adicionar comentários a problemas usando o Google Assistente.
write:issue:jira Permite criar ou modificar problemas.
Ingestão de dados read:jira-work, read:user:jira, read:group:jira, read:avatar:jira Necessário para rastrear e indexar conteúdo do Jira e relacionamentos de usuários.
read:issue-security-level:jira, read:issue-security-scheme:jira Necessário para mapear permissões e permitir que apenas usuários autorizados pesquisem os dados ingeridos.
read:audit-log:jira Necessário para 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 conector 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 conector do Jira Cloud.

Limitações

Esta seção descreve problemas e limitações conhecidos que podem afetar seu uso do conector do Jira Cloud.

  • A aplicação de um perímetro do VPC Service Controls aos repositórios de dados do Jira Cloud existentes está indisponível. 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 serviço, consulte Proteger seu app com o VPC Service Controls.

  • O repositório de dados do Jira Cloud só é compatível com locais globais, dos EUA e da UE.

  • Ao criar um novo aplicativo ou adicionar um repositório de dados a um aplicativo existente, recomendamos que você adicione um repositório de dados com ações pertencentes a um único tipo de conector. Por exemplo, não associe dois repositórios de dados do Jira Cloud com ações ativadas ao mesmo aplicativo.

Confira as limitações do conector 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 principal está indisponível.

A seguir