REST Resource: projects.locations.dataStores.servingConfigs

• Recurso: ServingConfig
  • Representación JSON
• Métodos

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, "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).
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.
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.
search	Realiza una búsqueda.
searchLite	Realiza una búsqueda.
streamAnswer	Método de consulta de respuestas (streaming).