Configure um repositório de dados do Confluence Cloud

Esta página descreve como criar um arquivo de dados e associar o Confluence Cloud ao Gemini Enterprise.

Antes de começar

Certifique-se do seguinte antes de configurar a ligação federada do Confluence 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 Confluence 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 Confluence Cloud.

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

Crie um repositório de dados do Confluence Cloud

Para criar um repositório de dados do Confluence 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.

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

  4. Clique em Criar arquivo de dados.

  5. Na secção Origem, pesquise Confluence 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. Se selecionou Carregamento de dados:

        1. Selecione Credenciais do cliente OAuth 2.0 ou Token da API como método de autenticação.
        2. Se selecionar Credenciais de cliente OAuth 2.0, introduza os seguintes detalhes:
          • ID de cliente
          • Segredo do cliente
          • URI da instância
          • ID da instância
        3. Se selecionar Token de API, introduza os seguintes detalhes:
          • URI da instância
          • Conta de utilizador
          • Chave de API

      2. Se selecionou Pesquisa federada:

        1. As credenciais de cliente OAuth 2.0 são o único método aplicável. Forneça os seguintes detalhes:
          • ID de cliente
          • Segredo do cliente
          • URI da instância

      Para mais informações sobre as credenciais, consulte a configuração do Confluence Cloud.

      1. Clique em Iniciar sessão e conclua o início de sessão na Atlassian.

    4. Clique em Continuar.

    5. Na secção Destinos, introduza o URL do seu ponto final do Confluence Cloud.

    6. Clique em Continuar.

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

      1. Selecione todas as entidades necessárias.
      2. Opcional: para sincronizar projetos específicos, faça o seguinte:
        1. Clique em Filtrar.
        2. Para filtrar entidades do índice, selecione Excluir do índice ou, para garantir que são incluídas no índice, selecione Incluir no índice.
        3. Introduza as teclas de espaço. Prima Enter depois de cada tecla de espaço.
        4. Clique em Guardar.

      3. Se selecionou Carregamento de dados, para configurar a agenda 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 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.

  9. Clique em Continuar.

  10. 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.

  11. 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 Confluence Cloud está pronto a ser usado.

Para um conector de carregamento criado com o Confluence 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 Confluence Cloud e autorize o Gemini Enterprise a aceder ao Confluence Cloud antes de executar quaisquer consultas.

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

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 Confluence Criar Atualizar Eliminar Alterações de permissões
Espaços
Páginas
Blogues
Anexos
Comentários
Quadros brancos

Ative a sincronização em tempo real 20 minutos após a criação do arquivo de dados do Confluence Cloud. Para ativar a sincronização em tempo real para uma origem de dados do Confluence, 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 arquivo de dados do Confluence.
  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. No campo Segredo do cliente, introduza um valor de marcador de posição, como clientsecret.
    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.

Subscreva eventos através da API

Para receber atualizações em tempo real do Confluence, tem de subscrever eventos específicos através de um pedido POST. Para fazer chamadas à API, use a mesma conta de administrador usada para configurar a autenticação e as autorizações no Confluence para criar o arquivo de dados.

      curl -X POST \
        INSTANCE_URL/wiki/rest/webhooks/1.0/webhook \
        -H "Content-Type: application/json" \
        -u "USERNAME:API_TOKEN" \
        -d '{
          "name": "SUBSCRIPTION_NAME",
          "url": "LISTENER_URL",
          "events": [
            "EVENT_TYPE_1",
            "EVENT_TYPE_2"
          ],
          "active": true
        }'

  • INSTANCE_URL: o endereço Web base do seu site do Atlassian Cloud.

  • USERNAME: O nome de utilizador do Atlassian Cloud.

  • API_TOKEN: a chave da API gerada a partir da sua conta da Atlassian. Para mais informações, consulte o artigo Configure um token de API no Confluence

  • SUBSCRIPTION_NAME: um nome exclusivo para a sua subscrição de eventos.

  • LISTENER_URL: O URL do webhook copiado da Google Cloud consola assim que a sincronização em tempo real (RTS) estiver ativada no seu repositório de dados.

  • EVENT_TYPE: os tipos de eventos aos quais quer subscrever. Pode subscrever a criação, a atualização e a eliminação de eventos para anexos, publicações no blogue, páginas, espaços e comentários.

    O utilizador pode subscrever os seguintes eventos:

    • space_created
    • space_updated
    • page_created
    • page_updated
    • attachment_created
    • attachment_updated
    • comment_created
    • comment_updated
    • blog_created
    • blog_updated

Códigos de erro da API

Esta tabela apresenta códigos de erro da API comuns que os utilizadores encontram quando criam webhooks.

Classe de erro Código de erro Mensagem de erro Resolução de problemas
403 FORBIDDEN O utilizador atual não tem autorização para usar o Confluence. Certifique-se de que tem um token válido de uma conta de administrador e um ponto final da API correto.

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 Confluence 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.

O que se segue?