Configurez Recherche IA pour prétraiter les entrées contextuelles afin que Actions recommandées les résultats de la recherche soient filtrés dynamiquement en fonction du contexte d’enregistrement actuel.
Avant de commencer
Rôle requis : admin
Pourquoi et quand exécuter cette tâche
Lorsque des résultats de recherche sont générés dans Actions recommandées, vous pouvez les rendre contextuellement pertinents pour l’enregistrement actuel en utilisant les informations contextuelles transmises dans la charge utile de contexte supplémentaire de l’API Recherche IA. À l’aide de ces informations contextuelles, vous pouvez implémenter une logique de prétraitement via le point d’extension AisDynamicFilter pour filtrer les résultats de recherche en fonction des conditions qui correspondent à l’enregistrement de contexte actuel.
Lorsque le prétraitement est implémenté, Recherche IA prend en compte les conditions de filtre définies avant de renvoyer les résultats de recherche, garantissant que seuls les résultats correspondant à ces conditions sont affichés. Par exemple, vous pouvez définir une condition de filtre pour exclure l’enregistrement de contexte actuel des résultats de recherche, afin que l’enregistrement sur lequel vous travaillez n’apparaisse pas dans les recommandations.
Procédure
-
Activez le filtrage dynamique pour une source de recherche spécifique dans un profil de recherche.
-
Accédez à la .
-
Sélectionnez une source de recherche de votre choix dans la liste connexe Sources de recherche.
-
Dans la source de recherche sélectionnée, cochez la case A des filtres dynamiques et sélectionnez Enregistrer.
Remarque : Il peut y avoir plusieurs profils de recherche dans votre instance. Activez le filtrage contextuel uniquement pour les sources de recherche d’un profil où vous avez besoin de cette fonctionnalité. Pour plus d’informations sur le formulaire Source de recherche, voir
Formulaire Source de recherche.
-
Créez l’implémentation AisDynamicFilter pour les sources de recherche.
-
Accédez à la .
-
Ouvrez le point d’extension AisDynamicFilter .
-
Créez une implémentation en sélectionnant le lien Créer une implémentation .
Dans la mise en œuvre :
isApplicable : cette méthode définit les conditions qui déterminent si les filtres dynamiques doivent être applicables ou non à une source de recherche donnée. Utilisez le JSON stringified additionalContext avec le format suivant dans la mise en œuvre. Il définit les informations contextuelles transmises à l’API Recherche IA qui est utilisée dans les filtres dynamiques Recherche IA pour filtrer contextuellement les résultats de la recherche.getFilterCondition : utilisez cette méthode pour définir les critères de filtre que Recherche IA applique aux résultats de recherche pendant le prétraitement.
Remarque : N’implémentez pas la méthode shouldRemoveDocument .
Exemple : Voici un exemple d’implémentation de la façon d’exclure l’enregistrement de contexte actuel des résultats de recherche :
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) {
},
Les paramètres de l’additionalContext précédent sont définis comme suit :
contextRecordId : ID système de l’enregistrement de contexte actuel où les recommandations sont affichées.contextRecordTable : nom de la table de l’enregistrement de contexte actuel où les recommandations sont affichées.contextualInputs : entrées vers l’enregistrement de contexte.source : origine de la demande de recherche qui est prédéfinie comme Actions recommandées. Cela vous permet d’appliquer vos conditions de filtre spécifiquement aux actions recommandées, de sorte que la logique de filtrage ne s’applique pas à d’autres contextes de recherche.
Résultats
Dans l’onglet Rechercher du panneau latéral contextuel, Actions recommandées seuls les résultats de recherche qui correspondent exactement au contexte de l’enregistrement actuel s’affichent.