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,useeu.
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 projectou 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
- Para criar e configurar um repositório de dados com o Jira Cloud, consulte Configurar um repositório de dados do Jira Cloud.