ServingConfig

Configura los metadatos que se usan para generar resultados de tiempo de servicio (por ejemplo, resultados de búsqueda o predicciones de recomendaciones). ServingConfig se incluye en la solicitud de búsqueda y predicción, y genera resultados.

Representación JSON 
{
  "name": string,
  "displayName": string,
  "solutionType": enum (SolutionType),
  "modelId": string,
  "diversityLevel": string,
  "rankingExpression": string,
  "createTime": string,
  "updateTime": string,
  "filterControlIds": [
    string
  ],
  "boostControlIds": [
    string
  ],
  "redirectControlIds": [
    string
  ],
  "synonymsControlIds": [
    string
  ],
  "onewaySynonymsControlIds": [
    string
  ],
  "dissociateControlIds": [
    string
  ],
  "replacementControlIds": [
    string
  ],
  "ignoreControlIds": [
    string
  ],
  "promoteControlIds": [
    string
  ],
  "answerGenerationSpec": {
    object (AnswerGenerationSpec)
  },

  // Union field vertical_config can be only one of the following:
  "mediaConfig": {
    object (MediaConfig)
  },
  "genericConfig": {
    object (GenericConfig)
  }
  // End of list of possible types for union field vertical_config.
}
Campos
name

string

Inmutable. Nombre completo projects/{project}/locations/{location}/collections/{collectionId}/engines/{engineId}/servingConfigs/{servingConfigId}
displayName

string

Obligatorio. Nombre visible de la configuración de servicio legible por humanos. Se usa en la interfaz de usuario de Discovery.

Este campo debe ser una cadena codificada en UTF-8 con un límite de 128 caracteres. De lo contrario, se devuelve un error INVALID_ARGUMENT.
solutionType

enum (SolutionType)

Obligatorio. Inmutable. Especifica el tipo de solución con el que se puede asociar una configuración de servicio.
modelId

string

ID del modelo que se usará en el momento de la publicación. Actualmente, solo se admiten RecommendationModels. Se puede cambiar, pero solo a un modelo compatible (por ejemplo, de CTR de otros que te pueden gustar a CVR de otros que te pueden gustar).

Es obligatorio cuando SolutionType es SOLUTION_TYPE_RECOMMENDATION.
diversityLevel

string

Cantidad de diversidad que se debe usar en los resultados del modelo de recomendación, por ejemplo, medium-diversity o high-diversity. Valores admitidos actualmente:

  • no-diversity
  • low-diversity
  • medium-diversity
  • high-diversity
  • auto-diversity

Si no se especifica, elegimos el valor predeterminado en función del tipo de modelo de recomendación. Valor predeterminado: no-diversity.

Solo se puede definir si SolutionType es SOLUTION_TYPE_RECOMMENDATION.
rankingExpression

string

La expresión de clasificación controla la clasificación personalizada de los documentos de recuperación. Para aprovechar esta función, es necesario insertar el documento. El ajuste de la expresión de clasificación de ServingConfig se aplica a todas las solicitudes de búsqueda que sirve la configuración de servicio. Sin embargo, si se especifica SearchRequest.ranking_expression, se anula la expresión de clasificación de ServingConfig.

La expresión de clasificación es una sola función o varias funciones unidas por el signo "+".

  • rankingExpression = function, { " + ", function };

Funciones admitidas:

  • double * relevanceScore
  • double * dotProduct(embedding_field_path)

Variables de función:

  • relevanceScore: palabras clave predefinidas que se usan para medir la relevancia entre la consulta y el documento.
  • embedding_field_path: el campo de inserción de documentos que se usa con el vector de inserción de consultas.
  • dotProduct: función de inserción entre embedding_field_path y el vector de inserción de la consulta.

Expresión de clasificación de ejemplo:

Si el documento tiene un campo de inserción doc_embedding, la expresión de clasificación podría ser 0.5 * relevanceScore + 0.3 * dotProduct(doc_embedding).
createTime

string (Timestamp format)

Solo de salida. Marca de tiempo de creación de ServingConfig.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo de salida. Marca de tiempo de la actualización de ServingConfig.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
filterControlIds[]

string

Controles de filtro que se van a usar en la ruta de servicio. Se aplicarán todos los controles de filtro activados. Los controles de filtro deben estar en el mismo almacén de datos que la configuración de servicio. Un máximo de 20 controles de filtros.
boostControlIds[]

string

Controles de aumento que se van a usar en la ruta de servicio. Se aplicarán todos los controles de aumento activados. Los controles de impulso deben estar en el mismo almacén de datos que la configuración de servicio. Se pueden añadir hasta 20 controles de aumento.
redirectControlIds[]

string

IDs de los controles de redirección. Solo se aplica la primera acción de redirección activada, aunque se apliquen varias. El número máximo de especificaciones es 100.

Solo se puede definir si SolutionType es SOLUTION_TYPE_SEARCH.
synonymsControlIds[]

string

Especificaciones de sinónimos de condiciones. Si se cumplen varias condiciones de sinónimos, se ejecutarán todos los controles de sinónimos coincidentes de la lista. El número máximo de especificaciones es 100.

Solo se puede definir si SolutionType es SOLUTION_TYPE_SEARCH.
onewaySynonymsControlIds[]

string

Condición de especificaciones de sinónimos unidireccionales. Si se cumplen varias condiciones de sinónimos unidireccionales, se ejecutarán todos los controles de sinónimos unidireccionales coincidentes de la lista. El número máximo de especificaciones es 100.

Solo se puede definir si SolutionType es SOLUTION_TYPE_SEARCH.
dissociateControlIds[]

string

La condición no asocia especificaciones. Si se cumplen varias condiciones de no asociación, se ejecutarán todos los controles de no asociación coincidentes de la lista. El orden no importa. El número máximo de especificaciones es 100.

Solo se puede definir si SolutionType es SOLUTION_TYPE_SEARCH.
replacementControlIds[]

string

Especificaciones de sustitución de condiciones. Se aplican según el orden de la lista. Un término que ya se ha sustituido no se puede volver a sustituir. El número máximo de especificaciones es 100.

Solo se puede definir si SolutionType es SOLUTION_TYPE_SEARCH.
ignoreControlIds[]

string

Condición de especificaciones de omisión. Si se cumplen varias condiciones de ignorar, se ejecutarán todos los controles de ignorar coincidentes de la lista. El orden no importa. El número máximo de especificaciones es 100.
promoteControlIds[]

string

Especificaciones de la promoción de condiciones.

El número máximo de especificaciones es 100.
answerGenerationSpec

object (AnswerGenerationSpec)

Opcional. Especificación para la generación de respuestas.
Campo de unión vertical_config. Configuración específica de la vertical del sector. vertical_config solo puede ser una de estas dos opciones:
mediaConfig

object (MediaConfig)

MediaConfig de la configuración de publicación.
genericConfig

object (GenericConfig)

GenericConfig de la configuración de publicación.

MediaConfig

Especifica las configuraciones necesarias para el descubrimiento de contenido multimedia. Actualmente, admitimos lo siguiente:

  • demote_content_watched: umbral para la degradación del contenido visto. Los clientes pueden especificar si quieren usar la degradación del contenido visto o la página de detalles vista. Si se usa la opción de degradación del contenido visto, los clientes deben especificar si los minutos o el porcentaje de contenido visto superan el umbral. Si es así, el contenido se degradará en los resultados de las recomendaciones.
  • promote_fresh_content: días límite para promocionar contenido nuevo. Los clientes pueden especificar si quieren usar la promoción de contenido actualizado. Si el contenido se publicó en los días límite, se promocionará en los resultados de las recomendaciones. Solo se puede definir si SolutionType es SOLUTION_TYPE_RECOMMENDATION.
Representación JSON 
{
  "demotionEventType": string,
  "demoteContentWatchedPastDays": integer,
  "contentFreshnessCutoffDays": integer,

  // Union field demote_content_watched can be only one of the following:
  "contentWatchedPercentageThreshold": number,
  "contentWatchedSecondsThreshold": number
  // End of list of possible types for union field demote_content_watched.
}
Campos
demotionEventType

string

Especifica el tipo de evento que se usa para degradar el resultado de la recomendación. Valores admitidos actualmente:

  • view-item: elemento visto.
  • media-play: empezar o reanudar la reproducción de un vídeo, una canción, etc.
  • media-complete: se ha terminado o se ha detenido a mitad de un vídeo, una canción, etc.

Si no se define, no se aplicará la degradación del historial de reproducciones. Seguirá aplicándose la degradación por falta de actualización del contenido.
demoteContentWatchedPastDays

integer

Opcional. Especifica el número de días que se deben tener en cuenta para rebajar la posición del contenido visto. Si se define en cero o no se define, se asigna el valor predeterminado de 365 días.
contentFreshnessCutoffDays

integer

Especifica la frecuencia de actualización del contenido que se usa para el resultado de la recomendación. El contenido se degradará si se ha publicado durante más días de los que se considera que está actualizado.
Campo de unión demote_content_watched. Especifica el umbral para rebajar la posición del contenido visto. Puede ser un porcentaje o un valor en minutos. Este campo debe definirse para el tipo de evento media-complete. demote_content_watched solo puede ser una de estas dos opciones:
contentWatchedPercentageThreshold

number

Especifica el umbral del porcentaje de contenido visto para la degradación. El valor del umbral debe estar comprendido entre 0 y 1, 0 (ambos incluidos).
contentWatchedSecondsThreshold

number

Especifica el umbral de minutos de contenido visto para la degradación.

GenericConfig

Especifica las configuraciones necesarias para la detección genérica.Actualmente, admitimos lo siguiente:

  • contentSearchSpec: configuración para la búsqueda de contenido genérico.
Representación JSON 
{
  "contentSearchSpec": {
    object (ContentSearchSpec)
  }
}
Campos
contentSearchSpec

object (ContentSearchSpec)

Especifica el comportamiento esperado de la búsqueda de contenido. Solo es válido para almacenes de datos con la búsqueda de contenido habilitada.

AnswerGenerationSpec

Especificación para la generación de respuestas.

Representación JSON 
{
  "userDefinedClassifierSpec": {
    object (UserDefinedClassifierSpec)
  }
}
Campos
userDefinedClassifierSpec

object (UserDefinedClassifierSpec)

Opcional. Especificación del clasificador especificado por el usuario.

UserDefinedClassifierSpec

Especificación del clasificador definido por el usuario.

Representación JSON 
{
  "enableUserDefinedClassifier": boolean,
  "preamble": string,
  "modelId": string,
  "taskMarker": string,
  "topP": number,
  "topK": string,
  "temperature": number,
  "seed": integer
}
Campos
enableUserDefinedClassifier

boolean

Opcional. Indica si se debe habilitar e incluir el clasificador definido por el usuario.
preamble

string

Opcional. Preámbulo que se usará para el clasificador definido por el usuario.
modelId

string

Opcional. ID del modelo que se va a usar en el clasificador definido por el usuario.
taskMarker

string

Opcional. El marcador de tarea que se va a usar en el clasificador definido por el usuario.
topP

number

Opcional. Valor de top_p que se usará en el clasificador definido por el usuario.
topK

string (int64 format)

Opcional. El valor de los k elementos principales que se usará en el clasificador definido por el usuario.
temperature

number

Opcional. Valor de temperatura que se usará en el clasificador definido por el usuario.
seed

integer

Opcional. Valor de semilla que se usará en el clasificador definido por el usuario.