Configurer les paramètres de champs

Cette page vous explique comment configurer les champs de schéma pour configurer une application pour des données structurées, des données non structurées avec des métadonnées ou des données de site Web avec des attributs structurés personnalisés.

Les paramètres de champ permettent de déterminer comment Agent Search utilise les champs dans ses résultats. Vous pouvez utiliser l'onglet Schéma de la consoleGoogle Cloud pour configurer les paramètres des champs.

La configuration des paramètres de champ n'est disponible que pour les applications dont les datastores contiennent des données structurées ou des données non structurées avec des métadonnées.

Paramètres de champ

Les paramètres de champ suivants sont disponibles pour de nombreux types de champs dans vos données de recherche ou de recommandations, mais pas pour tous les types de données. Un schéma contient plusieurs paramètres de champ pour des champs individuels, et le tableau suivant contient les paramètres qui peuvent être appliqués à un champ dans un schéma. Nous vous recommandons vivement d'utiliser des données structurées pour les paramètres de champ suivants :

Paramètre Définition Objectif Exemple de cas d'utilisation
Indexable

La définition de champs comme indexables permet d'effectuer des opérations telles que le filtrage, le boosting et l'utilisation d'attributs sur des champs structurés dans un document.

Les champs de type Object ne peuvent pas être définis sur Indexable.

Marquer un champ comme Indexable permet d'accélérer les recherches.

Notez que le fait de marquer un champ comme Indexable augmente la taille de l'index de recherche et peut ralentir l'indexation.

Dans un data store d'hôtel, vous pouvez définir un champ, tel que hotel_chain, comme indexable. Cela vous permet d'appliquer des opérations de classement, de filtrage et de boosting sur hotel_chain. Par exemple, vous pouvez appliquer un filtre pour que la recherche ne renvoie que les résultats de recherche contenant la chaîne d'hôtels filtrée.
Inclus dans l'index de recherche

Les champs les plus susceptibles d'être liés aux recherches sont désignés par Searchable. Un champ peut être consultable sans être indexable ni récupérable.

Seuls les champs contenant des valeurs textuelles peuvent être marqués comme inclus dans l'index de recherche. Ainsi, un champ de prix numérique peut être indexable (pour le filtrage ou la facette), mais ne peut pas être inclus dans l'index de recherche en tant que texte intégral.

Définir un champ sur Inclus dans l'index de recherche améliore le rappel pour ce champ dans les requêtes de recherche, ce qui permet aux utilisateurs de trouver du contenu, comme des pages Web, en interrogeant le texte de ces champs. Le fait de marquer un champ comme inclus dans l'index de recherche permet d'appliquer un classement. Par conséquent, marquer un nombre excessif de champs comme consultables peut avoir un impact négatif sur la précision de la recherche en saturant l'algorithme de classement et en renvoyant trop de résultats. Cela peut entraîner des résultats de recherche non pertinents.

Vous pouvez appliquer une pondération relative aux champs de recherche. Toutefois, en raison de valeurs par défaut robustes, cela est rarement nécessaire. Consultez la section Champs de poids pouvant faire l'objet d'une recherche ci-dessous.

Le système de demandes d'assistance d'un fournisseur d'accès à Internet stocke chaque demande sous la forme d'un document structuré. Si ces documents contiennent des champs de texte interrogeables, tels que issue_description ou resolution_notes, un agent d'assistance peut effectuer une requête liée au contenu de ces champs, par exemple comment résoudre les problèmes de débit Internet lent après la réinitialisation du modem. Le système affiche alors les documents contenant l'un de ces termes de recherche, y compris modem, internet, speed, dans l'un des champs issue_description ou resolution_notes, ou dans les deux.

Correspondance de préfixe
(Preview)

Permet de faire correspondre les préfixes des champs de texte à l'aide de l'opérateur STARTS_WITH dans les expressions de filtre. Seuls les champs de type String ou String Array peuvent être définis comme "Correspondance de préfixe possible".

Pour en savoir plus, consultez la section Rendre les champs disponibles pour la correspondance de préfixe et la correspondance partielle ci-dessous.

La définition d'un champ sur "Correspondance de préfixe" permet au moteur de recherche de faire correspondre les chaînes de requête qui sont des préfixes de la valeur du champ. Cela est particulièrement utile pour faire correspondre des identifiants, des chemins d'accès ou des codes hiérarchiques dont le début de la chaîne est connu. La correspondance de préfixe est limitée aux 12 premiers caractères de la valeur de champ normalisée et augmente la taille de l'index de recherche. Vous ne pouvez pas définir plus de 10 champs comme pouvant être mis en correspondance par préfixe.

Vous disposez d'un champ, ticket_id, qui utilise un format tel que <country-code><city-code><number>. Il peut par exemple s'agir de UKLON100, UKMAN100, UKMAN101 et USNY200. Pour trouver tous les billets au départ de Manchester (Royaume-Uni), vous pouvez définir le champ ticket_id comme pouvant être mis en correspondance avec un préfixe, puis utiliser le filtre ticket_id: STARTS_WITH("UKMAN"), qui renvoie UKMAN100 et UKMAN101.

Partiellement associable
(aperçu)

Permet la mise en correspondance de chaînes partielles sur les champs de texte à l'aide de l'opérateur CONTAINS dans les expressions de filtre. Seuls les champs de type String ou String Array peuvent être définis comme partiellement correspondants.

Pour en savoir plus, consultez la section Rendre les champs disponibles pour la correspondance de préfixe et la correspondance partielle ci-dessous.

Définir un champ comme partiellement mis en correspondance permet d'activer la correspondance basée sur des jetons dans un champ, ce qui permet aux utilisateurs de trouver du contenu lorsque seule une partie de la valeur du champ est connue. Le moteur de recherche met en correspondance les jetons de requête avec les jetons de la valeur du champ, quel que soit leur ordre. Notez que le fait de marquer un champ comme partiellement mis en correspondance augmente la taille de l'index de recherche. Vous ne pouvez pas définir plus de 10 champs comme partiellement correspondants.

Vous souhaitez filtrer les régions d'Europe. Les noms region incluent Central Europe et Eastern Europe. Si votre filtre est region: ANY("Europe"), vous n'obtiendrez aucune correspondance. Toutefois, si le champ region est défini comme partiellement mis en correspondance, vous pouvez filtrer avec region: CONTAINS("Europe") et obtenir des correspondances pour Central Europe et Eastern Europe.

Compatible avec la recherche instantanée
(Preview)

Marque un champ de texte comme utilisable par la recherche instantanée : à mesure que l'utilisateur saisit du texte, les documents sont renvoyés si la valeur du champ contient un jeton commençant par le texte de la requête, et l'ensemble de résultats est reclassé à chaque frappe.

Seuls les champs de type String ou String Array peuvent être définis comme compatibles avec la recherche instantanée. Vous ne pouvez pas définir plus de trois champs par schéma comme compatibles avec la recherche instantanée.

Pour en savoir plus, consultez la section Rendre les champs disponibles pour la recherche instantanée ci-dessous.

La définition d'un champ sur saytCompatible permet aux utilisateurs de recevoir un ensemble actualisé de documents classés à chaque frappe, avant qu'ils ne finissent de saisir une requête complète. Appliquez ce paramètre lorsque vous vous attendez à ce que les utilisateurs parcourent une liste de résultats mise à jour au fur et à mesure de leur saisie, par exemple pour des recherches dans un catalogue ou une navigation de longue traîne où l'utilisateur reconnaît le bon résultat au milieu de la requête plutôt que de le saisir en entier. Cela diffère de la saisie semi-automatique, qui suggère des chaînes de requête. La recherche instantanée renvoie des documents classés qui correspondent à la requête partielle.

Dans un data store de films, vous définissez le champ title sur saytCompatible. Lorsqu'un utilisateur saisit b, les résultats de recherche incluent de manière dynamique Batman Begins, Batman Returns et Bats, classés en fonction de la requête de l'utilisateur. Lorsque l'utilisateur étend la requête à bat, les trois mêmes documents restent dans l'ensemble de résultats, reclassés pour le préfixe plus long. Si vous étendez la requête à batm, Bats est supprimé, car le premier jeton de son titre ne commence pas par batm. Seuls Batman Begins et Batman Returns sont conservés, et ils sont à nouveau reclassés.

Ajout d'attributs dynamique Fournit des filtres contextuels pour mieux cibler les recherches des utilisateurs. La définition d'un champ sur Dynamic Facetable permet au système de générer automatiquement des filtres interactifs (facettes) en fonction des valeurs uniques présentes dans le champ. Définir un champ sur Dynamic facetable permet aux utilisateurs d'affiner dynamiquement les résultats de recherche en sélectionnant des catégories ou des attributs directement dérivés de vos données ingérées, sans avoir à prédéfinir manuellement toutes les options de filtre possibles. Cela permet à l'utilisateur d'affiner sa recherche pour trouver un contenu Web très spécifique.
Utilisez Dynamic Facetable avec Searchable pour obtenir de meilleurs résultats, ce qui améliore à la fois le rappel de votre recherche et la qualité des facettes proposées à l'utilisateur.
Les pages d'une base de connaissances interne de l'entreprise, telles que les règles RH, sont ingérées avec des données telles que department, document_type ou last_modified_date. Si ces champs sont tagués comme dynamic facetable, une recherche d'employé pour un terme tel que remboursement des frais génère dynamiquement des filtres interactifs en fonction des résultats pertinents trouvés. Dans ce cas, l'interface Web peut afficher des facettes pour Service : Finance, Voyages, Type de document : Règlement, Questions fréquentes ou Date de dernière modification : ce trimestre, l'année dernière.
Récupérable Lorsqu'une requête de recherche correspond à un contenu, le moteur de recherche peut extraire les valeurs des champs récupérables pour les afficher ou les utiliser dans l'application. Cela signifie que les informations du document d'origine sont affichées dans les résultats de recherche. Les champs de clé (identifiants uniques des documents) sont configurés comme récupérables. Les champs récupérables fournissent un contexte de recherche en distinguant les champs dont les valeurs peuvent être affichées de ceux qui ne doivent être utilisés que dans la logique de recherche, mais dont les valeurs brutes ne sont pas destinées à être présentées à l'utilisateur. Pour une recherche de produits sur un site marchand, product_id, name, price et image_url sont des champs types que vous souhaitez définir comme récupérables. En revanche, internal_tracking_code peut être indexé et filtrable à des fins administratives uniquement, mais pas récupérable dans les résultats de recherche publics.
À compléter Permet d'utiliser le contenu d'un champ pour les suggestions de requête de recherche. Pour en savoir plus, consultez Configurer la saisie semi-automatique.

Ce paramètre permet d'utiliser les valeurs de ce champ pour fournir des suggestions de requêtes en temps réel à mesure que les utilisateurs saisissent du texte. Cette fonctionnalité permet de guider vos utilisateurs vers des contenus pertinents et d'accélérer le processus de recherche. Certains facteurs, tels que l'utilisation du filtrage en langage naturel, peuvent avoir un impact sur ces performances.

Si le champ completable est défini pour product_name, brand et category, lorsque l'utilisateur saisit Tech, les suggestions de saisie automatique peuvent afficher :
  • TechCo (du champ brand)
  • TechCo UltraBook X1 (du champ product_name)
  • Technologie GameMaster Pro (un autre produit du champ category)
Filtrage possible Permet aux recommandations d'utiliser un champ pour filtrer les résultats recommandés, en déterminant les résultats de recherche que vos utilisateurs voient. Pour en savoir plus sur le filtrage des recommandations, consultez Filtrer les recommandations. Définir un champ sur Filterable permet de personnaliser les recommandations pour les utilisateurs. Notez que des limites de filtrage s'appliquent. Un paramètre de filtre par langue et par genre pourrait ressembler à ceci : language_code: ANY("en", "fr") OR categories: ANY("drama").

Différences entre les paramètres couramment utilisés

Il existe des différences clés entre les paramètres de champ "indexable", "inclus dans l'index de recherche" et "récupérable". Le tableau récapitule ces différences.

Fonctionnalité Indexable Inclus dans l'index de recherche Récupérable
Rôle principal Rend le contenu du champ disponible pour le moteur de recherche Permet d'interroger le contenu d'un champ en texte intégral Permet de renvoyer la valeur du champ dans les résultats de recherche
Analyse Le contenu est traité et placé dans un index. Il fait généralement l'objet d'une analyse lexicale approfondie. La valeur est stockée telle quelle pour l'affichage.
Est-ce que ça pourrait être...
...Inclus dans l'index de recherche ? Oui (souvent un prérequis) ND Pas nécessairement (un élément peut être récupérable sans être inclus dans l'index de recherche)
...Récupérable ? Pas nécessairement Pas nécessairement ND
...Filtrable/Triable/Ajout d'attributs ? Oui (généralement un prérequis pour ceux-ci également) Pas directement. Il s'agit d'attributs distincts, souvent basés sur un champ indexable. Pas directement. Ces attributs concernent la façon dont le champ est indexé et interrogé, et pas seulement affiché.

En pratique, de nombreux champs essentiels à l'expérience utilisateur (tels que les titres, les descriptions et les informations permettant d'identifier l'utilisateur) sont souvent définis sur indexable, searchable et retrievable.

Limites

Les paramètres de champ présentent les limites suivantes :

  • Vous pouvez configurer jusqu'à 50 champs comme indexables, inclus dans l'index de recherche, récupérables ou avec ajout d'attributs dynamique.
  • Pour configurer un champ comme facettable de manière dynamique, il doit d'abord être configuré comme indexable.
  • La modification du paramètre d'indexation nécessite une réindexation des données, ce qui peut prendre des heures, en particulier pour les grands datastores.

Si vous configurez des champs pour une application de recherche multimédia et que vous souhaitez obtenir des informations détaillées sur les champs du schéma, consultez À propos des documents et des datastores multimédias.

Mettre à jour les paramètres de champs

Pour modifier les paramètres d'un champ :

  1. Dans la console Google Cloud , accédez à la page Applications d'IA.

    AI Applications

  2. Cliquez sur le nom de l'application que vous souhaitez modifier.

  3. Cliquez sur Data (Données).

  4. Cliquez sur l'onglet Schéma. Cet onglet affiche les paramètres actuels des champs.

    L'onglet Schéma ne s'affiche pas si votre data store contient des données de site Web de base ou des données non structurées sans métadonnées.

  5. Cliquez sur Modifier.

  6. Sélectionnez ou désélectionnez les paramètres de champ que vous devez mettre à jour. Certains paramètres de champ ne sont pas acceptés. Par exemple, les champs numériques ne peuvent pas être définis sur Recherchable.

  7. Cliquez sur Enregistrer pour appliquer les modifications.

Si vous marquez un champ comme pouvant faire l'objet d'une recherche, vous pouvez spécifier une pondération pour indiquer son importance relative dans les résultats de recherche. Dans la plupart des cas, vous n'avez pas besoin de spécifier de pondérations pour les champs individuels, car les pondérations par défaut fonctionnent bien.

Toutefois, il peut être nécessaire d'ajuster les pondérations dans certaines situations, par exemple :

  • Vous migrez des données depuis une plate-forme de recherche existante qui utilise déjà des champs pondérés.

  • Lorsque les pondérations par défaut ne fournissent pas de résultats de recherche satisfaisants. Plus précisément, cela peut se produire lorsque vous disposez de nombreux champs de recherche et que certains sont nettement plus importants que d'autres.

    Le résumé est peut-être le champ le plus important pour les recherches. Vous souhaitez donc donner la priorité à ce texte.

    Il est également possible que le schéma comporte un champ contenant des mots clés très pertinents qui sont d'excellents prédicteurs pour les résultats de recherche, mais comme ce champ est beaucoup plus court que les autres, son influence est souvent éclipsée par des champs plus longs. En augmentant sa pondération, vous vous assurez qu'il a l'impact souhaité.

Niveaux de poids

Les pondérations sont réparties selon les niveaux suivants :

Importance du champ Explication
Très faible Une valeur faible que le système prend toujours en compte lorsqu'il combine les scores de tous les champs. Si vous souhaitez que le poids soit encore plus faible, de sorte que l'effet soit négligeable, ne marquez pas le champ comme consultable.
Faible Une pondération inférieure à la valeur par défaut.
Par défaut Pondération standard pour les champs de recherche. Cette pondération offre des performances raisonnablement bonnes dans la plupart des cas.
Élevé Une graisse nettement plus élevée que la valeur par défaut.
Très élevé Un poids dominant. En général, vous réservez cette option pour un seul champ au maximum.

Mise à jour du schéma et réindexation

L'ajout de pondérations aux champs de recherche nécessite une mise à jour du schéma et une réindexation ultérieure des données dans le data store. La mise à jour du schéma prend des heures, et il n'existe pas d'indicateur fiable pour vous indiquer quand l'indexation est terminée. Vous devez donc surestimer le temps d'indexation.

Définir des niveaux de pondération sur les champs

La définition des niveaux de pondération des champs peut être fastidieuse, car vous ne devez apporter que de petites modifications et examiner attentivement les résultats de recherche par la suite pour vérifier qu'il n'y a pas de conséquences inattendues. Après chaque modification, vous devez attendre que la réindexation soit terminée avant de pouvoir évaluer l'impact de la modification.

Vous ne pouvez configurer la pondération des champs de recherche que via l'API. Cette fonctionnalité n'est pas disponible dans la console Google Cloud .

Pour définir des pondérations, vous devez mettre à jour le schéma du data store à l'aide de la méthode d'API projects.locations.dataStores.schemas.patch.

  1. Si vous ne disposez pas encore de votre schéma, suivez les instructions de la section Afficher une définition de schéma pour l'obtenir.

  2. Suivez les instructions pour mettre à jour le schéma de manière programmatique. Ajoutez des pondérations à un ou plusieurs champs de recherche, comme dans les exemples suivants :

    "summary": {
       "type": "string",
       "searchable": true,
       "weight": "high"
     },
     "uri": {
       "type": "string",
       "searchable": true,
       "weight": "low"
     },
    

    Dans cet exemple, le champ summary est défini sur une pondération supérieure à la normale et le champ uri sur une pondération inférieure. Si vous souhaitez rétablir la valeur par défaut d'une pondération, définissez-la sur default.

    Les valeurs autorisées pour le paramètre de pondération sont les suivantes :

    • very_low
    • low
    • default
    • high
    • very_high
  3. Attendez la fin de la réindexation et testez le comportement de la recherche.

Rendre les champs disponibles pour la correspondance de préfixe et la correspondance partielle (preview)

Pour les champs de type string, vous pouvez modifier le schéma afin de les rendre disponibles pour la correspondance de préfixe ou la correspondance partielle. Cela vous permet d'utiliser STARTS_WITH ou CONTAINS dans les expressions de filtre.

Mise à jour du schéma et réindexation

Pour que les champs soient disponibles pour la correspondance de préfixe ou partielle, vous devez mettre à jour le schéma, puis réindexer les données dans le data store. La mise à jour du schéma prend des heures, et il n'existe pas d'indicateur fiable pour vous indiquer quand l'indexation est terminée. Vous devez donc surestimer le temps d'indexation.

Mettre à jour le schéma pour la correspondance de préfixe et la correspondance partielle

Pour spécifier les champs disponibles pour la correspondance de préfixe ou la correspondance partielle, vous devez mettre à jour le schéma du data store à l'aide de la méthode API projects.locations.dataStores.schemas.patch.

  1. Si vous ne disposez pas encore de votre schéma, suivez les instructions de la section Afficher une définition de schéma pour l'obtenir.

  2. Suivez les instructions pour mettre à jour le schéma de manière programmatique. Définissez les paramètres de correspondance sur true dans le schéma, comme dans les exemples suivants :

    "zone": {
       "type": "string",
       "searchable": true,
       "prefixMatchable": true
     },
     "region": {
       "type": "string",
       "searchable": true,
       "partialMatchable": true
     },
     "model": {
       "type": "string",
       "searchable": true,
       "prefixMatchable": true,
       "partialMatchable": true
     },
    

    Dans cet exemple, le champ zone est défini pour correspondre au préfixe. Vous pouvez utiliser jusqu'à 12 caractères, non sensibles à la casse, dans l'expression de filtre pour qu'elle corresponde à la valeur du champ. Le champ region est défini pour être partiellement mis en correspondance.

  3. Attendez la fin de la réindexation.

Détails sur la correspondance de préfixe

La correspondance de préfixe dans Agent Search vous permet de filtrer les résultats selon que la valeur d'un champ commence par une chaîne spécifique ou non. Cette fonctionnalité est optimisée par l'opérateur STARTS_WITH et nécessite que le champ de texte cible soit configuré en tant que prefixMatchable dans le schéma.

Logique de normalisation et de correspondance

Pour optimiser les performances et assurer la cohérence, le système applique un processus de normalisation spécifique à la fois à la valeur du champ (pendant l'indexation) et à la chaîne de requête (pendant la recherche).

  1. Minuscules : tous les caractères sont convertis en minuscules. La correspondance n'est alors pas sensible à la casse.

  2. Troncation à 12 caractères : le système ne prend en compte que les 12 premiers caractères de la chaîne. Tous les caractères au-delà de cette limite sont ignorés pour la correspondance de préfixe.

Fonctionnement

Au moment de l'indexation, pour un champ marqué comme prefixMatchable, le système génère des jetons de préfixe pour les 12 premiers caractères. Pour une valeur telle que asia-south1-c, l'index stocke les jetons pour a, as, asi, asia, asia-, etc., jusqu'au 12e caractère (asia-south1-).

Au moment de la requête, la chaîne fournie à l'opérateur STARTS_WITH est également convertie en minuscules et tronquée à 12 caractères. La requête est ensuite mise en correspondance avec les jetons de préfixe stockés.

Exemples

Les exemples suivants montrent comment la normalisation à 12 caractères affecte les résultats de recherche :

  • Requêtes larges : STARTS_WITH("A") correspond à toute valeur commençant par "a" (non sensible à la casse), par exemple asia, australia ou africa.

  • Préfixes partiels : STARTS_WITH("asia-south") correspond à la fois à asia-south1-a et à asia-southeast1-b, car les deux commencent par la chaîne de 10 caractères spécifiée.

  • Comportement de troncature : étant donné que seuls les 12 premiers caractères sont mis en correspondance, STARTS_WITH("asia-south1-a") correspond à une valeur de champ de asia-south1-c. Cela se produit, car les deux chaînes sont normalisées avec le même préfixe de 12 caractères : asia-south1-.

Détails sur la correspondance partielle

La correspondance partielle dans la recherche d'agent vous permet de filtrer les résultats selon que la valeur d'un champ contient des mots ou des jetons spécifiques. Cette fonctionnalité est optimisée par l'opérateur CONTAINS et nécessite que le champ de texte cible soit configuré en tant que partialMatchable dans le schéma.

Logique de normalisation et de tokenisation

La recherche d'agent normalise et tokenise à la fois la valeur du champ (pendant l'indexation) et la chaîne de requête (pendant la recherche) :

  • Conversion en minuscules : Agent Search convertit les caractères en minuscules. La correspondance n'est alors pas sensible à la casse.

  • Tokenisation : Agent Search divise la chaîne en jetons (mots) individuels en utilisant des espaces et d'autres caractères comme délimiteurs.

    • Délimiteurs standards : les espaces et les signes de ponctuation courants servent de délimiteurs. Il s'agit des traits d'union (-), des barres obliques (/), des virgules (,), des points (.), des astérisques (*), des accolades ({ }), des crochets ([ ]), des parenthèses (( )) et des apostrophes (').

    • Non-délimiteurs : l'esperluette (&) et le trait de soulignement (_) ne font pas office de délimiteurs. Le système traite les caractères joints par ces symboles comme un seul jeton.

    • Délimiteur d'adresse e-mail (@) : le symbole @ sert de délimiteur spécial pour faciliter la reconnaissance des adresses e-mail. Le système génère des jetons pour les composants individuels ainsi que pour les formulaires combinés. Par exemple, il tokenise support+tier1@example.com en support, tier1, example, com, support+tier1@example.com et support@example.com.

Fonctionnement

Au moment de l'indexation, pour un champ marqué comme partialMatchable, le système normalise et segmente la valeur du champ, puis stocke les jetons obtenus dans l'index. Par exemple, il tokenise une valeur de champ de 25-meter, outdoor, swimming pool en [25, meter, outdoor, swimming, pool].

Au moment de la requête, la chaîne fournie à l'opérateur CONTAINS subit le même processus de normalisation et de tokenisation. Le moteur de recherche vérifie ensuite que tous les jetons de requête obtenus correspondent aux jetons stockés pour le champ. L'ordre des jetons n'a aucune incidence.

Exemples

Les exemples suivants montrent comment la tokenisation affecte les résultats de correspondance partielle :

  • Correspondance de jeton de base : si la valeur du champ est 25-meter, outdoor, swimming pool, un filtre de CONTAINS("Outdoor pool") correspond. Le système segmente la requête en [outdoor, pool], qui existent tous deux dans les jetons du champ.

  • Indépendance de l'ordre : un filtre de CONTAINS("pool outdoor") correspond également à la valeur de champ 25-meter, outdoor, swimming pool, car le système vérifie la présence de chaque jeton indépendamment de leur ordre.

  • Correspondance d'adresse e-mail : si un champ stocke l'adresse e-mail support+tier1@example.com, les filtres tels que CONTAINS("support"), CONTAINS("example.com") ou CONTAINS("support@example.com") correspondent tous correctement en raison de la tokenisation spéciale du symbole @.

Rendre les champs disponibles pour l'affichage instantané des résultats (preview)

Pour les champs de type string, vous pouvez modifier le schéma pour marquer les champs comme saytCompatible. Lorsqu'un ou plusieurs champs du schéma sont saytCompatible et que votre application active la recherche instantanée dans la requête de recherche, Agent Search renvoie les documents dont les champs saytCompatible contiennent un jeton commençant par le texte de la requête et reclasse ces documents à chaque frappe.

À propos de la recherche instantanée pour les contenus multimédias

La recherche instantanée est une fonctionnalité en disponibilité générale pour les applications multimédias. Consultez Obtenir des résultats de recherche instantanée pour une application multimédia pour en savoir plus sur le champ de requête searchAsYouTypeSpec.condition réservé aux contenus multimédias.

Le paramètre de champ saytCompatible étend la recherche instantanée à n'importe quelle application de recherche en vous permettant de marquer les champs de schéma spécifiques pour répondre aux requêtes partielles. Les applications multimédias peuvent continuer à utiliser searchAsYouTypeSpec.condition comme avant. Les applications non multimédias ont besoin de champs saytCompatible dans le schéma.

Saisie semi-automatique et affichage instantané des résultats

La recherche instantanée est différente de la saisie semi-automatique :

  • La saisie semi-automatique prédit les chaînes de requête et est pilotée par le paramètre de champ completable.
  • La Search-as-you-type renvoie des documents classés et est pilotée par le paramètre de champ saytCompatible.

Les deux fonctionnalités peuvent être utilisées indépendamment ou ensemble, et elles ne partagent pas de données.

Limites

La définition de champs saytCompatible est soumise aux limites suivantes :

  • Vous ne pouvez pas marquer plus de trois champs par schéma comme saytCompatible. Si vous en définissez un quatrième, l'API renvoie une erreur INVALID_ARGUMENT lorsque vous appliquez un correctif au schéma.
  • saytCompatible n'est valide que pour les champs de type string. Si vous le définissez sur les champs number, integer, boolean, object ou datetime, l'API renvoie une erreur INVALID_ARGUMENT.
  • Seuls les 12 premiers jetons de la valeur d'un champ sont indexés, et chaque jeton contribue aux fragments de préfixe jusqu'à ses 10 premiers caractères. Les valeurs plus longues sont toujours indexées, mais la fin n'est pas accessible via un préfixe.

Mise à jour du schéma et réindexation

La définition de champs sur saytCompatible nécessite une mise à jour du schéma et une réindexation ultérieure des données dans le data store. La mise à jour du schéma prend des heures, et il n'existe pas d'indicateur fiable pour vous indiquer quand l'indexation est terminée. Vous devez donc surestimer le temps d'indexation.

Mettre à jour le schéma pour l'affichage instantané des résultats

Pour marquer des champs comme saytCompatible à l'aide de la méthode projects.locations.dataStores.schemas.patch, procédez comme suit :

  1. Si vous ne disposez pas encore de votre schéma, suivez les instructions pour l'obtenir dans Afficher une définition de schéma.

  2. Suivez les instructions pour mettre à jour le schéma de manière programmatique. Définissez saytCompatible sur true pour les champs que vous souhaitez activer pour la fonctionnalité, comme dans cet exemple :

    "title": {
       "type": "string",
       "retrievable": true,
       "saytCompatible": true
     },
     "channel_name": {
       "type": "string",
       "retrievable": true,
       "saytCompatible": true
     },
    

    Dans cet exemple, les champs title et channel_name sont tous deux marqués comme saytCompatible. La définition de saytCompatible sur un champ dont le type n'est pas string renvoie une erreur INVALID_ARGUMENT de l'API, tout comme sa définition sur plus de trois champs du schéma.

  3. Attendez la fin de la réindexation.

Envoyer une requête de recherche instantanée

Une fois la réindexation terminée, activez l'affichage instantané des résultats pour chaque requête de recherche en envoyant une requête de recherche dont le corps inclut searchAsYouTypeSpec. Les champs marqués comme saytCompatible dans le schéma ne sont consultés que lorsque searchAsYouTypeSpec est défini dans la requête. Vous pouvez ainsi conserver la même configuration de diffusion pour les requêtes partielles et complètes.

Pour envoyer une requête de recherche instantanée, procédez comme suit :

  1. Appelez la méthode de recherche sur votre configuration de diffusion, comme décrit dans Obtenir des résultats de recherche.

  2. Dans le corps de la requête, définissez searchAsYouTypeSpec.condition sur ENABLED. Cela permet d'activer l'affichage instantané des résultats pour la requête.

  3. Facultatif : Dans le même searchAsYouTypeSpec, limitez la recherche instantanée à un sous-ensemble des champs saytCompatible du schéma, attribuez à chaque champ une pondération relative et définissez un seuil de score minimal en dessous duquel les documents sont supprimés. Chaque valeur de ce bloc est facultative. Lorsqu'elle est omise, les valeurs par défaut s'appliquent.

    • fields[i].key : champ de schéma marqué saytCompatible. Le référencement d'un champ qui n'est pas saytCompatible ne renvoie aucune contribution de recherche instantanée à partir de ce champ.
    • fields[i].weight : importance relative du champ dans le score de recherche instantanée. La valeur par défaut est 1.0.
    • scoreThreshold : les documents dont le score de recherche instantanée est inférieur à cette valeur sont exclus. Par défaut, aucun seuil n'est défini.
  4. Envoyez la requête. L'exemple suivant montre la forme d'un searchAsYouTypeSpec qui active la recherche instantanée, la limite à deux champs avec des pondérations différentes et définit un score minimal :

    "searchAsYouTypeSpec": {
      "condition": "ENABLED",
      "fields": [
        { "key": "title", "weight": 1.2 },
        { "key": "channel_name" }
      ],
      "scoreThreshold": 0.5
    }
    

Détails sur la recherche instantanée

La recherche instantanée dans la recherche d'agent permet aux utilisateurs de recevoir des documents classés à chaque frappe sur les champs marqués comme saytCompatible dans le schéma.

Logique de normalisation et de tokenisation

La recherche d'agent normalise et tokenise à la fois la valeur du champ (pendant l'indexation) et le texte de la requête (pendant la recherche) :

  • Conversion en minuscules : Agent Search convertit les caractères en minuscules. La correspondance n'est alors pas sensible à la casse.

  • Tokenisation : Agent Search divise la chaîne en jetons (mots) individuels en utilisant des espaces et des signes de ponctuation courants comme délimiteurs, ce qui correspond au comportement utilisé pour la correspondance partielle.

  • Limites par champ : seuls les 12 premiers jetons de la valeur du champ sont indexés pour la recherche instantanée. Chacun de ces jetons fournit des fragments de préfixe jusqu'à ses 10 premiers caractères.

Exemple

Si le champ actor_name est marqué saytCompatible et qu'un document a la valeur Christian Bale, une requête de chr atteint le document via le fragment de préfixe de longueur 3 du jeton christian, et l'extension de la requête à chris correspond toujours au fragment de préfixe de longueur 5. Une requête de bale correspond également, via le fragment de préfixe de longueur 4 du deuxième jeton de la valeur du champ. Les classements sont mis à jour à chaque frappe de l'utilisateur.

Étapes suivantes