REST Resource: projects.locations.collections.engines.servingConfigs

Recurso: 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,
  "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 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.
embeddingConfig

object (EmbeddingConfig)

Usa tu propia configuración de inserció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 incrustaciones de documentos que proporciona este EmbeddingConfig. Si se proporciona SearchRequest.EmbeddingSpec.EmbeddingVector.vector, se anula este ServingConfig.embedding_config.
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).
guidedSearchSpec

object (GuidedSearchSpec)

Configuraciones de búsqueda guiada.
customFineTuningSpec

object (CustomFineTuningSpec)

Configuraciones de ajuste fino personalizadas. Si se define SearchRequest.custom_fine_tuning_spec, tiene una prioridad mayor que las configuraciones definidas aquí.
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.
personalizationSpec

object (PersonalizationSpec)

Especificación de la personalización.

Ten en cuenta que, si se definen ServingConfig.personalization_spec y SearchRequest.personalization_spec, SearchRequest.personalization_spec anula ServingConfig.personalization_spec.
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.

Métodos

answer

 Método de respuesta a la consulta.

create

 Crea un recurso ServingConfig.

delete

 Elimina un recurso ServingConfig.

get

 Obtiene un recurso ServingConfig.

list

 Lista todos los ServingConfigs vinculados a este almacén de datos.

patch

 Actualiza un recurso ServingConfig.

recommend

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

searchLite

 Realiza una búsqueda.

streamAnswer

 Método de consulta de respuestas (streaming).