Implementar o conector de Microsoft 365 Copilot recursos do Adobe Experience Manager

O conector Copilot assets do Adobe Experience Manager (AEM) integra o conteúdo dos Recursos do AEM no ecossistema do Microsoft 365, permitindo que o Copilot e o Microsoft Search obtenham recursos publicados. Este artigo descreve os passos para implementar e personalizar o conector.

Pré-requisitos

Antes de implementar o conector Recursos do Adobe Experience Manager, certifique-se de que cumpre os seguintes pré-requisitos:

• Tem de ser o administrador de pesquisa do inquilino do Microsoft 365 da sua organização.
• Tem o URL do ambiente de autor da instância do Adobe Experience Cloud da sua organização e o URL do ambiente de publicação:
  • Formato de URL do autor: https://author-p<PROGRAM_ID>-e<ENVIRONMENT_ID>.<REGION>.adobeaemcloud.com
  • Publicar formato de URL: https://publish-p<PROGRAM_ID>-e<ENVIRONMENT_ID>.<REGION>.adobeaemcloud.com
• Tem uma conta técnica dos Recursos do Adobe Experience Manager com credenciais para aceder a metadados e recursos publicados. Esta conta é uma conta segura baseada no serviço para acesso externo. Para obter detalhes, veja Gerar tokens de acesso para APIs do lado do servidor.

Implementar o conector

Para adicionar o conector de Recursos do Adobe Experience Manager 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 Recursos do Adobe Experience Manager.

Definir nome a apresentar

O nome a apresentar identifica referências em respostas copilot e funciona como um filtro de origem de conteúdo. Pode aceitar o nome a apresentar predefinido ou personalizá-lo para um nome que os utilizadores na sua organização reconheçam.

Para obter mais informações, veja Enhance Copilot discovery of connector content (Melhorar a deteção copilot de conteúdo do conector).

Definir URL da instância

Forneça os URLs do ambiente de criação e publicação para a sua instância de Recursos do Adobe Experience Manager.

Escolher tipo de autenticação

O conector suporta a autenticação de conta técnica para o Adobe Experience Cloud. Configure a conta técnica conforme descrito em Gerar tokens de acesso para APIs do lado do servidor.

Implementar

Para validar o conector antes da implementação, utilize uma implementação faseada. 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 começa a indexar recursos publicados imediatamente.

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

Para personalizar estes valores, selecione Configuração personalizada. Para obter mais informações, 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 Recursos do Adobe Experience Manager. 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

Permissões de acesso

Atualmente, apenas os recursos publicados dos seus Recursos do AEM são indexados. Todos os dados indexados através do conector Adobe Experience Manager Assets Copilot estão visíveis para todos os utilizadores do Microsoft 365 no seu inquilino, a partir do Microsoft Search ou Copilot.

Mapeamento de identidade do utilizador

O conector mapeia as contas de utilizador do Adobe Experience Cloud para identidades do Microsoft 365 (Microsoft Entra ID). Se os e-mails dos utilizadores do Adobe Experience Cloud corresponderem aos nomes principais de utilizador (UPNs) do Entra ID, este mapeamento é automático. Se forem diferentes, pode fornecer uma regra de mapeamento para mapear identidades no Adobe Experience Cloud para identidades no Microsoft 365. As regras de mapeamento garantem que o sistema fornece um sinal de atividade adequado ao conteúdo do Adobe Experience Cloud em respostas.

Personalizar definições de conteúdo

Filtros de ingestão de conteúdos

Os filtros de ingestão de conteúdos permitem-lhe controlar que recursos são indexados ao definir regras de inclusão e exclusão com base em caminhos e propriedades de metadados.

Pode optar por incluir ou excluir determinados caminhos de conteúdo.

Caminhos de conteúdo que devem ser obtidos Só são suportados caminhos exatos. Um caminho de conteúdo válido tem de conter, pelo menos, dois níveis, com /content como caminho de raiz.

Caminhos de conteúdo que não devem ser obtidos Suporte apenas a expressão regular java de entrada para caminhos. Os caminhos excluídos têm prioridade sobre os caminhos incluídos.

Também pode definir filtros de ingestão com base no valor das propriedades de metadados, incluindo propriedades de metadados padrão e personalizadas:

1. Introduza o caminho JSON da propriedade .
2. Selecione um Operador na lista pendente (=, !=, In, Not In).
3. Introduza o valor de destino.

Para localizar e verificar o caminho da propriedade, veja API do construtor de consultas.

1. Abra o depurador do construtor de consultas em http://<host>:<port>/libs/cq/search/content/querydebug.html.

2. Introduza a seguinte consulta.

   p.limit=10  
   p.guessTotal=true  
   p.hits=full  
   type=dam:Asset  
   p.nodedepth=2  
   property=jcr:content/cq:lastReplicationAction  
   property.value=Activate
   

3. Selecione procurar.

4. Depois de os resultados serem devolvidos, selecione a ligação do construtor de consultas JSON para ver o conteúdo JSON com todas as propriedades.

   

5. Localize a propriedade e o caminho JSON da propriedade . Por exemplo, o caminho JSON da propriedade dc:format é hits.jcr:content.metadata.dc:format.

   

Operadores
O operador define o tipo de comparação aplicado a uma propriedade durante a filtragem de conteúdo. Os operadores com suporte são:

• =: Igual a
• !=: Não é igual a
• In: corresponde a qualquer valor numa lista
• Not In: exclui qualquer valor numa lista

Valores de destino
Os valores de destino especificam o que a propriedade deve corresponder.

Gerir propriedades

Para marcar propriedades padrão disponíveis dos seus Recursos do Adobe Experience Manager, 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 padrão estão indexadas por predefinição.

Para adicionar mais propriedades personalizadas:

1. Selecione Adicionar propriedade.
2. Preencha os seguintes campos: a. Nome da propriedade b. Escreva c. Caminho JSON
3. Defina o esquema (pesquisável, queryable, recuperável ou refinável).

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 de Recursos do Adobe Experience Manager. Os conectores copilot utilizam dois tipos de intervalos de atualização:

• Pesquisa completa: o valor predefinido é todos os dias.
• Pesquisa incremental: o valor predefinido é de 15 em 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

• Descrição geral do conector de Recursos do Adobe Experience Manager
• Resolver problemas com o conector de Recursos do Adobe Experience Manager