ServingConfig

Configura los metadatos que se usan para generar resultados en el momento de la entrega (p.ej., resultados de la búsqueda o predicciones de recomendaciones). El objeto ServingConfig se pasa 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 completamente calificado projects/{project}/locations/{location}/collections/{collectionId}/engines/{engineId}/servingConfigs/{servingConfigId}
displayName

string

Obligatorio. Es el nombre visible de la configuración de entrega legible por humanos. Se usa en la IU de Discovery.

Este campo debe ser una cadena codificada en UTF-8 con un límite de 128 caracteres. De lo contrario, se muestra 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 publicación.
modelId

string

Es el ID del modelo que se usará en el momento de la entrega. Actualmente, solo se admiten los RecommendationModels. Se puede cambiar, pero solo a un modelo compatible (p.ej., de la CTR de otras que podrían gustarte al CVR de otras que podrían gustarte).

Obligatorio cuando SolutionType es SOLUTION_TYPE_RECOMMENDATION.
diversityLevel

string

Es la cantidad de diversidad que se usará en los resultados del modelo de recomendación, p.ej., 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 según el tipo de modelo de recomendación. Valor predeterminado: no-diversity.

Solo se puede configurar si SolutionType es SOLUTION_TYPE_RECOMMENDATION.
rankingExpression

string

La expresión de clasificación controla la clasificación personalizada de los documentos recuperados. Para aprovechar esta función, se requiere la incorporación de documentos. El parámetro de configuración de la expresión de clasificación en ServingConfig se aplica a todas las solicitudes de búsqueda que se entregan con la configuración de entrega. 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 "+".

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

Funciones compatibles:

  • double * relevanceScore
  • double * dotProduct(embedding_field_path)

Variables de función:

  • relevanceScore: Son palabras clave predefinidas que se usan para medir la relevancia entre la búsqueda y el documento.
  • embedding_field_path: Es el campo de incorporación de documentos que se usa con el vector de incorporación de la búsqueda.
  • dotProduct: Es la función de embedding entre embedding_field_path y el vector de embedding de la búsqueda.

Ejemplo de expresión de clasificación:

Si el documento tiene un campo de incorporació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 salida. Es la marca de tiempo de creación de ServingConfig.

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizado a Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “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 salida. Es la marca de tiempo de actualización de ServingConfig.

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizado a Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
filterControlIds[]

string

Son los controles de filtro que se usarán en la ruta de entrega. 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 la publicación. Se permite un máximo de 20 controles de filtros.
boostControlIds[]

string

Controles de refuerzo que se usarán en la ruta de entrega. Se aplicarán todos los controles de potenciación activados. Los controles de refuerzo deben estar en el mismo almacén de datos que la configuración de la publicación. Se pueden aplicar un máximo de 20 controles de potenciación.
redirectControlIds[]

string

Son los IDs de los controles de redireccionamiento. Solo se aplica la primera acción de redireccionamiento activada, incluso si se aplican varias. La cantidad máxima de especificaciones es 100.

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

string

Son las especificaciones de los sinónimos de condiciones. Si coinciden varias condiciones de sinónimos, se ejecutarán todos los controles de sinónimos coincidentes de la lista. La cantidad máxima de especificaciones es 100.

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

string

Son las especificaciones de los sinónimos unidireccionales de la condición. Si coinciden varias condiciones de sinónimos unidireccionales, se ejecutarán todos los controles de sinónimos unidireccionales coincidentes de la lista. La cantidad máxima de especificaciones es 100.

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

string

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

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

string

Son las especificaciones de reemplazo de la condición. Se aplican según el orden en la lista. No se puede volver a reemplazar un término que ya se reemplazó. La cantidad máxima de especificaciones es 100.

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

string

Especificaciones de ignorar la condición. Si coinciden varias condiciones de ignorar, se ejecutarán todos los controles de ignorar coincidentes de la lista. El orden no importa. La cantidad máxima de especificaciones es 100.
promoteControlIds[]

string

Son las especificaciones de la promoción de condiciones.

La cantidad máxima de especificaciones es 100.
answerGenerationSpec

object (AnswerGenerationSpec)

Opcional. Es la especificación para la generación de respuestas.
Campo de unión vertical_config. Es la configuración específica de la vertical de la industria. vertical_config puede ser solo uno de los siguientes:
mediaConfig

object (MediaConfig)

Es el MediaConfig de la configuración de entrega.
genericConfig

object (GenericConfig)

Es el GenericConfig de la configuración de entrega.

MediaConfig

Especifica la configuración necesaria para el Descubrimiento de contenido multimedia. Actualmente, admitimos lo siguiente:

  • demote_content_watched: Es el umbral para la reducción de la visibilidad del contenido visto. Los clientes pueden especificar si usan la reducción de nivel del contenido visto o la página de detalles vista. Con la reducción de visibilidad del contenido visto, los clientes deben especificar que los minutos o el porcentaje vistos superan el umbral. De lo contrario, se reducirá la visibilidad del contenido en el resultado de la recomendación.
  • promote_fresh_content: Son los días límite para la promoción de contenido nuevo. Los clientes pueden especificar si se usa la promoción de la actualización del contenido. Si el contenido se publicó dentro de los días límite, se promocionará en el resultado de la recomendación. Solo se puede configurar 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 reducir la posición del resultado de la recomendación. Valores admitidos actualmente:

  • view-item: Se vio el elemento.
  • media-play: Comenzar o reanudar la reproducción de un video, una canción, etcétera
  • media-complete: Terminó o se detuvo a mitad de un video, una canción, etcétera.

Si no se configura, no se aplicará la reducción de la visibilidad del historial de reproducciones. Aún se aplicará la reducción de la actualización del contenido.
demoteContentWatchedPastDays

integer

Opcional. Especifica la cantidad de días hacia atrás para bajar el contenido visto. Si se establece en cero o no se establece, el valor predeterminado es el máximo de 365 días.
contentFreshnessCutoffDays

integer

Especifica la actualización del contenido que se usa para el resultado de la recomendación. El contenido descenderá de nivel si se publicó hace más de los días límite de actualización del contenido.
Campo de unión demote_content_watched. Especifica el umbral para reducir la visibilidad del contenido visto. El umbral puede ser un valor de porcentaje o de minutos. Se debe configurar para el tipo de evento media-complete. demote_content_watched puede ser solo uno de los siguientes:
contentWatchedPercentageThreshold

number

Especifica el umbral de porcentaje de contenido visto para la baja. El valor del umbral debe estar entre [0, 1.0], inclusive.
contentWatchedSecondsThreshold

number

Especifica el umbral de minutos de contenido visto para la baja.

GenericConfig

Especifica las configuraciones necesarias para el Descubrimiento genérico.Actualmente, admitimos lo siguiente:

  • contentSearchSpec: Es la 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 el almacén de datos habilitado para la búsqueda de contenido.

AnswerGenerationSpec

Es la especificación para la generación de respuestas.

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

object (UserDefinedClassifierSpec)

Opcional. Es la especificación del clasificador especificado por el usuario.

UserDefinedClassifierSpec

Es la 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. Es el preámbulo que se usará para el clasificador definido por el usuario.
modelId

string

Opcional. Es el ID del modelo que se usará para el clasificador definido por el usuario.
taskMarker

string

Opcional. Es el marcador de tarea que se usará para el clasificador definido por el usuario.
topP

number

Opcional. Es el valor de top-p que se usará para el clasificador definido por el usuario.
topK

string (int64 format)

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

number

Opcional. Es el valor de temperatura que se usará para el clasificador definido por el usuario.
seed

integer

Opcional. Es el valor de semilla que se usará para el clasificador definido por el usuario.