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 |
Marquer un champ comme Notez que le fait de marquer un champ comme |
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 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 |
| Correspondance de préfixe (Preview) |
Permet de faire correspondre les préfixes des champs de texte à l'aide de l'opérateur 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, |
| Partiellement associable (aperçu) |
Permet la mise en correspondance de chaînes partielles sur les champs de texte à l'aide de l'opérateur 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 |
| 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 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 |
Dans un data store de films, vous définissez le champ |
| 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 :
|
| 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 :
Dans la console Google Cloud , accédez à la page Applications d'IA.
Cliquez sur le nom de l'application que vous souhaitez modifier.
Cliquez sur Data (Données).
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.
Cliquez sur Modifier.
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.
Cliquez sur Enregistrer pour appliquer les modifications.
Pondérer les champs de recherche (preview)
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.
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.
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
summaryest défini sur une pondération supérieure à la normale et le champurisur une pondération inférieure. Si vous souhaitez rétablir la valeur par défaut d'une pondération, définissez-la surdefault.Les valeurs autorisées pour le paramètre de pondération sont les suivantes :
very_lowlowdefaulthighvery_high
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.
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.
Suivez les instructions pour mettre à jour le schéma de manière programmatique. Définissez les paramètres de correspondance sur
truedans 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
zoneest 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 champregionest défini pour être partiellement mis en correspondance.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).
Minuscules : tous les caractères sont convertis en minuscules. La correspondance n'est alors pas sensible à la casse.
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 exempleasia,australiaouafrica.Préfixes partiels :
STARTS_WITH("asia-south")correspond à la fois àasia-south1-aet à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 deasia-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 tokenisesupport+tier1@example.comensupport,tier1,example,com,support+tier1@example.cometsupport@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 deCONTAINS("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 champ25-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 queCONTAINS("support"),CONTAINS("example.com")ouCONTAINS("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 erreurINVALID_ARGUMENTlorsque vous appliquez un correctif au schéma. saytCompatiblen'est valide que pour les champs de typestring. Si vous le définissez sur les champsnumber,integer,boolean,objectoudatetime, l'API renvoie une erreurINVALID_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 :
Si vous ne disposez pas encore de votre schéma, suivez les instructions pour l'obtenir dans Afficher une définition de schéma.
Suivez les instructions pour mettre à jour le schéma de manière programmatique. Définissez
saytCompatiblesurtruepour 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
titleetchannel_namesont tous deux marqués commesaytCompatible. La définition desaytCompatiblesur un champ dont le type n'est passtringrenvoie une erreurINVALID_ARGUMENTde l'API, tout comme sa définition sur plus de trois champs du schéma.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 :
Appelez la méthode de recherche sur votre configuration de diffusion, comme décrit dans Obtenir des résultats de recherche.
Dans le corps de la requête, définissez
searchAsYouTypeSpec.conditionsurENABLED. Cela permet d'activer l'affichage instantané des résultats pour la requête.Facultatif : Dans le même
searchAsYouTypeSpec, limitez la recherche instantanée à un sous-ensemble des champssaytCompatibledu 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 passaytCompatiblene 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 est1.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.
Envoyez la requête. L'exemple suivant montre la forme d'un
searchAsYouTypeSpecqui 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
- Mettre à jour un schéma pour des données structurées
- Configurer les résultats de recherche
- Afficher les résultats de recherche