Configure um repositório de dados do Jira Cloud

Pré-visualização pública: as funcionalidades de pesquisa e ações federadas estão em pré-visualização pública. Esta funcionalidade está sujeita aos "Termos de ofertas de pré-disponibilidade geral" na secção de Termos de Utilização Gerais dos Termos Específicos do Serviço. As funcionalidades pré-GA estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Esta página descreve como criar um repositório de dados e associar o Jira Cloud ao Gemini Enterprise.

Antes de começar

Certifique-se do seguinte antes de configurar a ligação federada do Jira Cloud:

• Conceda a função Editor do Discovery Engine (roles/discoveryengine.editor). Esta função é necessária para o utilizador criar o arquivo de dados. Para conceder esta função, faça o seguinte:

  1. Na Google Cloud consola, aceda à página IAM.

     Aceda ao IAM

  2. Localize a conta de utilizador e clique no ícone editar Editar.
  3. Conceda a função de Discovery Engine Editor ao utilizador. Para mais informações, consulte o artigo Funções e autorizações de IAM.

• Para aplicar o controlo de acesso à origem de dados e proteger os dados no Google Gemini Enterprise, configure o seu fornecedor de identidade.

• Para configurar o conector do Jira Cloud, tem de usar o novo modelo de gestão de utilizadores centralizado da Atlassian. Se estiver a usar o modelo original, tem de migrar a gestão de utilizadores antes de continuar. Para mais informações, consulte o artigo Função de administrador do site.

• Crie uma app OAuth 2.0, obtenha o ID de cliente e o segredo e configure as autorizações mínimas da aplicação com o consentimento de um administrador do Jira Cloud. Valide que tem acesso de administrador da organização do Jira à instância e ao projeto do Jira. Com o acesso de administrador da organização, pode configurar autorizações mínimas e conceder privilégios de acesso a grupos de utilizadores.

• Opcional: para obter endereços de email de utilizadores do Jira Cloud, mesmo quando as definições restringem a visibilidade do email, instale a app User Identity Accessor for Jira Cloud com privilégios de administrador do site do Jira para a instalar e configurar de modo a obter endereços de email de utilizadores em segurança. Pode não precisar de instalar esta app se os endereços de email já forem acessíveis publicamente.

  Nota: a Atlassian está a atualizar os elementos da interface do utilizador e alguns elementos mencionados nesta documentação estão a ser renomeados (por exemplo, Produtos está a ser renomeado para Apps). Para mais informações, consulte o artigo Alteração da terminologia de administração da Atlassian de "produtos" para "apps".

Crie um armazenamento de dados do Jira Cloud

Para criar um repositório de dados do Jira Cloud, siga estes passos:

1. Na Google Cloud consola, aceda à página do Gemini Enterprise.

   Gemini Enterprise

2. Selecione ou crie um Google Cloud projeto.

   Nota: para aceder ao fluxo unificado, o seu projeto tem de estar na lista de autorizações.

3. No menu de navegação, clique em Armazenamentos de dados.

4. Clique em Criar arquivo de dados.

5. Na secção Origem, pesquise Jira Cloud e clique em Selecionar.

6. Na secção Dados:

   1. Na secção Modo de conector, selecione Carregamento de dados ou Pesquisa federada como modo de ligação.

   2. Clique em Continuar.

   3. Na secção Definições de autenticação, configure a autenticação com base no modo de ligação escolhido.

      1. Indique os seguintes detalhes de autenticação:

         • ID de cliente
         • Segredo do cliente
         • URI da instância
         • ID da instância

         Para mais informações sobre credenciais, consulte o artigo Configuração do Jira Cloud.

      2. Se selecionou Pesquisa federada, clique em Iniciar sessão e conclua o início de sessão na Atlassian.

      3. Clique em Continuar.

   4. Na secção Destinos, introduza o URL do seu ponto final do Jira Cloud.

   5. Clique em Continuar.

   6. Na secção Entidades a pesquisar (se selecionou Pesquisa federada) ou Entidades a sincronizar (se selecionou Carregamento de dados):

      1. Selecione todas as entidades necessárias.
      2. Se selecionou Pesquisa federada, avance para o passo seguinte.
      3. Se selecionou Carregamento de dados, continue com os seguintes passos:
         1. Opcional: para sincronizar projetos específicos, faça o seguinte:
            1. Clique em Filtrar.
            2. Para filtrar entidades do índice, selecione a caixa de verificação Excluir do índice ou, para garantir que são incluídas no índice, selecione a caixa de verificação Incluir no índice.
            3. Introduza as chaves. Prima Enter após cada tecla.
            4. Clique em Guardar.
         2. Para configurar a programação de sincronização, faça o seguinte:
            1. Na lista Frequência de sincronização, selecione a frequência de sincronização.
               • Para agendar sincronizações completas separadas de dados de entidades e identidades, expanda o menu na secção Sincronização completa e, de seguida, selecione Opções personalizadas.
            2. Na lista Frequência de sincronização incremental, selecione a frequência de sincronização incremental. Para mais informações, consulte o artigo Sincronize agendas.

7. Clique em Continuar.

8. Na secção Ações:

   1. Se selecionou Pesquisa federada:
      1. Em Selecionar ações do Jira Cloud a ativar, selecione as ações da categoria para as ativar para o conector.

   2. Se selecionou Carregamento de dados:

      1. Na secção Definições de autenticação, configure a autenticação com base no modo de ligação escolhido.

      2. Indique os seguintes detalhes de autenticação:

         • ID de cliente
         • Segredo do cliente
         • URI da instância
         • ID da instância

         Para mais informações sobre credenciais, consulte o artigo Configuração do Jira Cloud.

      3. Clique em Iniciar sessão e inicie sessão no Jira Cloud para validar a sua conta.

      4. Clique em Continuar.

      5. Em Selecionar ações do Jira Cloud a ativar, selecione as ações da categoria para as ativar para o conector.

      Nota: se ignorar a adição de ações neste passo, tem de criar um novo arquivo de dados para adicionar ações. Para ver a lista de ações, consulte Ver ações.

9. Na secção Configuração:

   1. Na lista Várias regiões, selecione a localização do conetor de dados.
   2. No campo Nome do conetor de dados, introduza um nome para o conetor.
   3. Se selecionou US ou EU como a localização, configure as Definições de encriptação:
      • Opcional: se não tiver configurado chaves de região única, clique em Aceder à página de definições para o fazer. Para mais informações, consulte o artigo Registe uma chave de região única para conetores de terceiros.
      • Selecione chave de encriptação gerida pelaGoogle ou chave do Cloud KMS.
      • Se selecionou Chave do Cloud KMS:
        • Na lista Tipo de gestão de chaves, selecione o tipo adequado.
        • Na lista Chave do Cloud KMS, selecione a chave.
      Para mais informações, consulte o artigo Chaves de encriptação geridas pelo cliente.

10. Clique em Continuar.

11. Na secção Faturação, selecione Preços gerais ou Preços configuráveis. Para mais informações, consulte os artigos Valide o estado de faturação dos seus projetos e Licenças.

12. Clique em Criar. O Gemini Enterprise cria o seu arquivo de dados e apresenta os seus arquivos de dados na página Arquivos de dados.

Na página Armazenamentos de dados, clique no nome do armazenamento de dados para ver o estado. Depois de o estado do repositório de dados mudar de A criar para Ativo, o conetor do Jira Cloud está pronto a ser usado.

Para um conetor de carregamento criado com o Jira Cloud, o estado do repositório de dados passa de A criar para Em execução após o início da sincronização. Em seguida, muda para Ativa assim que o carregamento estiver concluído, o que significa que o armazenamento de dados está totalmente configurado. Consoante o volume de dados, o carregamento pode demorar várias horas.

Depois de criar o arquivo de dados, crie uma app, associe-a ao arquivo de dados do Jira Cloud e autorize o Gemini Enterprise a aceder ao Jira Cloud antes de executar quaisquer consultas.

Ative a sincronização em tempo real para a ingestão de dados

Pré-visualização — Real-time sync

Esta funcionalidade está sujeita aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. As funcionalidades de pré-DG estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

A sincronização em tempo real só sincroniza entidades de documentos e não sincroniza dados relacionados com entidades de identidade. A tabela seguinte mostra os eventos de documentos que são suportados com a sincronização em tempo real.

Entidades do Jira	Criar	Atualizar	Eliminar	Alterações de permissões
Problemas
Registos de trabalho
Projetos
Comentários
Anexos

Para ativar a sincronização em tempo real para um conetor de origem de dados do Jira Cloud, siga estes passos:

Gere um URL do webhook

1. Navegue para a página do Gemini Enterprise e, no menu de navegação, clique em Armazenamentos de dados.
2. Selecione um repositório de dados do Jira Cloud.

3. Clique em Ver/editar na linha Sincronização em tempo real.

4. Na caixa de diálogo Ver e editar parâmetros de sincronização em tempo real, faça o seguinte:

   1. Para ativar a sincronização em tempo real, clique no interruptor Ativar sincronização em tempo real.
   2. Introduza um valor no campo Segredo do cliente e copie-o. Precisa deste valor novamente quando criar um webhook na consola de administração do Jira.
   3. Clique em Guardar.

5. Depois de o estado da Sincronização em tempo real mudar para Running, clique em Ver/Editar.

6. Na caixa de diálogo Ver e editar parâmetros de sincronização em tempo real, faça o seguinte:

   1. Copie o URL do webhook.
   2. Clique em Fechar.

Crie um webhook

1. Inicie sessão na consola de administração do Jira.
2. Clique em Definições e selecione Sistema.
3. No painel Definições do sistema, selecione Webhooks.
4. Clique em Criar um webhook. Para informações sobre webhooks, consulte o artigo Webhooks.
5. Introduza um nome para o webhook.
6. Selecione o Estado como Enabled.
7. No campo URL, cole o URL copiado do Gemini Enterprise e acrescente /{issue.id}.

8. No campo Segredo, introduza o mesmo valor que introduziu quando gerou um URL de webhook no Gemini Enterprise.

   Nota: para verificar a consistência dos dados e evitar erros ao configurar webhooks no Jira, selecione apenas entidades que estejam ativadas para sincronização no seu repositório de dados.

9. Na secção Eventos relacionados com o problema, selecione as seguintes opções:

   Entidades	Criado	Atualizado	Eliminado
   Problema	Sim	Sim	Sim
   Registo de trabalho	Sim	Sim	Sim
   Comentário	Sim	Sim	Sim
   Anexo	Sim	Não	Sim

10. Na secção Eventos relacionados com o projeto, selecione as caixas de verificação criado, atualizado e eliminado para a entidade Projeto.

11. Clique em Criar.

Tratamento de dados e execução de consultas

Esta secção descreve como o Gemini Enterprise gere a sua consulta e as implicações de privacidade da utilização do repositório de dados federado.

Execução de consultas

Depois de autorizar o Jira Cloud e enviar uma consulta de pesquisa para o Gemini Enterprise:

• O Gemini Enterprise envia a sua consulta de pesquisa diretamente para a API Atlassian.
• O Gemini Enterprise mistura os resultados com os de outras origens de dados ligadas e apresenta um resultado de pesquisa abrangente.

Tratamento de dados

Quando utiliza a pesquisa federada de terceiros, aplicam-se as seguintes regras de processamento de dados:

• A sua string de consulta é enviada para o back-end de pesquisa de terceiros (API Atlassian).
• Estes terceiros podem associar consultas à sua identidade.
• Se estiverem ativadas várias origens de dados de pesquisa federada, a consulta pode ser enviada para todas elas.
• Assim que os dados chegam ao sistema de terceiros, são regidos pelos Termos de Utilização e pelas Políticas de Privacidade desse sistema.

Nota: para melhorar a precisão, um MDG pode reescrever a sua consulta antes de a enviar para o Jira Cloud. Esta consulta reescrita pode incorporar informações do histórico de consultas da sua sessão. Como resultado, partes do seu histórico de consultas também podem ser incluídas na consulta enviada para a API Atlassian.

O que se segue?

• Para fornecer uma interface do utilizador para consultar os seus dados do Jira Cloud, crie uma app e associe-a ao repositório de dados do Jira Cloud.
• Para ver a lista de ações, consulte o artigo Ver ações.
• Para pré-visualizar o aspeto dos resultados da pesquisa após a configuração da app, consulte o artigo Obtenha resultados da pesquisa.
• Para ativar alertas para o arquivo de dados, consulte o artigo Configure alertas para arquivos de dados de terceiros.