Configuración del clasificador semántico y los subtítulos devueltos en los resultados de la búsqueda

La clasificación semántica recorre en iteración un conjunto de resultados inicial, aplicando una metodología de clasificación L2 que promueve los resultados más semánticamente relevantes en la parte superior de la pila. También puede obtener leyendas semánticas, con los términos y las frases más relevantes resaltados, además de respuestas semánticas.

En este artículo se explica cómo configurar un índice de búsqueda para el cambio semántico.

Nota:

Si tiene código existente que llama a la versión preliminar o versiones anteriores de la API, consulte Migrar código de clasificación semántica para obtener ayuda para modificar el código.

Requisitos previos

• Un servicio de búsqueda en un nivel básico o superior, sujeto a la disponibilidad de la región.

• Clasificador semántico habilitado en el servicio de búsqueda.

• Índice de búsqueda existente con contenido de texto enriquecido. La clasificación semántica se aplica a los campos de cadenas (no vectoriales) y funciona mejor en el contenido que es informativo o descriptivo.

Elija un cliente

Puede especificar una configuración semántica en índices nuevos o existentes mediante cualquiera de las siguientes herramientas y kits de desarrollo de software (SDK) para agregar una configuración semántica:

• Azure Portal, mediante el diseñador de índices para agregar una configuración semántica.
• Código Visual Studio con el cliente REST y un Crear o Actualizar Índice (REST) API.
• SDK de Azure para .NET
• SDK de Azure para Python
• SDK de Azure para Java
• Azure SDK para JavaScript

Adición de una configuración semántica

Una configuración semántica es una sección del índice que establece entradas de campo para la clasificación semántica. Puedes agregar o actualizar una configuración semántica en cualquier momento sin necesidad de recompilar. Si creas varias configuraciones, puedes especificar un valor predeterminado. En el momento de la consulta, especifica una configuración semántica en una solicitud de consulta o déjala en blanco para usar el valor predeterminado.

Una configuración semántica tiene un nombre y las siguientes propiedades:

Propiedad	Características
Campo Título	Una cadena corta, idealmente por debajo de 25 palabras. Este campo podría ser el título de un documento, el nombre de un producto o un identificador único. Si no tienes un campo adecuado, déjalo en blanco.
Campos de contenido	Fragmentos más largos de texto en formato de lenguaje natural, sujeto a límites máximos de entrada de token en los modelos de Machine Learning. Algunos ejemplos comunes de contenido son el cuerpo de un documento, la descripción de un producto u otro texto de formato libre.
Campos de palabra clave	Una lista de palabras clave, como las etiquetas de un documento o un término descriptivo, como la categoría de un elemento.

Solo puedes especificar un campo de título, pero puedes tener tantos campos de contenido y palabra clave como quieras. Enumera estos campos en orden de prioridad, ya que los campos de prioridad inferior pueden truncarse.

En todas las propiedades de configuración semántica, los campos que asignes deben ser:

• Atributos como searchable y retrievable
• Cadenas de tipo Edm.String, Collection(Edm.String), subcampos de cadena de Edm.ComplexType

Azure Portal

1. Inicia sesión en Azure Portal y ve al servicio de búsqueda que tiene la clasificación semántica habilitada.

2. En Índices en el panel de navegación de la izquierda, seleccione un índice.

3. Seleccione Configuraciones semánticas y después Agregar configuración semántica.

   

4. En la página Nueva configuración semántica, escriba un nombre de configuración semántica y seleccione los campos que se van a usar en ella. Solo los campos de cadena que se pueden buscar y recuperar son aptos. Asegúrese de enumerar los campos de contenido y los campos de palabra clave en orden de prioridad.

   

5. Seleccione Guardar para guardar la configuración.

6. Vuelva a seleccionar Guardar en la página de índice para guardar la configuración semántica en el índice.

REST API

1. Formule una solicitud Crear o actualizar índice.

2. Agregue una configuración semántica a la definición de índice, quizás después de scoringProfiles o de suggesters. Especificar un valor predeterminado es opcional pero útil si tienes más de una configuración.

   "semantic": {
       "defaultConfiguration": "my-semantic-config-default",
       "configurations": [
           {
               "name": "my-semantic-config-default",
               "prioritizedFields": {
                   "titleField": {
                       "fieldName": "HotelName"
                   },
                   "prioritizedContentFields": [
                       {
                           "fieldName": "Description"
                       }
                   ],
                   "prioritizedKeywordsFields": [
                       {
                           "fieldName": "Tags"
                       }
                   ]
               }
           },
                       {
               "name": "my-semantic-config-desc-only",
               "prioritizedFields": {
                   "prioritizedContentFields": [
                       {
                           "fieldName": "Description"
                       }
                   ]
               }
           }
       ]
   }
   

SDK de .NET

Usa la clase SemanticConfiguration en el SDK de Azure para .NET.

El ejemplo siguiente procede del ejemplo de clasificación semántica creado por el equipo de Azure SDK.

string indexName = "hotel";
SearchIndex searchIndex = new(indexName)
{
    Fields =
    {
        new SimpleField("HotelId", SearchFieldDataType.String) { IsKey = true, IsFilterable = true, IsSortable = true, IsFacetable = true },
        new SearchableField("HotelName") { IsFilterable = true, IsSortable = true },
        new SearchableField("Description") { IsFilterable = true },
        new SearchableField("Category") { IsFilterable = true, IsSortable = true, IsFacetable = true },
    },
    SemanticSearch = new()
    {
        Configurations =
        {
            new SemanticConfiguration("my-semantic-config", new()
            {
                TitleField = new SemanticField("HotelName"),
                ContentFields =
                {
                    new SemanticField("Description")
                },
                KeywordsFields =
                {
                    new SemanticField("Category")
                }
            })
        }
    }
};

Pasos siguientes

Pruebe la configuración semántica mediante la ejecución de una consulta semántica.

Creación de consultas semánticas