Configure filtros dinâmicos na Pesquisa com IA para Ações recomendadas

Configure a Pesquisa com IA para pré-processar entradas contextuais de Ações recomendadas para que os resultados da pesquisa sejam filtrados dinamicamente com base no contexto de registro atual.

Antes de Iniciar

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

Quando os resultados da pesquisa são gerados em Ações recomendadas, Você pode torná-los contextualmente relevantes para o registro atual usando as informações contextuais passadas na carga de contexto adicional da API de Pesquisa com IA. Usando essas informações contextuais, você pode implementar a lógica de pré-processamento por meio do Filtro dinâmico ponto de extensão para filtrar os resultados da pesquisa com base em condições que correspondem ao registro de contexto atual.

Quando o pré-processamento é implementado, a Pesquisa com IA considera as condições de filtro definidas antes de retornar os resultados da pesquisa, garantindo que somente os resultados correspondentes a essas condições sejam exibidos. Por exemplo, você pode definir uma condição de filtro para excluir o registro de contexto atual dos resultados da pesquisa, para que o registro no qual você está trabalhando não apareça nas recomendações.

Procedimento

1. Ative a filtragem dinâmica para uma fonte de pesquisa específica em um perfil de pesquisa.
   1. Navegar até Tudo > Pesquisa com IA > Experiência de pesquisa > Perfis de pesquisa.
   2. Selecione uma fonte de pesquisa de sua escolha na lista relacionada Fontes de pesquisa.
2. Na origem de pesquisa selecionada, selecione Tem filtros dinâmicos e selecione Salvar .
   Nota:

   Pode haver vários perfis de pesquisa em sua instância. Ative a filtragem contextual somente para as origens de pesquisa em um perfil em que você precisa dessa funcionalidade. Para obter mais informações sobre o formulário de origem de pesquisa, consulte Formulário de origem de pesquisa .
3. Crie a implementação AisDynamicFilter para fontes de pesquisa.
   1. Navegar até Tudo > Pontos de Extensão do Sistema > Pontos de Extensão com Script.
   2. Abra o. Filtro dinâmico ponto de extensão.
   3. Selecione uma implementação Criar implementação link.
      Na implementação:

      • ÉAplicável : Este método define as condições que determinam se os filtros dinâmicos devem ser aplicáveis a uma determinada fonte de pesquisa ou não. Use o. Contexto adicional JSON estruturado com o seguinte formato na implementação. Ele define as informações contextuais passadas para a API da Pesquisa com IA, que são usadas nos filtros dinâmicos da Pesquisa com IA para filtrar contextualmente os resultados da pesquisa.
      • GetFilterCondition : Use este método para definir os critérios de filtro que a Pesquisa com IA aplica aos resultados da pesquisa durante o pré-processamento.

      Nota:

      Não implemente o. DeveRemoveDocumento método.

      Exemplo: A seguir está um exemplo de implementação de como excluir o registro de contexto atual dos resultados da pesquisa:

      isApplicable: function(searchContextConfigId, profileId, tableName, additionalContext, preprocess) {
              if (additionalContext != null && JSON.parse(additionalContext).source == 'recommended-actions' && tableName == JSON.parse(additionalContext).contextRecordTable && preprocess) {
                  return true;
              }
              return false; 
          },
          getFilterCondition: function(searchContextConfigId, profileId, tableName, additionalContext) {
              if (additionalContext != null && JSON.parse(additionalContext).source == 'recommended-actions' && tableName == JSON.parse(additionalContext).contextRecordTable) {
                  var pasedAdditionalContext = JSON.parse(additionalContext);
                  var gr = new GlideRecord(tableName);
                  gr.addEncodedQuery('sys_id!=' + pasedAdditionalContext.contextRecordId);
                  gr.query();
                  return gr;
              }
      
          }, 
      
          shouldRemoveDocument: function(searchContextConfigId, profileId, recordClass, sysId, additionalContext) {
             
          },

      Os parâmetros no Contexto adicional anterior são definidos como:

      • ContextRecordId SYS ID do registro de contexto atual em que as recomendações são exibidas.
      • ContextRecordTable : Nome da tabela do registro de contexto atual em que as recomendações são exibidas.
      • ContextualInputs : Entradas para o registro de contexto.
      • origem : Origem da solicitação de pesquisa que é predefinida como ações recomendadas. Isso permite que você defina o escopo de suas condições de filtro especificamente para ações recomendadas, para que a lógica de filtragem não se aplique a outros contextos de pesquisa.

Resultado

Na guia Pesquisar do Ações recomendadas painel lateral de contexto, somente os resultados da pesquisa que correspondem ao contexto exato do registro atual são exibidos.