REST Resource: projects.locations.dataStores.servingConfigs

Recurso: ServingConfig

Configura los metadatos que se usan para generar resultados de tiempo de entrega (p.ej., resultados de la búsqueda o predicciones de recomendaciones). La 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,
  "embeddingConfig": {
    object (EmbeddingConfig)
  },
  "rankingExpression": string,
  "guidedSearchSpec": {
    object (GuidedSearchSpec)
  },
  "customFineTuningSpec": {
    object (CustomFineTuningSpec)
  },
  "createTime": string,
  "updateTime": string,
  "filterControlIds": [
    string
  ],
  "boostControlIds": [
    string
  ],
  "redirectControlIds": [
    string
  ],
  "synonymsControlIds": [
    string
  ],
  "onewaySynonymsControlIds": [
    string
  ],
  "dissociateControlIds": [
    string
  ],
  "replacementControlIds": [
    string
  ],
  "ignoreControlIds": [
    string
  ],
  "promoteControlIds": [
    string
  ],
  "personalizationSpec": {
    object (PersonalizationSpec)
  },
  "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. 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 longitud 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 entrega.
modelId

string

Es el ID del modelo que se usará en el momento de la entrega. Actualmente, solo se admiten RecommendationModels. Se puede cambiar, pero solo a un modelo compatible (p.ej., 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

Es la 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.
embeddingConfig

object (EmbeddingConfig)

Trae tu propia configuración de incorporación. La configuración se usa para la recuperación semántica de la búsqueda. La recuperación se basa en el producto escalar de SearchRequest.EmbeddingSpec.EmbeddingVector.vector y las incorporaciones de documentos que proporciona esta EmbeddingConfig. Si se proporciona SearchRequest.EmbeddingSpec.EmbeddingVector.vector, se anula esta ServingConfig.embedding_config.
rankingExpression

string

La expresión de clasificación controla la clasificación personalizada en los documentos recuperados. Para aprovechar esto, 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 entrega 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 que se unen con “+”.

  • 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 incorporación de documentos que se usa con el vector de incorporación de la consulta.
  • dotProduct: Función de incorporación entre embedding_field_path y el vector de incorporación de la consulta.

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).
guidedSearchSpec

object (GuidedSearchSpec)

Configuraciones de búsqueda guiada.
customFineTuningSpec

object (CustomFineTuningSpec)

Configuraciones de ajuste personalizado. Si se establece SearchRequest.custom_fine_tuning_spec, tiene mayor prioridad que las configuraciones establecidas aquí.
createTime

string (Timestamp format)

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

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. 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. Marca de tiempo de actualización de ServingConfig.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. 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

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 entrega. Se permite un máximo de 20 controles de filtro.
boostControlIds[]

string

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

string

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

Especificaciones de sinónimos de condición. 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

Especificaciones de sinónimos unidireccionales de 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

Especificaciones de no asociar de condición. Si coinciden varias condiciones de no asociar, se ejecutarán todos los controles de no asociar 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

Especificaciones de reemplazo de condición. Se aplica según el orden de la lista. No se puede volver a reemplazar un término reemplazado anteriormente. La cantidad máxima de especificaciones es 100.

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

string

Especificaciones de ignorar de 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

Especificaciones de promoción de condición.

La cantidad máxima de especificaciones es 100.
personalizationSpec

object (PersonalizationSpec)

Es la especificación de la especificación de personalización.

Ten en cuenta que, si se establecen ServingConfig.personalization_spec y SearchRequest.personalization_spec, SearchRequest.personalization_spec anula ServingConfig.personalization_spec.
answerGenerationSpec

object (AnswerGenerationSpec)

Es opcional. Es la especificación para la generación de respuestas.
Campo de unión vertical_config. Configuración específica de la vertical de la industria. vertical_config puede ser solo uno de los parámetros siguientes:
mediaConfig

object (MediaConfig)

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

object (GenericConfig)

Es la GenericConfig de la configuración de entrega.

Métodos

answer

 Método de respuesta a la consulta.

create

 Crea una ServingConfig.

delete

 Borra una ServingConfig.

get

 Obtiene una ServingConfig.

list

 Muestra todas las ServingConfigs vinculadas a este almacén de datos.

patch

 Actualiza una ServingConfig.

recommend

 Realiza una recomendación, que requiere un evento contextual del usuario.
Realiza una búsqueda.

searchLite

 Realiza una búsqueda.

streamAnswer

 Método de respuesta a la consulta (transmisión).