REST Resource: projects.locations.evaluations

Ressource : Evaluation

Une évaluation correspond à une seule exécution (ou exécution) d'un processus d'évaluation. Il encapsule l'état de l'évaluation et les données qui en résultent.

Représentation JSON 
{
  "name": string,
  "evaluationSpec": {
    object (EvaluationSpec)
  },
  "qualityMetrics": {
    object (QualityMetrics)
  },
  "state": enum (State),
  "error": {
    object (Status)
  },
  "createTime": string,
  "endTime": string,
  "errorSamples": [
    {
      object (Status)
    }
  ]
}
Champs
name

string

Identifiant. Nom complet de la ressource Evaluation, au format projects/{project}/locations/{location}/evaluations/{evaluation}.

Ce champ doit être une chaîne encodée au format UTF-8, dont la longueur ne doit pas dépasser 1 024 caractères.
evaluationSpec

object (EvaluationSpec)

Obligatoire. Spécification de l'évaluation.
qualityMetrics

object (QualityMetrics)

Uniquement en sortie. Moyenne des métriques produites par l'évaluation pour tous les SampleQuery dans SampleQuerySet.

Renseigné uniquement lorsque l'état de l'évaluation est "SUCCEEDED".
state

enum (State)

Uniquement en sortie. État de l'évaluation.
error

object (Status)

Uniquement en sortie. Erreur survenue lors de l'évaluation. N'est renseigné que lorsque l'état de l'évaluation est "FAILED" (ÉCHEC).
createTime

string (Timestamp format)

Uniquement en sortie. Code temporel de création de Evaluation.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la fin de l'Evaluation.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
errorSamples[]

object (Status)

Uniquement en sortie. Exemple d'erreurs rencontrées lors du traitement de la demande.

EvaluationSpec

Décrit les spécifications de l'évaluation.

Représentation JSON 
{
  "querySetSpec": {
    object (QuerySetSpec)
  },

  // Union field search_spec can be only one of the following:
  "searchRequest": {
    object (SearchRequest)
  }
  // End of list of possible types for union field search_spec.
}
Champs
querySetSpec

object (QuerySetSpec)

Facultatif. Spécification de l'ensemble de requêtes.
Champ d'union search_spec. Spécification de la recherche. search_spec ne peut être qu'un des éléments suivants :
searchRequest

object (SearchRequest)

Obligatoire. Requête de recherche utilisée pour effectuer l'évaluation.

Seuls les champs suivants de SearchRequest sont acceptés. Si d'autres champs sont fournis, une erreur UNSUPPORTED sera renvoyée :

ImageQuery

Spécifie l'entrée de la requête d'image.

Représentation JSON 
{

  // Union field image can be only one of the following:
  "imageBytes": string
  // End of list of possible types for union field image.
}
Champs

Champ d'union image.

image ne peut être qu'un des éléments suivants :
imageBytes

string

Octets de l'image encodés en base64. Formats d'image acceptés : JPEG, PNG et BMP.

FacetSpec

Spécification d'attribut permettant d'effectuer une recherche par attribut.

Représentation JSON 
{
  "facetKey": {
    object (FacetKey)
  },
  "limit": integer,
  "excludedFilterKeys": [
    string
  ],
  "enableDynamicPosition": boolean
}
Champs
facetKey

object (FacetKey)

Obligatoire. Spécification de la clé de facette.
limit

integer

Nombre maximal de valeurs d'attributs renvoyées pour cet attribut. Si aucune valeur n'est spécifiée, la valeur par défaut est 20. La valeur maximale autorisée est de 300. Les valeurs supérieures à 300 sont réduites à 300. Pour l'agrégation dans la recherche médicale, lorsque [FacetKey.key] est défini sur "healthcare_aggregation_key", la limite est remplacée par 10 000 en interne, quelle que soit la valeur définie ici.

Si ce champ est négatif, une erreur INVALID_ARGUMENT est renvoyée.
excludedFilterKeys[]

string

Liste des clés à exclure lors de la création de facettes.

Par défaut, FacetKey.key n'est pas exclu du filtre, sauf s'il est indiqué dans ce champ.

Si vous indiquez une clé d'attribut dans ce champ, ses valeurs peuvent apparaître en tant que résultats d'attributs, même si elles sont filtrées dans les résultats de recherche. L'utilisation de ce champ n'a aucune incidence sur les résultats de recherche renvoyés.

Par exemple, supposons qu'il existe 100 documents avec l'attribut de couleur "Rouge" et 200 documents avec l'attribut de couleur "Bleu". Une requête contenant le filtre "color:ANY("Red")" et ayant "color" comme FacetKey.key renverrait par défaut uniquement les documents "Rouge" dans les résultats de recherche, ainsi que "Rouge" avec le nombre 100 comme seul attribut de couleur. Bien que des documents bleus soient également disponibles, "Bleu" ne s'affiche pas comme valeur de facette disponible.

Si "color" figure dans "excludedFilterKeys", la requête renvoie les valeurs d'attribut "Red" avec le nombre 100 et "Blue" avec le nombre 200, car la clé "color" est désormais exclue du filtre. Comme ce champ n'affecte pas les résultats de recherche, ils sont toujours correctement filtrés pour ne renvoyer que les documents "Rouge".

Vous ne pouvez pas saisir plus de 100 valeurs. Dans le cas contraire, une erreur INVALID_ARGUMENT est renvoyée.
enableDynamicPosition

boolean

Active la position dynamique pour cet attribut. Si la valeur est "true", la position de cette facette parmi toutes les facettes de la réponse est déterminée automatiquement. Si les facettes dynamiques sont activées, elles sont regroupées. Si la valeur est définie sur "false", la position de cet attribut dans la réponse est la même que dans la requête. Il est classé avant les attributs dont la position dynamique est activée et tous les attributs dynamiques.

Par exemple, vous pouvez toujours vouloir que le facette de note soit renvoyée dans la réponse, mais il n'est pas nécessaire de toujours l'afficher en haut. Dans ce cas, vous pouvez définir enableDynamicPosition sur "true" pour que la position du facette de note dans la réponse soit déterminée automatiquement.

Autre exemple, en supposant que vous ayez les facettes suivantes dans la requête :

  • "rating", enableDynamicPosition = true

  • "price", enableDynamicPosition = false

  • "brands", enableDynamicPosition = false

Vous avez également activé les facettes dynamiques, ce qui génère une facette gender. L'ordre final des facettes dans la réponse peut être ("price", "brands", "rating", "gender") ou ("price", "brands", "gender", "rating"), selon la façon dont l'API ordonne les facettes "gender" et "rating". Toutefois, notez que "price" et "brands" sont toujours classés en première et deuxième positions, car leur propriété enableDynamicPosition est définie sur "false".

FacetKey

Spécifie comment un facette est calculée.

Représentation JSON 
{
  "key": string,
  "intervals": [
    {
      object (Interval)
    }
  ],
  "restrictedValues": [
    string
  ],
  "prefixes": [
    string
  ],
  "contains": [
    string
  ],
  "caseInsensitive": boolean,
  "orderBy": string
}
Champs
key

string

Obligatoire. Clés de facette textuelles et numériques acceptées dans l'objet Document, sur lesquelles les valeurs de facette sont calculées. La clé de facette est sensible à la casse.
intervals[]

object (Interval)

Ne définissez cette option que si les valeurs doivent être réparties dans des intervalles. Doit être défini pour les facettes avec des valeurs numériques. Ne doit pas être défini pour une facette avec des valeurs de texte. Le nombre maximal d'intervalles est de 30.
restrictedValues[]

string

N'obtient la facette que pour les valeurs restreintes spécifiées. (uniquement compatible avec les champs textuels) Par exemple, supposons que "category" comporte trois valeurs : "Action > 2022", "Action > 2021" et "Sci-Fi > 2022". Si vous définissez "restrictedValues" sur "Action > 2022", la facette "category" ne contient que "Action > 2022". (uniquement compatible avec les champs textuels) Le maximum est de 10.
prefixes[]

string

N'obtient que les valeurs de facette qui commencent par le préfixe de chaîne donné. Par exemple, supposons que "category" comporte trois valeurs : "Action > 2022", "Action > 2021" et "Sci-Fi > 2022". Si vous définissez "prefixes" sur "Action", la facette "category" ne contient que "Action > 2022" et "Action > 2021". (uniquement compatible avec les champs textuels) Le maximum est de 10.
contains[]

string

N'obtient que les valeurs de facette contenant les chaînes données. Par exemple, supposons que "category" comporte trois valeurs : "Action > 2022", "Action > 2021" et "Sci-Fi > 2022". Si vous définissez "contient" sur "2022", la facette "category" ne contient que "Action > 2022" et "Sci-Fi > 2022". (uniquement compatible avec les champs textuels) Le maximum est de 10.
caseInsensitive

boolean

"True" pour rendre les clés de facette insensibles à la casse lors de l'obtention des valeurs de facette avec des préfixes ou des valeurs "contains", "false" dans le cas contraire.
orderBy

string

Ordre dans lequel les documents sont renvoyés.

Les valeurs autorisées sont les suivantes :

Si ce champ n'est pas défini, les valeurs textuelles sont triées dans l'ordre naturel, et les intervalles numériques sont triés dans l'ordre indiqué par FacetSpec.FacetKey.intervals.

Intervalle

Intervalle à virgule flottante.

Représentation JSON 
{

  // Union field min can be only one of the following:
  "minimum": number,
  "exclusiveMinimum": number
  // End of list of possible types for union field min.

  // Union field max can be only one of the following:
  "maximum": number,
  "exclusiveMaximum": number
  // End of list of possible types for union field max.
}
Champs

Champ d'union min. Limite inférieure de l'intervalle. Si aucun des champs min n'est défini, la limite inférieure est l'infini négatif.

Cette valeur ne doit pas être supérieure à la valeur maximale. Dans le cas contraire, une erreur INVALID_ARGUMENT est renvoyée. min ne peut être qu'un des éléments suivants :
minimum

number

Limite inférieure incluse.
exclusiveMinimum

number

Limite inférieure exclusive.

Champ d'union max. Limite supérieure de l'intervalle. Si aucun des champs "max" n'est défini, la limite supérieure est l'infini positif.

Ce champ ne doit pas être inférieur à la valeur minimale. Dans le cas contraire, une erreur INVALID_ARGUMENT est renvoyée. max ne peut être qu'un des éléments suivants :
maximum

number

Limite supérieure inclusive.
exclusiveMaximum

number

Limite supérieure exclusive.

QueryExpansionSpec

Spécification permettant de déterminer dans quelles conditions l'expansion de requête doit avoir lieu.

Représentation JSON 
{
  "condition": enum (Condition),
  "pinUnexpandedResults": boolean
}
Champs
condition

enum (Condition)

Condition dans laquelle l'extension de requête doit se produire. Valeur par défaut : Condition.DISABLED
pinUnexpandedResults

boolean

Indique si les résultats non développés doivent être épinglés. Si ce champ est défini sur "true", les produits non étendus s'affichent toujours en haut des résultats de recherche, suivis des résultats étendus.

Condition

Énumération décrivant la condition dans laquelle l'expansion de requête doit se produire.

Enums
CONDITION_UNSPECIFIED Condition d'expansion des requêtes non spécifiée. Dans ce cas, le comportement du serveur est défini par défaut sur Condition.DISABLED.
DISABLED L'extension des requêtes est désactivée. Seule la requête de recherche exacte est utilisée, même si SearchResponse.total_size est égal à zéro.
AUTO Extension automatique des requêtes générée par l'API Search.

SpellCorrectionSpec

Spécification de la correction orthographique des requêtes.

Représentation JSON 
{
  "mode": enum (Mode)
}
Champs
mode

enum (Mode)

Mode dans lequel la correction orthographique remplace la requête de recherche d'origine. La valeur par défaut est Mode.AUTO.

Mode

Énumération décrivant le mode dans lequel la correction orthographique doit avoir lieu.

Enums
MODE_UNSPECIFIED Mode de correction orthographique non spécifié. Dans ce cas, le comportement du serveur est défini par défaut sur Mode.AUTO.
SUGGESTION_ONLY L'API Search essaie de trouver une suggestion orthographique. Si une suggestion est trouvée, elle est placée dans SearchResponse.corrected_query. La suggestion orthographique ne sera pas utilisée comme requête de recherche.
AUTO Correction orthographique automatique intégrée à l'API Search. La recherche sera basée sur la requête corrigée, si elle est trouvée.

EmbeddingSpec

Spécification qui utilise un vecteur d'embedding de requête personnalisé pour effectuer la récupération sémantique de documents.

Représentation JSON 
{
  "embeddingVectors": [
    {
      object (EmbeddingVector)
    }
  ]
}
Champs
embeddingVectors[]

object (EmbeddingVector)

Vecteur d'embedding utilisé pour la récupération. Limitez-le à 1.

EmbeddingVector

Vecteur d'embedding.

Représentation JSON 
{
  "fieldPath": string,
  "vector": [
    number
  ]
}
Champs
fieldPath

string

Chemin d'accès du champ d'embedding dans le schéma.
vector[]

number

Vecteur d'embedding de la requête.

RankingExpressionBackend

Backend à utiliser pour l'évaluation de l'expression de classement.

Enums
RANKING_EXPRESSION_BACKEND_UNSPECIFIED Option par défaut pour les valeurs non spécifiées/inconnues.
BYOE

Obsolète : utilisez plutôt RANK_BY_EMBEDDING. Classement par modèle d'embedding personnalisé, la méthode par défaut pour évaluer l'expression de classement. Option d'énumération ancienne. Utilisez RANK_BY_EMBEDDING à la place.
CLEARBOX

Obsolète : utilisez plutôt RANK_BY_FORMULA. Classement par formule personnalisée. Option d'énumération ancienne. Utilisez RANK_BY_FORMULA à la place.
RANK_BY_EMBEDDING Classement par modèle d'embedding personnalisé, la méthode par défaut pour évaluer l'expression de classement.
RANK_BY_FORMULA Classement par formule personnalisée.

NaturalLanguageQueryUnderstandingSpec

Spécification permettant d'activer les fonctionnalités de compréhension du langage naturel pour les demandes de recherche.

Représentation JSON 
{
  "filterExtractionCondition": enum (FilterExtractionCondition),
  "geoSearchQueryDetectionFieldNames": [
    string
  ],
  "extractedFilterBehavior": enum (ExtractedFilterBehavior),
  "allowedFieldNames": [
    string
  ]
}
Champs
filterExtractionCondition

enum (FilterExtractionCondition)

Condition dans laquelle l'extraction du filtre doit avoir lieu. Le comportement du serveur est défini par défaut sur DISABLED.
geoSearchQueryDetectionFieldNames[]

string

Noms de champs utilisés pour le filtrage basé sur la localisation, lorsque des filtres de géolocalisation sont détectés dans les requêtes de recherche en langage naturel. Valide uniquement lorsque FilterExtractionCondition est défini sur ENABLED.

Si ce champ est défini, il remplace les noms de champs définis dans ServingConfig.geo_search_query_detection_field_names.
extractedFilterBehavior

enum (ExtractedFilterBehavior)

Facultatif. Contrôle le comportement d'application des filtres extraits à la recherche. Le comportement par défaut dépend de la demande. Pour la recherche structurée dans un seul datastore, la valeur par défaut est HARD_FILTER. Pour la recherche multidépôt de données, le comportement par défaut est SOFT_BOOST. Les filtres basés sur la localisation sont toujours appliqués en tant que filtres stricts. Le paramètre SOFT_BOOST n'a aucune incidence sur eux. Ce champ n'est utilisé que si [SearchRequest.natural_language_query_understanding_spec.filter_extraction_condition][] est défini sur FilterExtractionCondition.ENABLED.
allowedFieldNames[]

string

Facultatif. Liste d'autorisation des champs pouvant être utilisés pour l'extraction de filtres en langage naturel. Par défaut, si ce paramètre n'est pas spécifié, tous les champs indexables peuvent être utilisés pour l'extraction de filtres en langage naturel (mais leur utilisation n'est pas garantie). Si des champs sont spécifiés dans allowedFieldNames, seuls les champs marqués comme indexables dans le schéma et spécifiés dans la liste d'autorisation pourront faire l'objet d'une extraction de filtres en langage naturel. Remarque : Pour la recherche multidatastore, cette option n'est pas encore disponible et sera ignorée.

FilterExtractionCondition

Énumération décrivant la condition dans laquelle l'extraction du filtre doit avoir lieu.

Enums
CONDITION_UNSPECIFIED Le comportement du serveur est défini par défaut sur DISABLED.
DISABLED Désactive l'extraction des filtres de langage naturel.
ENABLED Active l'extraction des filtres de langage naturel.

ExtractedFilterBehavior

Énumération décrivant comment les filtres extraits sont appliqués à la recherche.

Enums
EXTRACTED_FILTER_BEHAVIOR_UNSPECIFIED EXTRACTED_FILTER_BEHAVIOR_UNSPECIFIED utilisera le comportement par défaut pour les filtres extraits. Pour une recherche unique dans le datastore, l'option par défaut consiste à appliquer des filtres stricts. Pour la recherche multidatastore, la valeur par défaut consiste à appliquer des boosts faibles.
HARD_FILTER Applique tous les filtres extraits en tant que filtres stricts sur les résultats. Les résultats qui ne respectent pas les filtres extraits ne seront pas renvoyés dans l'ensemble de résultats.
SOFT_BOOST Applique tous les filtres extraits en tant que boosts modérés. Les résultats qui passent les filtres seront mis en avant et apparaîtront plus haut dans l'ensemble de résultats.

SearchAsYouTypeSpec

Spécification pour la recherche pendant la saisie dans les requêtes de recherche.

Représentation JSON 
{
  "condition": enum (Condition)
}
Champs
condition

enum (Condition)

Condition dans laquelle la saisie semi-automatique doit se produire. Valeur par défaut : Condition.DISABLED

Condition

Énumération décrivant les conditions dans lesquelles la recherche à mesure de la saisie doit avoir lieu.

Enums
CONDITION_UNSPECIFIED Le comportement du serveur est défini par défaut sur Condition.DISABLED.
DISABLED Désactive l'affichage instantané des résultats.
ENABLED Active l'affichage instantané des résultats.
AUTO Permet de basculer automatiquement entre les modes de recherche "au fur et à mesure de la saisie" et "standard". Idéal pour les implémentations à une seule API (par exemple, la suppression des rebonds).

DisplaySpec

Spécifie les fonctionnalités à afficher, comme la mise en surbrillance des correspondances.

Représentation JSON 
{
  "matchHighlightingCondition": enum (MatchHighlightingCondition)
}
Champs
matchHighlightingCondition

enum (MatchHighlightingCondition)

Condition dans laquelle la mise en surbrillance des correspondances doit se produire.

MatchHighlightingCondition

Énumération décrivant la condition dans laquelle la mise en surbrillance des correspondances doit se produire.

Enums
MATCH_HIGHLIGHTING_CONDITION_UNSPECIFIED Le comportement du serveur est identique à celui de MATCH_HIGHLIGHTING_DISABLED.
MATCH_HIGHLIGHTING_DISABLED Désactive la mise en surbrillance des correspondances dans tous les documents.
MATCH_HIGHLIGHTING_ENABLED Permet de mettre en surbrillance les correspondances dans tous les documents.

SessionSpec

Spécification de la session.

La fonctionnalité de recherche multitour est actuellement en disponibilité générale privée. Veuillez utiliser la version v1alpha ou v1beta en attendant que nous lancions cette fonctionnalité en disponibilité générale publique. Vous pouvez également demander à être ajouté à la liste d'autorisation auprès de l'équipe d'assistance Google.

Représentation JSON 
{
  "queryId": string,
  "searchResultPersistenceCount": integer
}
Champs
queryId

string

Si cette option est définie, le résultat de la recherche est stocké dans le "tour" spécifié par cet ID de requête.

Exemple : Supposons que la session se présente comme suit : session { name: ".../sessions/xxx" turns { query { text: "Qu'est-ce que foo ?" queryId: ".../questions/yyy" } answer: "Foo est ..." } turns { query { text: "Et bar ?" queryId: ".../questions/zzz" } } }

L'utilisateur peut appeler l'API /search avec une requête comme celle-ci :

session: ".../sessions/xxx" sessionSpec { queryId: ".../questions/zzz" }

L'API stocke ensuite le résultat de recherche, associé au dernier tour. Le résultat de recherche stocké peut être utilisé par un appel d'API /answer ultérieur (avec l'ID de session et l'ID de requête spécifiés). Il est également possible d'appeler /search et /answer en parallèle avec le même ID de session et ID de requête.
searchResultPersistenceCount

integer

Nombre de meilleurs résultats de recherche à conserver. Les résultats de recherche persistants peuvent être utilisés pour l'appel d'API /answer suivant.

Ce champ est semblable au champ summaryResultCount de SearchRequest.ContentSearchSpec.SummarySpec.summary_result_count.

10 résultats maximum en mode Documents ou 50 en mode Blocs.

RelevanceThreshold

Seuil de pertinence des résultats de recherche. Plus le seuil de pertinence est élevé, plus les résultats pertinents sont affichés et moins de résultats sont renvoyés.

Enums
RELEVANCE_THRESHOLD_UNSPECIFIED Valeur par défaut. Dans ce cas, le comportement du serveur est défini par défaut sur le seuil défini par Google.
LOWEST Seuil de pertinence le plus bas.
LOW Seuil de pertinence faible.
MEDIUM Seuil de pertinence moyen.
HIGH Seuil de pertinence élevé.

RelevanceScoreSpec

Spécification pour renvoyer le score de pertinence du document.

Représentation JSON 
{
  "returnRelevanceScore": boolean
}
Champs
returnRelevanceScore

boolean

Facultatif. Indique s'il faut renvoyer le score de pertinence pour les résultats de recherche. Plus le score est élevé, plus le document est pertinent par rapport à la requête.

SearchAddonSpec

SearchAddonSpec permet de désactiver les modules complémentaires pour la recherche conformément au nouveau modèle de revalorisation. Par défaut, si SearchAddonSpec n'est pas spécifié, nous considérons que le client souhaite les activer partout où cela est possible.

Représentation JSON 
{
  "disableSemanticAddOn": boolean,
  "disableKpiPersonalizationAddOn": boolean,
  "disableGenerativeAnswerAddOn": boolean
}
Champs
disableSemanticAddOn

boolean

Facultatif. Si la valeur est "true", le module complémentaire sémantique est désactivé. Le module complémentaire sémantique inclut les embeddings et JetStream.
disableKpiPersonalizationAddOn

boolean

Facultatif. Si la valeur est "true", le re-classement et la personnalisation des événements sont désactivés afin d'optimiser les KPI et de personnaliser les résultats.
disableGenerativeAnswerAddOn

boolean

Facultatif. Si la valeur est "true", le module complémentaire de réponses génératives est désactivé. Le module complémentaire de réponses génératives inclut le langage naturel pour les filtres et les réponses simples.

QuerySetSpec

Décrit la spécification de l'ensemble de requêtes.

Représentation JSON 
{
  "sampleQuerySet": string
}
Champs
sampleQuerySet

string

Facultatif. Nom complet de la ressource SampleQuerySet utilisée pour l'évaluation, au format projects/{project}/locations/{location}/sampleQuerySets/{sampleQuerySet}.

QualityMetrics

Décrit les métriques produites par l'évaluation.

Représentation JSON 
{
  "docRecall": {
    object (TopkMetrics)
  },
  "docPrecision": {
    object (TopkMetrics)
  },
  "docNdcg": {
    object (TopkMetrics)
  },
  "pageRecall": {
    object (TopkMetrics)
  },
  "pageNdcg": {
    object (TopkMetrics)
  }
}
Champs
docRecall

object (TopkMetrics)

Rappel par document, à différents niveaux de seuil top-k.

Le rappel correspond à la fraction de documents pertinents récupérés sur l'ensemble des documents pertinents.

Exemple (top 5) : * Pour un seul SampleQuery, si 3 documents pertinents sur 5 sont récupérés dans le top 5, rappel@5 = 3/5 = 0,6
docPrecision

object (TopkMetrics)

Précision par document, à différents niveaux de seuil top-k.

La précision est la fraction des documents récupérés qui sont pertinents.

Exemple (top 5) : * Pour un seul SampleQuery, si 4 documents sur 5 récupérés dans le top 5 sont pertinents, precision@5 = 4/5 = 0,8.
docNdcg

object (TopkMetrics)

Bénéfice cumulé réduit normalisé (NDCG) par document, à différents niveaux de seuil top-k.

Le NDCG mesure la qualité du classement, en accordant une plus grande pertinence aux résultats en première position.

Exemple (top 3) : supposons que SampleQuery avec trois documents récupérés (D1, D2, D3) et des jugements de pertinence binaires (1 pour pertinent, 0 pour non pertinent) :

Récupérés : [D3 (0), D1 (1), D2 (1)] Idéal : [D1 (1), D2 (1), D3 (0)]

Calculez NDCG@3 pour chaque SampleQuery : * DCG@3 : 0/log2(1+1) + 1/log2(2+1) + 1/log2(3+1) = 1,13 * DCG@3 idéal : 1/log2(1+1) + 1/log2(2+1) + 0/log2(3+1) = 1,63 * NDCG@3 : 1,13/1,63 = 0,693
pageRecall

object (TopkMetrics)

Rappel par page, à différents niveaux de seuil top-k.

Le rappel correspond à la fraction de pages pertinentes récupérées sur l'ensemble des pages pertinentes.

Exemple (top 5) : * Pour un seul SampleQuery, si 3 pages pertinentes sur 5 sont récupérées dans le top 5, recall@5 = 3/5 = 0,6
pageNdcg

object (TopkMetrics)

Bénéfice cumulé réduit normalisé (NDCG) par page, à différents niveaux de seuil top-k.

Le NDCG mesure la qualité du classement, en accordant une plus grande pertinence aux résultats en première position.

Exemple (top 3) : supposons que SampleQuery avec trois pages récupérées (P1, P2, P3) et des jugements de pertinence binaires (1 pour pertinent, 0 pour non pertinent) :

Récupéré : [P3 (0), P1 (1), P2 (1)] Idéal : [P1 (1), P2 (1), P3 (0)]

Calculer NDCG@3 pour SampleQuery : * DCG@3 : 0/log2(1+1) + 1/log2(2+1) + 1/log2(3+1) = 1,13 * DCG@3 idéal : 1/log2(1+1) + 1/log2(2+1) + 0/log2(3+1) = 1,63 * NDCG@3 : 1,13/1,63 = 0,693

TopkMetrics

Stocke les valeurs de métrique à des niveaux top-k spécifiques.

Représentation JSON 
{
  "top1": number,
  "top3": number,
  "top5": number,
  "top10": number
}
Champs
top1

number

Valeur Top-1.
top3

number

Valeur du top 3.
top5

number

Valeur du top 5.
top10

number

La valeur du top 10.

État

Décrit l'état d'une évaluation.

Enums
STATE_UNSPECIFIED L'évaluation n'est pas spécifiée.
PENDING Le service se prépare à exécuter l'évaluation.
RUNNING L'évaluation est en cours.
SUCCEEDED L'évaluation a bien été effectuée.
FAILED L'évaluation a échoué.

Méthodes

create

 Crée un objet Evaluation.

get

 Récupère un Evaluation.

list

 Obtient une liste de Evaluation.

listResults

 Obtient une liste de résultats pour un Evaluation donné.