SearchSpec.Builder.SetRankingStrategy Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| Nombre | Description |
|---|---|
| SetRankingStrategy(Int32) |
Establece la estrategia de clasificación para los resultados de AppSearch. |
| SetRankingStrategy(String) |
Habilita la clasificación avanzada para puntuar en función de advancedRankingExpression. |
SetRankingStrategy(Int32)
Establece la estrategia de clasificación para los resultados de AppSearch.
[Android.Runtime.Register("setRankingStrategy", "(I)Landroid/app/appsearch/SearchSpec$Builder;", "", ApiSince=31)]
public Android.App.AppSearch.SearchSpec.Builder SetRankingStrategy(int rankingStrategy);
[<Android.Runtime.Register("setRankingStrategy", "(I)Landroid/app/appsearch/SearchSpec$Builder;", "", ApiSince=31)>]
member this.SetRankingStrategy : int -> Android.App.AppSearch.SearchSpec.Builder
Parámetros
- rankingStrategy
- Int32
El valor es uno de los siguientes: SearchSpec.RANKING_STRATEGY_NONE SearchSpec.RANKING_STRATEGY_DOCUMENT_SCORE SearchSpec.RANKING_STRATEGY_CREATION_TIMESTAMP SearchSpec.RANKING_STRATEGY_RELEVANCE_SCORE SearchSpec.RANKING_STRATEGY_USAGE_COUNT SearchSpec.RANKING_STRATEGY_USAGE_LAST_USED_TIMESTAMP SearchSpec.RANKING_STRATEGY_SYSTEM_USAGE_COUNT SearchSpec.RANKING_STRATEGY_SYSTEM_USAGE_LAST_USED_TIMESTAMP SearchSpec.RANKING_STRATEGY_JOIN_AGGREGATE_SCORE SearchSpec. RANKING_STRATEGY_ADVANCED_RANKING_EXPRESSION
Devoluciones
Esta instancia del generador.
- Atributos
Comentarios
Establece la estrategia de clasificación para los resultados de AppSearch.
Referencia de Android para android.app.appsearch.SearchSpec.Builder.setRankingStrategy.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.
Se aplica a
SetRankingStrategy(String)
Habilita la clasificación avanzada para puntuar en función de advancedRankingExpression.
[Android.Runtime.Register("setRankingStrategy", "(Ljava/lang/String;)Landroid/app/appsearch/SearchSpec$Builder;", "", ApiSince=34)]
public Android.App.AppSearch.SearchSpec.Builder SetRankingStrategy(string advancedRankingExpression);
[<Android.Runtime.Register("setRankingStrategy", "(Ljava/lang/String;)Landroid/app/appsearch/SearchSpec$Builder;", "", ApiSince=34)>]
member this.SetRankingStrategy : string -> Android.App.AppSearch.SearchSpec.Builder
Parámetros
- advancedRankingExpression
- String
una cadena no vacía que representa la expresión de clasificación. Este valor no puede ser nulo.
Devoluciones
Esta instancia del generador.
- Atributos
Comentarios
Habilita la clasificación avanzada para puntuar en función de advancedRankingExpression. Este método establecerá RankingStrategy en SearchSpec.RANKING_STRATEGY_ADVANCED_RANKING_EXPRESSION. La expresión de clasificación es una expresión matemática que se evaluará como un número de punto flotante de tipo doble que representa la puntuación de cada documento. Los literales numéricos, los operadores aritméticos, las funciones matemáticas, las funciones basadas en documentos y las funciones basadas en valores de propiedad se admiten para crear expresiones. A continuación se admiten operadores aritméticos: se admiten las precedencias de operador de suma (+) resta(-) multiplicación(*), división de punto flotante(/) con el lenguaje de Java y se admiten paréntesis. Por ejemplo, "2.2 + (3 - 4) / 2" se evalúa como 1.7. A continuación se admiten funciones matemáticas básicas: log(x): el registro natural de x log(x, y) - el registro de y con base x pow(x, y) - x a la potencia de y sqrt(x) abs(x) sin(x), cos(x), tan(x) Ejemplo: "max(abs(-100), 10) + pow(2, 10)" se evaluarán a 1124 Se admiten las siguientes funciones matemáticas variadices, con n > 0. También aceptan parámetros de valor de lista. Por ejemplo, si V es un valor de tipo de lista, podemos llamar a sum(V) para obtener la suma de todos los valores de V. No se admiten literales de lista, por lo que un valor de tipo de lista solo se puede construir como un valor devuelto de algunas funciones específicas basadas en documentos. max(v1, v2,..., vn) o max(V) min(v1, v2,..., vn) o min(V) len(v1, v2,..., vn) o len(V) sum(v1, v2,..., vn) o sum(V) avg(v1, v2,..., vn) o avg(V) Se debe llamar a través de "this", que representa el documento actual puntuado. A continuación se admiten funciones basadas en documentos: this.documentScore() Obtiene la puntuación de documento proporcionada por la aplicación del documento actual. Esta es la misma puntuación que se devuelve para SearchSpec.RANKING_STRATEGY_DOCUMENT_SCORE. this.creationTimestamp() Obtiene la marca de tiempo de creación del documento actual. Esta es la misma puntuación que se devuelve para SearchSpec.RANKING_STRATEGY_CREATION_TIMESTAMP. this.relevanceScore() Obtiene la puntuación de relevancia BM25F del documento actual en relación con la cadena de consulta. Esta es la misma puntuación que se devuelve para SearchSpec.RANKING_STRATEGY_RELEVANCE_SCORE. this.usageCount(type) y this.usageLastUsedTimestamp(type) Obtiene el número de usos o la marca de tiempo del último uso por tipo para el documento actual, donde el tipo debe evaluarse en un entero de 1 a 2. El tipo 1 hace referencia a los usos notificados por AppSearchSession.reportUsage y el tipo 2 hace referencia a los usos notificados por GlobalSearchSession.reportSystemUsage. this.childrenRankingSignals() Devuelve una lista de señales de clasificación secundarias calculadas mediante la puntuación de los documentos unidos mediante la estrategia de clasificación especificada en el SearchSpec anidado. Actualmente, un documento solo puede ser un elemento secundario de otro documento en el contexto de combinaciones. Si se llama a esta función sin la API join habilitada, se generará un error de tipo. this.propertyWeights() Devuelve una lista de los pesos normalizados de las propiedades coincidentes para el documento actual que se puntua. Los pesos de propiedad proceden de lo que se especifica en SearchSpec. Después de normalizar, cada peso proporcionado se dividirá por el peso máximo, de modo que cada uno de ellos será <= 1. this.matchedSemanticScores(getEmbeddingParameter({embedding_index}), {metric}) Devuelve una lista de las puntuaciones de similitud coincidentes de "semanticSearch" en la expresión de consulta (vea también AppSearchSession.search ) basada en embedding_index y métrica. Si se omite la métrica, el valor predeterminado es la métrica especificada en SearchSpec.Builder.setDefaultEmbeddingSearchMetricType(int). Si no se llama a "semanticSearch" para embedding_index y métrica en la consulta, esta función devolverá una lista vacía. Si se llama a varios "semanticSearch" para la misma embedding_index y métrica, esta función devolverá una lista de sus puntuaciones combinadas. Ejemplo: 'this.matchedSemanticScores(getEmbeddingParameter(0), "COSINE")' devolverá una lista de puntuaciones coincidentes dentro del intervalo de [0.5, 1], si 'semanticSearch(getEmbeddingParameter(0), 0.5, 1, "COSINE")" se llama en la expresión de consulta. Se puede llamar a funciones basadas en valores de propiedad a través de la función de getScorableProperty(schemaType, propertyPath) Para poder usar esta función, la característica ScorablePropertyRanking debe estar habilitada a través de SearchSpec.Builder.setScorablePropertyRankingEnabled(boolean). El parámetro 'schemaType' debe ser un valor SchemaType de AppSearch válido; de lo contrario, se devuelve un error. El parámetro 'propertyPath' debe ser válido y, de lo contrario, se devuelve un error. Se considera que escorable cuando: es para una propiedad que está establecida para habilitarse para la puntuación, o que apunta a una propiedadcorable de tipos de esquema anidados. Esta función devuelve una lista de valores dobles para los documentos coincidentes. Si el esquema del documento coincidente es diferente de "schemaType" o la propiedad de la propiedad "propertyPath" no contiene ningún elemento, se devuelve una lista vacía. A continuación se muestran algunos ejemplos: Supongamos que hay dos esquemas: "Gmail" y "Persona". El esquema "Gmail" tiene una propiedad "recipient" con el tipo de esquema "Person". En la expresión de clasificación avanzada, puede tener: "sum(getScorableProperty('Gmail', 'viewTimes'))" "maxOrDefault(getScorableProperty('Person', 'income'), 0)" "sum(getScorableProperty('Gmail', 'recipient.income'))" "this.documentScore() + sum(getScorableProperty('Gmail', 'viewTimes'))" Las siguientes funciones se proporcionan para la manipulación mejorada de listas. minOrDefault(V, default_score) Devuelve el valor mínimo de la lista de entrada V o el default_score si la lista está vacía. Ejemplo: "minOrDefault(this.matchedSemanticScores(getEmbeddingParameter(0)), 10)" devolverá las puntuaciones semánticas mínimas coincidentes o 10 si no hay ninguna puntuación coincidente para el documento actual. Esta función requiere la característica ERROR(/Features#SEARCH_SPEC_RANKING_FUNCTION_MAX_MIN_OR_DEFAULT). maxOrDefault(V, default_score) Devuelve el valor máximo de la lista de entrada V o el default_score si la lista está vacía. Ejemplo: "maxOrDefault(this.matchedSemanticScores(getEmbeddingParameter(0)), -10)" devolverá las puntuaciones semánticas máximas coincidentes o -10 si no hay ninguna puntuación coincidente para el documento actual. Esta función requiere la característica ERROR(/Features#SEARCH_SPEC_RANKING_FUNCTION_MAX_MIN_OR_DEFAULT). filterByRange(V, low, high) Devuelve una sublist de V que solo contiene los elementos que se encuentran dentro del intervalo especificado [bajo, alto]. Ejemplo: "filterByRange(this.matchedSemanticScores(getEmbeddingParameter(0)), 0, 1)" devolverá una lista de puntuaciones semánticas coincidentes entre 0 y 1, inclusive. Esta función requiere la característica ERROR(/Features#SEARCH_SPEC_RANKING_FUNCTION_FILTER_BY_RANGE). Algunos errores pueden producirse al usar la clasificación avanzada. Error de sintaxis: la expresión infringe la sintaxis del lenguaje de clasificación avanzado. A continuación se muestran algunos ejemplos. "1 + " - operando que falta "2 * (1 + 2))" - paréntesis desequilibrado "2 ^ 3" - operador desconocido Error de tipo: la expresión produce un error en una comprobación de tipo estático. A continuación se muestran algunos ejemplos. "sin(2, 3)" - número incorrecto de argumentos para la función sin "this.childrenRankingSignals() + 1" - no se puede agregar una lista con un número "this.propertyWeights()" - el tipo final de la expresión general no puede ser una lista, que puede corregirse mediante "max(this.propertyWeights())" "abs(this.propertyWeights())" - la función abs no admite argumentos de tipo de lista "print(2)" - error de evaluación de función desconocida: error al evaluar el valor de la expresión. A continuación se muestran algunos ejemplos. "1 / 0", "log(0)", "1 + sqrt(-1)" - obtener un valor no finito en medio de la evaluación "this.usageCount(1 + 0.5)" - espera que el argumento sea un entero. Tenga en cuenta que este no es un error de tipo y "this.usageCount(1.5 + 1/2)" puede realizarse correctamente sin problemas "this.documentScore()" - en caso de un error de E/S, se trata de un error de evaluación Errores de sintaxis y errores de tipo producirá un error de búsqueda completo y hará que SearchResults.getNextPage inicie una appSearchException con el código de resultado de AppSearchResult.RESULT_INVALID_ARGUMENT. Los errores de evaluación provocarán que los documentos infractores reciban la puntuación predeterminada. Para SearchSpec.ORDER_DESCENDING, la puntuación predeterminada será 0, por SearchSpec.ORDER_ASCENDING la puntuación predeterminada será infinita.
Referencia de Android para android.app.appsearch.SearchSpec.Builder.setRankingStrategy.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.