OpenSearch:Résumé des résultats de recherche

Les documents étant souvent longs, il est peu pratique d'afficher leur contenu intégral dans les résultats de recherche. Pour y remédier, configurez les résumés et la mise en surbrillance. Le système extrait les segments de texte contenant les termes de la requête, ce qui aide les utilisateurs à déterminer rapidement la pertinence d'un résultat. Personnalisez ces paramètres d'affichage dans la console. Une fois configurés, ils s'appliquent automatiquement à vos requêtes de recherche via l'API. Vous pouvez également remplacer les paramètres de la console pour des requêtes spécifiques en utilisant le paramètre summary lors d'un appel API.

• Field : champ pour lequel générer un résumé.

• Segment length : longueur maximale de chaque segment de résumé.

• Highlight tag : balise HTML utilisée pour mettre les mots-clés en surbrillance.

• Segment connector : chaîne de caractères reliant les segments de résumé.

• Number of segments : nombre maximal de segments à renvoyer.

1. Dans la console, accédez à Feature Extensions > Search Result Display pour configurer le résumé.

2. L'exemple suivant illustre la configuration de la balise de surbrillance.

Dans cet exemple, un résumé est configuré pour le champ title. La longueur du segment est 50, la balise de surbrillance est em, le connecteur de segment est ... et le nombre de segments est 5.

• Paramètre API : spécifiez les paramètres en utilisant le paramètre summary.

• Configuration SDK : l'exemple suivant montre comment configurer le résumé à l'aide du SDK Java :

  // Configure the search result summary. Using the Summary object is a convenient way to add summary settings.
      Summary summ = new Summary("name");
      summ.setSummary_field("name");// The field to which the summary applies. This must be a TEXT field with an analyzer.
      summ.setSummary_len("50");// The segment length.
      summ.setSummary_element("em"); // The highlight tag.
      summ.setSummary_ellipsis("...");// The segment connector.
      summ.setSummary_snippet("1");// The number of segments.
      // Add the Summary object.

  Remarque :

• Vous ne pouvez pas spécifier de préfixes et de suffixes distincts pour une balise de surbrillance dans l'objet summary de la classe SearchParams. Vous devez fournir une balise HTML complète. Par exemple, si vous définissez la balise de surbrillance sur em, le résultat mis en surbrillance dans la réponse JSON pour « Alibaba Cloud OpenSearch product document » sera Alibaba Cloud<em>OpenSearch</em>product document.

• Pour définir des préfixes et des suffixes personnalisés pour une balise de surbrillance dans le SDK, utilisez l'objet SearchParamsBuilder.

  // A utility class for SearchParams that provides more flexible operations.
        SearchParamsBuilder paramsBuilder = SearchParamsBuilder.create(searchParams);
        // Use the SearchParamsBuilder object to add summary settings.
  paramsBuilder.addCustomParam("summary", "summary_field:name,summary_ellipsis:...,summary_snippet:1,summary_len:50,summary_element_prefix:<abc>,summary_element_postfix:</abc>");
       // To specify multiple summary fields, separate them with semicolons (;).

  Points importants

• La mise en surbrillance s'applique uniquement aux termes de votre requête. Le champ configuré pour la surbrillance doit être indexé. Sinon, la mise en surbrillance peut ne pas fonctionner comme prévu.

• Vous devez configurer conjointement les paramètres de résumé et de mise en surbrillance.

• Lorsque vous configurez un résumé pour plusieurs champs, les termes de requête correspondants sont mis en surbrillance dans tous les champs spécifiés.

• Si un terme correspondant apparaît loin dans un document, au-delà d'une limite de 10 000 octets, il n'est pas mis en surbrillance.

• Lors de la mise en surbrillance, tous les chevrons littéraux (< et >) présents dans le texte source sont échappés vers < et > dans la sortie.

• Si vous appliquez différents analyseurs au même champ, tels qu'un analyseur chinois standard et un analyseur monocaractère, la mise en surbrillance peut être incorrecte ou incomplète. Le résumé peut ne faire correspondre les termes que sur la base d'un seul analyseur ou mettre en surbrillance le contenu erroné.

• Si une seule requête utilise deux index ou plus avec des analyseurs différents pour la recherche, la mise en surbrillance peut échouer ou se comporter de manière imprévisible.

• Par défaut, les caractères spéciaux sont filtrés des segments mis en surbrillance. Pour afficher ces caractères, définissez la clause kvpairs sur filter_punc:0 afin de désactiver ce filtrage.

Après avoir recherché le mot-clé friendship, la liste des résultats de recherche affiche un segment de résumé pour chaque entrée, avec le mot-clé correspondant mis en surbrillance. Chaque résultat inclut des champs tels que title, source, author, category, status, word count et rating, ainsi qu'un bouton Start Reading. En haut de la page, vous pouvez également filtrer les résultats par catégorie, nombre de mots et statut, ou trier selon des critères tels que l'heure de mise à jour, le nombre de notes et le nombre d'abonnements.