Configurar um repositório de dados do Jira Cloud

Acesso antecipado:os recursos de pesquisa e ações federadas estão em Acesso antecipado. Esse recurso está sujeito aos "Termos das ofertas pré-GA" na seção Termos gerais de serviço dos Termos específicos de serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Nesta página, descrevemos como criar um repositório de dados e conectar o Jira Cloud ao Gemini Enterprise.

Antes de começar

Antes de configurar a conexão federada do Jira Cloud, verifique o seguinte:

• Conceda o papel de editor do Discovery Engine (roles/discoveryengine.editor). Esse papel é necessário para que o usuário crie o repositório de dados. Para conceder esse papel:

  1. No console do Google Cloud , acesse a página IAM.

     Acessar IAM

  2. Localize a conta de usuário e clique no ícone editar Editar.
  3. Conceda a função Discovery Engine Editor ao usuário. Para mais informações, consulte Papéis e permissões do IAM.

• Para aplicar o controle de acesso à fonte de dados e proteger os dados no Google Gemini Enterprise, configure seu provedor de identidade.

• Para configurar o conector do Jira Cloud, use o novo modelo centralizado de gerenciamento de usuários da Atlassian. Se você estiver usando o modelo original, migre o gerenciamento de usuários antes de continuar. Para mais informações, consulte Função de administrador do site.

• Crie um app OAuth 2.0, obtenha o ID do cliente e a chave secreta e configure as permissões mínimas do aplicativo com o consentimento de um administrador do Jira Cloud. Verifique se você tem acesso de administrador da organização do Jira à instância e ao projeto do Jira. Com o acesso de administrador da organização, é possível configurar permissões mínimas e conceder privilégios de acesso a grupos de usuários.

• Opcional: para recuperar endereços de e-mail de usuários do Jira Cloud, mesmo quando as configurações restringem a visibilidade do e-mail, instale o app User Identity Accessor for Jira Cloud com privilégios de administrador do site do Jira para instalar e configurar o app para recuperar endereços de e-mail de usuários com segurança. Talvez não seja necessário instalar esse app se os endereços de e-mail já estiverem acessíveis publicamente.

  Observação: a Atlassian está atualizando elementos da interface do usuário, e alguns elementos mencionados nesta documentação estão sendo renomeados. Por exemplo, Produtos está sendo renomeado como Apps. Para mais informações, consulte Mudança na terminologia da administração da Atlassian de "produtos" para "apps".

Criar um repositório de dados do Jira Cloud

Para criar um repositório de dados do Jira Cloud, siga estas etapas:

1. No console Google Cloud , acesse a página do Gemini Enterprise.

   Gemini Enterprise

2. Selecione ou crie um projeto do Google Cloud .

   Observação: para acessar o fluxo unificado, seu projeto precisa estar na lista de permissões.

3. No menu de navegação, selecione Repositório de dados.

4. Clique em Criar repositório de dados.

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

6. Na seção Dados:

   1. Na seção Modo do conector, selecione Ingestão de dados ou Pesquisa federada como o modo de conexão.

   2. Clique em Continuar.

   3. Na seção Configurações de autenticação, configure a autenticação com base no modo de conexão escolhido.

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

         • ID do cliente
         • Chave secreta do cliente
         • URI da instância
         • ID da instância

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

      2. Se você selecionou Pesquisa federada, clique em Fazer login e conclua o processo de login da Atlassian.

      3. Clique em Continuar.

   4. Na seção Destinos, insira o URL do endpoint do Jira Cloud.

   5. Clique em Continuar.

   6. Na seção Entidades para pesquisar (se você selecionou Pesquisa federada) ou Entidades para sincronizar (se você selecionou Ingestão de dados):

      1. Selecione todas as entidades necessárias.
      2. Se você selecionou Pesquisa federada, prossiga para a próxima etapa.
      3. Se você selecionou Ingestão de dados, siga estas etapas:
         1. Opcional:para sincronizar projetos específicos, faça o seguinte:
            1. Clique em Filtrar.
            2. Para filtrar entidades do índice, marque a caixa de seleção Excluir do índice ou, para garantir que elas sejam incluídas, marque a caixa de seleção Incluir no índice.
            3. Insira as chaves. Pressione "Enter" depois de cada chave.
            4. Clique em Salvar.
         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.
               • Para programar sincronizações completas separadas de dados de entidade e identidade, abra o menu na seção Sincronização completa e selecione Opções personalizadas.
            2. Na lista Frequência de sincronização incremental, selecione a opção desejada. Para mais informações, consulte Programações de sincronização.

7. Clique em Continuar.

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

   1. Se você selecionou Pesquisa federada:
      1. Em Selecionar ações do Jira Cloud para ativar, escolha as ações da categoria para ativar no conector.

   2. Se você selecionou Ingestão de dados:

      1. Na seção Configurações de autenticação, configure a autenticação com base no modo de conexão escolhido.

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

         • ID do cliente
         • Client Secret
         • URI da instância
         • ID da instância

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

      3. Clique em Login e faça login no Jira Cloud para verificar sua conta.

      4. Clique em Continuar.

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

      Observação: se você optar por não adicionar ações nesta etapa, será necessário criar um novo repositório de dados para adicioná-las. Para conferir a lista de ações, consulte Ver ações.

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

   1. Na lista Multirregional, selecione o local do conector de dados.
   2. No campo Nome do conector de dados, insira um nome para o conector.
   3. Se você selecionou US ou EU como o local, configure as Configurações de criptografia:
      • Opcional: se você não tiver configurado chaves de região única, clique em Acessar a página de configurações para fazer isso. Para mais informações, consulte Registrar uma chave de região única para conectores de terceiros.
      • Selecione Chave de criptografia gerenciada peloGoogle ou Chave do Cloud KMS.
      • Se você selecionou Chave do Cloud KMS:
        • Na lista Tipo de gerenciamento de chaves, selecione o tipo adequado.
        • Na lista Chave do Cloud KMS, selecione a chave.
      Para mais informações, consulte Chaves de criptografia gerenciadas pelo cliente.

10. Clique em Continuar.

11. Na seção Faturamento, selecione Preços gerais ou Preços configuráveis. Para mais informações, consulte Verificar o status de faturamento dos seus projetos e Licenças.

12. Clique em Criar. O Gemini Enterprise cria e exibe os repositórios de dados na página Repositórios de dados.

Na página Repositórios de dados, clique no nome da loja para conferir o status. Depois que o estado do repositório de dados mudar de Criação para Ativo, o conector do Jira Cloud estará pronto para uso.

Para um conector de ingestão criado com o Jira Cloud, o estado do repositório de dados muda de Criação para Em execução após o início da sincronização. Em seguida, ele muda para Ativo quando a ingestão é concluída, indicando que o repositório de dados está totalmente configurado. Dependendo do volume de dados, a ingestão pode levar várias horas.

Depois de criar o repositório de dados, crie um app, conecte-o ao repositório de dados do Jira Cloud e autorize o Gemini Enterprise a acessar o Jira Cloud antes de executar qualquer consulta.

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

Pré-lançamento — Real-time sync

Este recurso está sujeito aos "Termos da Oferta Pré-GA" na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis no estado em que se encontram e podem ter assistência limitada. Para mais informações, consulte as descrições das fases de lançamento.

A sincronização em tempo real só sincroniza entidades de documento e não sincroniza dados relacionados a entidades de identidade. A tabela a seguir mostra quais eventos de documento são compatíveis com a sincronização em tempo real.

Entidades do Jira	Criar	Atualizar	Excluir	Alterações de permissão
Problemas
Registros de trabalho
Projetos
Comentários
Anexos

Para ativar a sincronização em tempo real de um conector de fonte de dados do Jira Cloud, siga estas etapas:

Gerar um URL de webhook

1. Navegue até a página do Gemini Enterprise e, no menu de navegação, clique em Repositórios 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 botão Ativar sincronização em tempo real.
   2. Insira um valor no campo Chave secreta do cliente e copie-o. Você vai precisar desse valor novamente ao criar um webhook no console de administração do Jira.
   3. Clique em Salvar.

5. Depois que o status 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 endereço em Webhook URL.
   2. Clique em Fechar.

Criar um webhook

1. Faça login no console de administração do Jira.
2. Clique em Configurações e selecione Sistema.
3. No painel Configurações do sistema, selecione Webhooks.
4. Clique em Criar um webhook. Para informações sobre webhooks, consulte Webhooks.
5. Digite um nome para o webhook.
6. Selecione o Status como Enabled.
7. No campo URL, cole o URL copiado do Gemini Enterprise e adicione /{issue.id}.

8. No campo Secret, insira o mesmo valor que você inseriu ao gerar um URL de webhook no Gemini Enterprise.

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

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

   Entidades	Criado	Atualizado	Excluído
   Problema	Sim	Sim	Sim
   Registro de trabalho	Sim	Sim	Sim
   Comentário	Sim	Sim	Sim
   Anexo	Sim	Não	Sim

10. Na seção Eventos relacionados ao projeto, marque as caixas de seleção criado, atualizado e excluído para a entidade Projeto.

11. Clique em Criar.

Tratamento de dados e execução de consultas

Esta seção descreve como o Gemini Enterprise gerencia sua consulta e as implicações de privacidade do uso do repositório de dados federado.

Execução da consulta

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

• O Gemini Enterprise envia sua consulta de pesquisa diretamente para a API do Atlassian.
• O Gemini Enterprise combina os resultados com os de outras fontes de dados conectadas e mostra um resultado da pesquisa abrangente.

Processamento de dados

Ao usar a pesquisa federada de terceiros, as seguintes regras de tratamento de dados são aplicadas:

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

Observação: para melhorar a acurácia, um LLM pode reescrever sua consulta antes de enviá-la ao Jira Cloud. Essa 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 à API do Atlassian.

A seguir

• Para fornecer uma interface do usuário para consultar seus dados do Jira Cloud, crie um app e conecte-o ao repositório de dados do Jira Cloud.
• Para conferir a lista de ações, consulte Ver ações.
• Para ver como os resultados da pesquisa aparecem depois que o app é configurado, consulte Receber resultados da pesquisa.
• Para ativar alertas para o repositório de dados, consulte Configurar alertas para repositórios de dados de terceiros.