Compartilhar via

Gerenciar provedores de pesquisa integrada

  • Artigo

Com provedores de pesquisa integrados no Dynamics 365 Customer Service, você pode configurar fontes de terceiros, como sites empresariais baseados no protocolo do mapa do site. Os artigos são ingeridos no Dataverse e atualizados no agendamento especificado.

Pré-requisitos

Se você for um usuário iniciante, deverá fornecer provedores de pesquisa integrados. Verifique se você tem os seguintes privilégios:

  • Nível básico: prvReadconnector
  • Nível global:
    • prvReadWorkflow
    • prvWriteWorkflow
    • prvCreatemsdyn_knowledgeconfiguration
    • prvReadmsdyn_knowledgeconfiguration
    • prvWritemsdyn_knowledgeconfiguration
    • prvDeletemsdyn_knowledgeconfiguration

Saiba mais sobre direitos de acesso e privilégios.

Provisionar provedores de pesquisa integrada

  1. Entre no Centro de administração do Dynamics 365 Customer Service.
  2. Vá para Conhecimento>Provedores de pesquisa integrada (Versão Preliminar)>Gerenciar.
  3. Na página Provedores de pesquisa integrada, selecione Configurar pesquisa integrada.

Se você não conseguir fornecer o provedor de pesquisa integrado, precisará ativar o fluxo de gatilho da API de pesquisa integrada.

Se a pesquisa integrada não estiver habilitada na região geográfica, contate o Suporte da Microsoft para provisionar o recurso.

Habilitar o Fluxo de gatilho de API de Pesquisa Integrada

Observação

Para ativar o fluxo Gatilho de API de pesquisa integrado, você deve ter os privilégios prvReadWorkflow (nível global).

Dica

As imagens que incluem um ícone com esta aparência: podem ser expandidas para mostrar mais detalhes. Selecione a imagem para expandi-la. Para fechá-la, pressione a tecla Esc.

  1. Entre em make.powerapps.com.

  2. Vá para Soluções>Solução Padrão>Fluxos da nuvem e ative Fluxo de gatilho da API de Pesquisa Integrada.

    Captura de tela da ativação do fluxo de gatilho da API de Pesquisa Integrada.

Adicionar provedores de pesquisa integrada

  1. No Centro de administração do Customer Service, em Experiências, selecione Conhecimento.

  2. Na página Conhecimento, na seção Provedores de pesquisa integrada, selecione Gerenciar.

  3. Selecione Novo.

  4. Na seção Informações do provedor:

    • Nome do provedor de pesquisa: insira o Nome do provedor de pesquisa.
    • Descrição: insira a descrição do provedor de pesquisa externo.
    • Marque a caixa de seleção de autorização.

  5. Selecione Avançar.

  6. Na seção Autenticação e testes, verifique e insira o seguinte:

    • URL raiz: insira a URL raiz do site do provedor de pesquisa, inclusive o protocolo. Por exemplo, em https://contoso.com/about, a URL raiz é: https://contoso.com/.

    • URL do mapa do site: para obter a URL do mapa de um site, adicione /robots.txt na barra de endereços. Por exemplo, https://contoso.com/robots.txt.

      Observação

      • O mapa do site que você fornecer deverá ter a marca lastmod na marca da URL do artigo.
      • O mapa do site e os arquivos de índice do site devem ter o tipo de conteúdo como aplicativo/xml ou texto/xml.
      • Você deve fornecer sites estáticos somente para a ingestão de dados. Não há suporte aos sites que retornam scripts para carregar conteúdo para a ingestão de dados.
      • Somente uma combinação única de URL raiz, URL do mapa do site e filtros de idioma é permitida.

    • Filtro de idioma para ingestão: selecione os idiomas que você deseja mapear para a ingestão. Selecione Redefinir para desmarcar a seleção. Por padrão, todos os idiomas são considerados para a ingestão. Se aplicar filtros de idioma, você deverá manter o mapeamento para o código do idioma.

  7. Selecione Avançar.

  8. Na seção Esquema do artigo de conhecimento, selecione Mapeamento de Campos ou Esquema JSON.

    Você não poderá alterar o método de configuração depois de salvá-lo. Saiba mais sobre o mapeamento de esquema do artigo de conhecimento.

  9. Na seção Agendar Atualização, especifique os intervalos de atualização:

    • Frequência de atualização: selecione um valor na lista para especificar a frequência na qual artigos novos ou atualizados são ingeridos do provedor de pesquisa. Para pausar a ingestão, selecione Sem atualização.

    • Período de retrospectiva: selecione um valor na lista para especificar um período adicional durante o qual os artigos devem ser ingeridos que podem ter sido perdidos durante a ingestão inicial.

      Por exemplo, se você definir a frequência de atualização em 15 minutos e o período de retrospectiva em duas horas, os dados serão atualizados para as últimas duas horas e 15 minutos, a cada 15 minutos.

  10. Selecione Avançar.

  11. Na seção Resumo, revise as informações inseridas e faça todas as alterações necessárias.

  12. Selecione Salvar e fechar.

    O novo provedor de pesquisa é exibido na página Conhecimento>Todos os provedores de pesquisa integrada. O status é Inativo com razão do status Validado.

    Se você precisar adicionar mais informações, selecione Salvar como rascunho. O status é Inativo com razão do status Rascunho.

Executar processamento para provedores de pesquisa

Dependendo do status do provedor de pesquisa, execute uma ingestão com base no intervalo de tempo ou de avaliação. Ao iniciar uma ingestão de avaliação, você pode identificar e corrigir eventuais erros. Exiba o status da ingestão na guia Insights da coluna Falhas de rastreamento.

Você não pode executar a ingestão para provedores de pesquisa que estejam Inativos com razão do status Rascunho.

Ingestão de avaliação

Se o provedor de pesquisa estiver Inativo com razão do status Validado, você poderá executar uma ingestão de avaliação.

  1. Na página Conhecimento>Todos os provedores de pesquisa integrada, selecione o provedor de pesquisa.
  2. Selecione Executar ingestão.
  3. Selecione Ingestão de Avaliação.
  4. Especifique o número de artigos a serem ingeridos na lista N° de registros. O número máximo de artigos que você selecionar é 1.000.

Verifique a guia Insights em busca de erros. Se você não vir nenhum e quiser executar uma ingestão baseada em intervalo de tempo, ative o provedor de pesquisa primeiro.

Ingestão baseada em intervalo de tempo

Se o provedor de pesquisa estiver Ativo com razão do status Pronto para Ingestão, inicie uma ingestão baseada em intervalo de tempo.

  1. Na página Conhecimento>Todos os provedores de pesquisa integrada, selecione o provedor de pesquisa.
  2. Selecione Executar ingestão.
  3. Selecione Ingestão baseada em intervalo de tempo.
  4. Especifique o intervalo de datas a partir do qual os artigos atualizados para ingestão devem ser selecionados. O intervalo de datas deve ser de 60 dias a partir da data Início .

Ativar provedores de pesquisa

Quando você ativa um provedor de pesquisa, artigos novos e atualizados começam a serem ingeridos pelo provedor e os artigos começam a ser exibidos nos resultados da pesquisa.

  1. No Centro de administração do Customer Service, em Experiências, selecione Conhecimento.
  2. Na página Conhecimento, na seção Provedores de pesquisa integrada, selecione Gerenciar.
  3. Na lista Provedores de pesquisa inativos, selecione um provedor de pesquisa e selecione Ativar.
  4. Selecione Ativar novamente para confirmar que você deseja ativar o provedor de pesquisa.

Editar provedores de pesquisa

Quando você editar um provedor de pesquisa, as alterações entrarão em vigor na próxima ingestão.

  1. No Centro de administração do Customer Service, em Experiências, selecione Conhecimento.
  2. Na página Conhecimento, na seção Provedores de pesquisa integrada, selecione Gerenciar.
  3. Selecione Provedores de pesquisa integrada ativos ou Provedores de pesquisa integrada inativos na lista Todos os provedores de pesquisa integrada e, em seguida, selecione o provedor de pesquisa no qual você deseja fazer alterações.
  4. Selecione Editar.
  5. Na página Detalhes do provedor de pesquisa, selecione a guia na qual você deseja fazer alterações.
  6. Edite as informações conforme necessário.
  7. Selecione Salvar e Fechar.

Desativar provedores de pesquisa

Quando você desativa um provedor de pesquisa, a ingestão de artigos novos e atualizados do provedor de pesquisa é interrompida. Os artigos que já foram ingeridos deixam ser exibidos nos resultados da pesquisa.

  1. No Centro de administração do Customer Service, em Experiências, selecione Conhecimento.
  2. Na página Conhecimento, na seção Provedores de pesquisa integrada, selecione Gerenciar.
  3. Na lista Provedores de pesquisa ativos, selecione um provedor de pesquisa.
  4. Selecione Desativar.
  5. Selecione Desativar novamente para confirmar que você deseja desativar o provedor de pesquisa.

Configurar provedores de pesquisa como filtros de pesquisa

Configure provedores de pesquisa como filtros para pesquisar artigos de conhecimento apenas de provedores de dados selecionados. O filtro só funciona se você tiver a Pesquisa do Dataverse habilitada.

Observação

Se você tiver uma camada personalizada no modo de exibição Localização Rápida dos Artigos de Conhecimento, adicione msdyn_integratedsearchproviderid em Exibir colunas e Encontrar colunas para evitar que os artigos sejam exibidos em resultados da pesquisa.

  1. No Centro de administração do Customer Service, em Experiências, selecione Conhecimento.
  2. Na seção Filtros, verifique se Habilitar filtros de pesquisa está definido como Sim.
  3. Na lista Selecione o tipo de filtro, selecione ID do Provedor de Dados da Pesquisa Integrada e Adicionar.
  4. Selecione o ícone de Pesquisa.
  5. Selecione o provedor de pesquisa e, em seguida, selecione Adicionar.
  6. Como opção, para definir provedores de pesquisa predeterminados a serem exibidos para agentes por padrão, alterne Definir como filtro pré-selecionado para Sim.

Se você selecionar um provedor de pesquisa de dados desativado, ele poderá ser exibido na lista Filtrar por, mas nenhum resultado de pesquisa do provedor selecionado será retornado.

Verificar site do provedor de pesquisa

É necessário verificar se o site do provedor de pesquisa que você deseja usar tem a coleção do mapa do site indicada. Para isso, você deve identificar a raiz e a URL do mapa do site.

  • URL raiz: insira a URL raiz do site do provedor de pesquisa, inclusive o protocolo. Por exemplo, em https://contoso.com/about, a URL raiz é: https://contoso.com/.

  • URL do mapa do site: para obter a URL do mapa de um site, adicione /robots.txt na barra de endereços. Por exemplo, https://contoso.com/robots.txt. Para obter a coleção do mapa do site necessário do arquivo robots.txt, verifique se o link do mapa do site selecionado tem sitemapindex; por exemplo: "https://contoso.com/_sitemaps/sitemapindex.xml".

    A captura de tela mostra um exemplo do arquivo robots.txt.

Próximas etapas

Exibir e usar insights para provedores de pesquisa
Pesquisar artigos da base de conhecimento