Compartilhar via


Implementar o conector Copilot no Local do Confluence

O conector No Local do Confluence permite ao Microsoft 365 indexar e obter conteúdos de instâncias do Servidor ou do Centro de Dados do Confluence autoalojado. Traz conteúdos wiki empresariais para o Microsoft Search e Copilot, melhorando a visibilidade e a usabilidade no ecossistema do Microsoft 365.

Este artigo descreve os passos para implementar, personalizar e resolver problemas do conector No Local do Confluence. 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 no local do Confluence, veja Configurar o serviço No Local do Confluence para ingestão de conectores.

Pré-requisitos

Antes de implementar o conector Confluence No local, 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.

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

Antes de implementar o conector, certifique-se de que são cumpridos os seguintes pré-requisitos:

  • Tem de ser um administrador do Microsoft 365.
  • Instale o Graph Connector Agent (GCA) num computador Windows na mesma rede que o servidor Confluence.
  • Instale o plug-in No Local do Confluence a partir do Atlassian Marketplace.
  • Confirme que o Plug-in Web do Confluence Mobile está instalado e ativado.
  • Confirme que as credenciais de autenticação estão disponíveis com permissões de administrador do Confluence.
  • Confirme que a versão do Confluence é a 8.0 ou superior.

Implementar o conector

Para adicionar o conector Confluence No local para a 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 No local.

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 Confluence No local ou personalizar o valor para utilizar um nome que os utilizadores na sua organização reconheçam.

Para obter mais informações, veja Enhance Copilot discovery with Microsoft 365 Copilot connectors content (Melhorar a deteção do Copilot com conteúdo de conectores Microsoft 365 Copilot)

Definir URL da instância

Para ligar ao seu site confluence, utilize o URL da instância do site da sua organização. O formato típico é:

  • https://<your-company-domain>/confluence

Para localizar o URL da instância:

  • Na Consola de Administração confluência, aceda aURL Base do Servidor de Configuração> Geral.

Escolher tipo de autenticação

O conector suporta os seguintes métodos de autenticação:

  • Autenticação básica: utilize o nome de utilizador e a palavra-passe do Confluence.
  • OAuth 1.0a: gere um par de chaves públicas/privadas e crie uma ligação de aplicação. Para obter mais informações, veja OAuth.
  • OAuth 2.0 (recomendado): registe uma ligação de aplicação de entrada com o âmbito de administrador.

Para a configuração do OAuth 2.0:

  1. Aceda a Administração Configuração>>geralLigações da aplicação.
  2. Selecione Criar ligação>Aplicação> externaRecebida.
  3. Defina o âmbito como Administração.
  4. Utilize o seguinte URL de redirecionamento: https://gcs.office.com/v1.0/admin/oauth/callback.

Implementar

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 obter mais informações, veja Implementação faseada para conectores Copilot.

Selecione Criar para implementar a ligação. O conector Copilot no Local do Confluence começa imediatamente a indexar conteúdo.

A tabela seguinte lista os valores predefinidos que estão definidos.

Categoria Configuração Valor padrão
Usuários Permissões de acesso Apenas pessoas com acesso a conteúdos na origem de dados.
Usuários Identidades do mapa As identidades das origens de dados são mapeadas com Microsoft Entra IDs.
Conteúdo Incluir/excluir espaço Todos os espaços incluídos.
Conteúdo Gerir propriedades Para obter as propriedades e esquemas predefinidos, veja Gerir propriedades.
Sincronização Pesquisa incremental A cada 15 minutos.
Sincronização Pesquisa completa Diariamente.

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

Pode personalizar os valores predefinidos para as definições do conector Confluence No local. 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: os dados indexados são visíveis para todos os utilizadores.
  • Apenas as pessoas com acesso: os dados indexados são visíveis apenas para os utilizadores com acesso no Confluence.

No Confluence No local, 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. A avaliação de permissão ocorre da seguinte forma:

  • Obtenha a configuração de permissão a partir das restrições ao nível da página.
  • Obtenha a configuração de permissão a partir das restrições da página principal.
  • Obtenha a configuração de permissão a partir das permissões de espaço.
  • Calcule a interseção das três configurações anteriores para determinar a permissão efetiva na página. Este conjunto de permissões final é sincronizado com Microsoft 365 Copilot.

Importante

As definições de acesso anónimo definidas ao nível do espaço não são consideradas.

Se escolher Apenas pessoas com acesso a esta origem de dados, escolha se o seu site confluence tem Microsoft Entra ID utilizadores aprovisionados ou utilizadores não Microsoft Entra ID:

  • Microsoft Entra ID: selecione esta opção se os IDs de e-mail da Confluence corresponderem aos nomes principais de utilizador (UPNs) no Microsoft Entra ID.
  • Não Microsoft Entra ID: selecione esta opção se os IDs de e-mail da Confluence não corresponderem aos UPNs. Utilize o regex para mapear IDs de e-mail para UPNs.

Atualizações as permissões são sincronizadas apenas durante pesquisas completas.

Personalizar definições de conteúdo

Pode personalizar as definições de conteúdo das seguintes formas:

  • Inclua ou exclua espaços específicos com a opção de filtro de espaço. Cada espaço tem um identificador de chave de espaço que faz parte do URL desse espaço. Para obter mais informações, veja Teclas de espaço.
  • Especifique um intervalo de datas para indexação de documentos. Pode Filtrar páginas por Data da Última Criação ou Data da Última Modificação.
  • Adicione ou remova propriedades da origem de dados, atribua um esquema a propriedades (pesquisáveis, queryable, recuperáveis, refináveis) e altere as etiquetas semânticas associadas às propriedades. A tabela seguinte lista as propriedades predefinidas.
Propriedade Source Rótulo Esquema
Autor autores Consultar, Obter
Conteúdo Pesquisar
CreatedByName Criado por Procurar, Consultar, Obter
CriadoOn Data e hora de criação Consultar, Obter
Id Consultar, Obter
Árvore de Páginas Obter
SpaceName Procurar, Consultar, Obter
Título title Procurar, Obter
UpdatedByName lastModifiedBy Obter
UpdatedOn lastModifiedDateTime Consultar, Obter, Refinar
URL url Obter

Personalizar intervalos de sincronização

Pode ajustar a frequência de sincronização:

  • Pesquisa incremental: sincroniza conteúdo novo e modificado. As pesquisas incrementais não recolhem alterações ou itens eliminados da ACL. A predefinição é de 15 em 15 minutos.
  • 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). A predefinição é diária.

Para obter mais informações, veja Diretrizes para definições de sincronização.