Configurar clasificador semántico y devolver títulos en los resultados de 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 subtítulos semánticos, con resaltados sobre los términos y frases más relevantes, y respuestas semánticas.

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

Requisitos previos

• Búsqueda de Azure AI en cualquier región que ofrezca clasificación semántica.

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

• Permiso para crear y usar objetos en Búsqueda de Azure AI. Se recomienda el acceso basado en roles, pero puede usar claves de API si una asignación de roles no es factible. Para obtener más información, consulte Conexión a un servicio de búsqueda.

• La versión 2026-08-01-preview de la API REST del servicio de búsqueda.

Elección de 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.
• Visual Studio Code con el cliente REST y una API de Crear o Actualizar Índice (REST).
• SDK de Azure para .NET
• SDK de Azure para Python
• SDK de Azure para Java
• SDK de Azure para JavaScript

Adición de una configuración semántica

Algunas cargas de trabajo crean automáticamente una configuración semántica. Si utiliza la recuperación de agentes y un origen de conocimientos que indexa contenido en Búsqueda de Azure AI, el índice generado ya tiene una configuración semántica que se adapta a su contenido.

Para otras cargas de trabajo, puede configurar una configuración semántica usted mismo. Una configuración semántica es una sección del índice que establece las entradas de campo usadas para la clasificación semántica. Puede agregar o actualizar una configuración semántica en cualquier momento, sin necesidad de recompilar. Si crea varias configuraciones, puede especificar un valor predeterminado. En el momento de la consulta, especifique una configuración semántica en una solicitud de consulta o déjela en blanco para usar el valor predeterminado.

Puede crear hasta 100 configuraciones semánticas en un único índice.

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

Solo puede especificar un campo de título, pero puede tener tantos campos de contenido y palabra clave como desee. En el caso de los campos de contenido y palabra clave, enumere los campos en orden de prioridad porque los campos de prioridad inferior podrían truncarse.

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

• Con atributos como searchable y retrievable
• Cadenas de tipo Edm.String, Collection(Edm.String), subcampos de cadenas de Edm.ComplexType

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")
                }
            })
        }
    }
};

Aceptar los modelos de clasificación semántica en versión preliminar (versión preliminar)

Con API REST en versión preliminar y los SDK de Azure en versión preliminar que proporcionan esta propiedad, puede configurar opcionalmente un índice para usar modelos de clasificación semántica en versión preliminar si hay alguno implementado en su región. No hay ningún mecanismo para saber si hay disponible una versión preliminar o si se usó en una consulta específica. Por este motivo, se recomienda usar esta propiedad en entornos de prueba y solo si está interesado en probar los modelos de clasificación semántica más recientes.

La propiedad de configuración es "flightingOptIn": truey se establece en la sección de configuración semántica de un índice. La propiedad es null o false de manera predeterminada. Puede establecerlo en verdadero en una solicitud de creación o actualización en cualquier momento, y a partir de ahí afectará a las consultas semánticas en el futuro, siempre que la consulta estipule una configuración semántica que incluya la propiedad.

PUT https://myservice.search.windows.net/indexes('hotels')?allowIndexDowntime=False&api-version=2026-08-01-preview

{
  "name": "hotels",
  "fields": [ ],
  "scoringProfiles": [ ],
  "defaultScoringProfile": "geo",
  "suggesters": [ ],
  "analyzers": [ ],
  "corsOptions": { },
  "encryptionKey": { },
  "similarity": { },
  "semantic": {
    "configurations": [
      {
        "name": "semanticHotels",
        "prioritizedFields": {
          "titleField": {
            "fieldName": "hotelName"
          },
        "prioritizedContentFields": [
            {
              "fieldName": "description"
            },
            {
              "fieldName": "description_fr"
            }
          ],
        "prioritizedKeywordsFields": [
            {
              "fieldName": "tags"
            },
            {
              "fieldName": "category"
            }
          ],
        "flightingOptIn": true
        }
      }
    ]
  },
  "vectorSearch": {  }
}

Pasos siguientes

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