Compartilhar via

Implementar o conector Confluence Cloud Copilot no Centro de administração do Microsoft 365

O conector confluence Cloud Microsoft 365 Copilot integra conteúdos da Confluence no Microsoft 365, permitindo que o Copilot, a Copilot Search e o Microsoft Search visualizem páginas wiki e blogues relevantes diretamente em aplicações como o Teams, Outlook e SharePoint.

Este artigo descreve os passos para implementar, personalizar e resolver problemas do conector Confluence Cloud Copilot. Para obter informações gerais sobre a implementação do conector Copilot, veja Configurar conectores Copilot no Centro de administração do Microsoft 365.

Para obter informações avançadas sobre a configuração da Cloud de Confluence, veja Configurar o serviço Cloud confluence para ingestão de conectores.

Pré-requisitos

Antes de implementar o conector confluence Cloud, certifique-se de que o ambiente confluence está configurado na sua organização. A tabela seguinte resume os passos para configurar o ambiente confluence e implementar o conector.

Tarefa Função
Configurar o ambiente Administrador de confluência
Configurar pré-requisitos Administrador de confluência/Administrador de rede
Implementar o conector no Centro de administração do Microsoft 365 Administrador do Microsoft 365
Personalizar as definições do conector (opcional) Administrador do Microsoft 365

Para implementar o conector, tem de cumprir os seguintes pré-requisitos:

  • Tem de ser um administrador do inquilino do Microsoft 365 da sua organização e do site confluence da sua organização.
  • Tem de ter credenciais de autenticação com o acesso certo.

Implementar o conector

Para adicionar o conector confluence Cloud à sua organização:

  1. Na Centro de administração do Microsoft 365, no painel esquerdo, selecioneConectoresCopilot>.
  2. Aceda ao separador Conectores e, no painel esquerdo, selecione Galeria.
  3. Na lista de conectores disponíveis, selecione Confluence Cloud.

Definir nome a apresentar

O nome a apresentar é utilizado para identificar referências em respostas copilot para ajudar os utilizadores a reconhecer o ficheiro ou item associado. O nome a apresentar também significa conteúdo fidedigno e é utilizado como um filtro de origem de conteúdo.

Pode aceitar o nome a apresentar predefinido da Confluence Cloud ou personalizar o valor para utilizar um nome a apresentar que os utilizadores na sua organização reconheçam.

Para obter mais informações sobre os nomes a apresentar e descrições do conector, veja Melhorar a deteção do Copilot com Microsoft 365 Copilot conteúdos dos conectores.

Definir URL da instância

Para ligar ao seu site confluence, utilize o URL do site, que é normalmente o seguinte: https://<organization_name>.atlassian.net.

O <organization_name> valor é o identificador exclusivo do site da Confluence Cloud.

Escolher tipo de autenticação

Para autenticar e sincronizar conteúdos da Confluence, escolha um dos seguintes tipos de autenticação:

  • Autenticação básica – para autenticar com autenticação básica, introduza o seu nome de utilizador (normalmente o seu endereço de e-mail) e o token de API. Para gerar um token de API, veja Gerir tokens de API para a sua conta Atlassian.

  • OAuth 2.0 (recomendado) – registe uma aplicação na Confluence Cloud para que o Microsoft Search e Microsoft 365 Copilot possam aceder à instância. Para obter mais informações, consulte Ativar o OAuth 2.0 (3LO).

    Para registar a aplicação:

    1. Inicie sessão na consola do Atlassian Developer com a sua conta de administrador do Atlassian Confluence.

    2. Selecione Criar e selecione Integração OAuth 2.0.

    3. Forneça um nome para a aplicação e crie a nova aplicação.

    4. No painel esquerdo, selecione Permissões e, junto a API de Confluence, selecione Adicionar.

    5. Selecione ConfigurarÂmbitos de edição e selecione > os âmbitos listados na tabela seguinte.

      Nome do escopo Código Descrição
      Ver detalhes do conteúdo read:content-details:confluence Conteúdo de pesquisa que satisfaz os critérios.
      Ver grupos read:group:confluence Aceder a permissões de conteúdo do grupo.
      Ver detalhes do utilizador read:user:confluence Aceda a detalhes de utilizadores individuais para suportar permissões.
      Ver registos de auditoria read:audit-log:confluence Aceda a registos de auditoria para eventos de Confluence para suportar permissões.
      Ver páginas read:page:confluence Aceder aos detalhes do conteúdo da página para suportar permissões.
      Ver espaços read:space:confluence Aceder a detalhes de espaço para suportar permissões.
      Ver restrições de conteúdo e permissões de espaço read:permission:confluence Ver restrições de conteúdo e permissões de espaço.
      Ver resumos de conteúdo read:content.metadata:confluence Aceder a informações sobre o conteúdo para suportar permissões.
      Ver comentários read:comment:confluence Ver comentários em páginas ou mensagens de blogue.
      Ver e transferir anexos de conteúdo read:attachment:confluence Ver e transferir anexos de uma página ou mensagem de blogue à qual tenha acesso.

    6. Escolha Salvar.

    7. No painel esquerdo, aceda a Autorização. Adicione o URL de chamada de retorno para o Microsoft 365, da seguinte forma:

      • Microsoft 365 Enterprise -https://gcs.office.com/v1.0/admin/oauth/callback
      • Microsoft 365 Government - https://gcsgcc.office.com/v1.0/admin/oauth/callback 

    8. Escolha Salvar.

    9. No painel esquerdo, aceda a Definições. Copie o ID de Cliente e o Segredo. Conclua o passo de definições de ligação com o ID de Cliente e o Segredo.

Dica

Certifique-se de que a conta de serviço tem acesso de visualização ao conteúdo da Confluence que pretende indexar.

Implementar

Implemente a ligação a um conjunto limitado de utilizadores para validá-la no Copilot e noutras superfícies de pesquisa antes de a implementar para uma audiência mais ampla. Para obter mais informações, veja Implementação faseada para conectores Microsoft 365 Copilot.

Para implementar para uma audiência limitada, selecione o botão de alternar junto a Implementação para audiência limitada e especifique os utilizadores e grupos para os quais pretende implementar o conector.

Para implementar o conector, selecione Criar no Centro de administração do Microsoft 365. O conector Confluence Cloud Copilot começa a indexar páginas a partir da sua conta confluence imediatamente.

A tabela seguinte lista os valores predefinidos que estão definidos. Estes valores funcionam melhor com os dados da Confluence.

Categoria Setting Valor padrão
Usuários Permissões de acesso Apenas pessoas com acesso ao conteúdo na origem de dados.
Usuários Identidades do mapa Identidades de origem de dados mapeadas com Microsoft Entra IDs.
Conteúdo Incluir/excluir espaço Todos
Conteúdo Gerir propriedades Para obter as propriedades e esquemas predefinidos, veja Gerir propriedades.
Sincronização Pesquisa incremental Frequência: a cada 15 minutos
Sincronização Pesquisa completa Frequência: todos os dias

Para personalizar estes valores, veja Personalizar definições.

Depois de criar a ligação, pode rever a status na secção Conectores do Centro de administração do Microsoft 365.

Personalizar definições (opcional)

Pode personalizar os valores predefinidos para as definições do conector confluence Cloud. Para personalizar as definições, na página do conector no centro de administração, selecione Configuração personalizada.

Personalizar as definições do utilizador

O conector confluence Cloud suporta as seguintes permissões de pesquisa de utilizadores:

  • Todos
  • Apenas pessoas com acesso a esta origem de dados (predefinição)

Se escolher Todos, os dados indexados são apresentados nos resultados da pesquisa para todos os utilizadores. Se escolher Apenas pessoas com acesso a esta origem de dados, os dados indexados são apresentados nos resultados da pesquisa para os utilizadores que têm acesso à mesma. Na Confluence Cloud, as permissões de segurança para utilizadores e grupos são definidas através de permissões de espaço e restrições de página. As restrições ao nível da página, se estiverem presentes, têm precedência sobre as permissões de espaço.

Se não forem especificadas restrições de página, o conector verifica as permissões ao nível do espaço e aplica o seguinte:

  • Se o espaço tiver acesso de utilizadores anónimos ativado, o conteúdo é visível para todos os utilizadores no seu inquilino.
  • Se o espaço não tiver acesso anónimo ativado, as permissões ao nível do espaço são respeitadas.
  • Se as permissões ao nível do espaço não estiverem definidas, o conteúdo não será visível para nenhum utilizador no seu inquilino.

Importante

As permissões são geridas apenas ao nível do espaço e da página. As permissões da página principal não são aplicadas.

Se escolher Apenas pessoas com acesso a esta origem de dados, também terá de escolher se o seu site confluence tem Microsoft Entra ID utilizadores aprovisionados ou utilizadores que não sejam utilizadores do ID de Entra:

  • Escolha a opção Microsoft Entra ID se o ID de e-mail dos utilizadores do Confluence for igual ao nome principal de utilizador (UPN) no Microsoft Entra ID.
  • Escolha a opção de ID não Entra se o ID de e-mail dos utilizadores do Confluence for diferente do UPN no Microsoft Entra ID.

Observação

  • Se escolher Microsoft Entra ID como a origem de identidade, o conector mapeia os IDs de e-mail do utilizador da Confluence para a propriedade UPN no Microsoft Entra ID.
  • Se escolher o ID não Entra como a origem de identidade, forneça uma expressão regular para mapear o ID de e-mail para o UPN. Para obter mais informações, consulte Mapear as suas identidades não-Entra ID.
  • Atualizações para utilizadores ou grupos que regem as permissões de acesso são sincronizados apenas em pesquisas completas. Atualmente, as pesquisas incrementais não suportam o processamento de atualizações para permissões.

Personalizar definições de conteúdo

Pode personalizar os dados incluídos e excluídos e personalizar as propriedades do conector predefinido.

Incluir ou excluir dados

Por predefinição, o conector confluence Cloud indexa todos os blogues e páginas. Pode incluir ou excluir dados que pretende indexar. Pode utilizar uma cadeia CQL (Confluence Query Language) para especificar condições para sincronizar páginas. Por exemplo, pode optar por indexar apenas as páginas que foram modificadas nos últimos dois anos. Para obter mais informações, veja Pesquisa Avançada com CQL.

Dica

Pode utilizar o filtro CQL para indexar conteúdo modificado após um determinado período de tempo ao utilizar, por exemplo, lastModified >= "2024/12/31".

Selecione Pré-visualizar resultados para verificar os valores de exemplo das propriedades selecionadas e da cadeia CQL.

Gerir propriedades

Para adicionar ou remover propriedades disponíveis do conector Confluence Cloud, atribua um esquema à propriedade (defina se uma propriedade é pesquisável, queryable, recuperável ou refinável), altere a etiqueta semântica e adicione um alias à propriedade. As seguintes propriedades estão indexadas por predefinição.

Propriedade predefinida Rótulo Descrição
Autores authors Nome das pessoas que participaram/colaboraram no item na origem de dados.
CreatedByName createdBy Nome da pessoa que editou o item mais recentemente na fonte de dados.
IconUrl iconUrl O URL do ícone associado do item.
Título title O título do item que pretende que seja apresentado na pesquisa e noutras experiências.
UpdatedByName lastModifiedBy Nome da pessoa que editou o item mais recentemente na fonte de dados.
UpdatedOn lastModifiedDateTime Data e hora em que o item foi modificado pela última vez na origem de dados.
Url url A URL de destino do item na fonte de dados.

Selecione o botão Pré-visualizar resultados para verificar as propriedades e filtros selecionados.

Personalizar intervalos de sincronização

O intervalo de atualização determina a frequência com que os seus dados são sincronizados entre a origem de dados e o índice do conector confluence Cloud. Os conectores copilot utilizam dois tipos de intervalos de atualização:

  • Pesquisa completa – efetua uma sincronização completa de todo o conteúdo. As pesquisas completas detetam itens eliminados e sincronizam as alterações da lista de controlo de acesso (ACL). Por predefinição, as pesquisas completas são executadas a cada 24 horas.
  • Pesquisa incremental – sincroniza conteúdo novo e modificado. As pesquisas incrementais não recolhem alterações da ACL nem itens eliminados. Por predefinição, as pesquisas incrementais são executadas a cada 15 minutos.

Pode alterar os valores predefinidos dos intervalos de atualização. Para obter mais informações, veja Diretrizes para definições de sincronização.

Conteúdo relacionado

  • Last updated on