Inicio rápido: Uso del Explorador de búsqueda para ejecutar consultas en el portal de Azure

En este inicio rápido, aprenderá a usar Search explorer, una herramienta de consulta integrada en el portal de Azure para ejecutar consultas en un índice de Búsqueda de Azure AI. Use esta herramienta para probar una consulta o una expresión de filtro o para confirmar si el contenido existe en el índice.

En este inicio rápido se usa un índice existente para mostrar el Explorador de búsqueda.

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.

• Un servicio Búsqueda de Azure AI. Crear un servicio o finar un servicio existente en la suscripción actual. Para este inicio rápido, puede usar un servicio gratuito.

• En este inicio rápido se usa el índice hotels-sample. Siga las instrucciones de este inicio rápido para crear el índice.

Iniciar el Explorador de búsqueda

1. Vaya al servicio de búsqueda en el portal Azure.

2. En el panel izquierdo, seleccione Información general.

3. En la barra de comandos, seleccione Explorador de búsqueda.

   

   Como alternativa, seleccione la pestaña Explorador de búsqueda en la página de índice.

Consulta de tres maneras

Hay tres enfoques para consultar en el Explorador de búsqueda:

• La vista de consulta proporciona una barra de búsqueda predeterminada. Acepta una consulta vacía o una consulta de texto libre con booleanos, como ocean view + parking.

• La vista de imagen proporciona una ventana para examinar o arrastrar y colocar archivos PNG, JPG o JPEG. A menos que el índice tenga un vectorizador de imagen y una aptitud equivalente, esta vista no está disponible.

• La vista JSON admite consultas con parámetros. Los filtros, orderby, select, count, searchFields y todos los demás parámetros deben establecerse en la vista JSON.

  

Ejemplo: Consulta de imagen

El Explorador de búsqueda acepta imágenes como entradas de consulta a través de la vista de imagen, lo que requiere que use un par compatible de vectorizador y habilidad. Para obtener más información, vea Configurar un vectorizador en un índice de búsqueda.

El índice hotels-sample no está configurado para la vectorización de imágenes. Si desea ejecutar consultas de imagen, cree un índice como se describe en Quickstart: Búsqueda vectorial en el portal de Azure. El inicio rápido se basa en datos de ejemplo basados en texto, por lo que debe usar documentos que contengan imágenes.

Para ejecutar una consulta de imagen, seleccione o arrastre una imagen al área de búsqueda y, a continuación, seleccione Buscar. El Explorador de búsqueda vectoriza la imagen y envía el vector al motor de búsqueda para la ejecución de consultas. El motor de búsqueda devuelve documentos que son lo suficientemente similares a la imagen de entrada, hasta el número especificado k de resultados.

Ejemplos: consultas JSON

A continuación se muestran ejemplos de consultas JSON que puede ejecutar mediante el Explorador de búsqueda. Para seguir estos ejemplos, cambie a la vista JSON. Puede pegar cada ejemplo JSON en el área de texto.

Ejecución de una consulta no especificada

En el Explorador de búsqueda, las solicitudes POST se formulan internamente mediante Documents - Search Post (API REST), con respuestas devueltas como documentos JSON detallados.

Para ver primero el contenido, ejecute una búsqueda vacía seleccionando Buscar sin términos proporcionados. Una búsqueda vacía es útil como primera consulta porque devuelve documentos completos para que pueda revisar la composición del documento. En una búsqueda vacía, no hay ninguna puntuación de búsqueda y los documentos se devuelven en orden arbitrario ("@search.score": 1 para todos los documentos). De forma predeterminada, se devuelven 50 documentos por solicitud de búsqueda.

Agregue "count": true para obtener el número de coincidencias encontradas en un índice. En una búsqueda vacía, el recuento es el número total de documentos del índice. En una búsqueda calificada, es el número de documentos que coinciden con la entrada de consulta. Recuerde que el servicio devuelve las 50 principales coincidencias de forma predeterminada, por lo que el recuento podría indicar más coincidencias en el índice que las devueltas en los resultados.

La sintaxis equivalente de una búsqueda vacía es * o "search": "*".

{
   "search": "*",
   "count": true
}

Resultados

Ejecución de una consulta de texto libre

La búsqueda de forma libre, con o sin operadores, es útil para simular consultas definidas por el usuario enviadas desde una aplicación personalizada a Búsqueda de Azure AI. Solo se examinan los campos marcados como buscables en el índice para encontrar coincidencias.

No necesita la vista JSON para una consulta de texto libre, pero se proporciona en JSON para mantener la coherencia con otros ejemplos de este artículo.

Tenga en cuenta que, al proporcionar criterios de búsqueda, como términos de consulta o expresiones, la clasificación de búsqueda entra en juego. En el ejemplo siguiente se muestra una búsqueda de texto libre. La @search.score es una puntuación de relevancia calculada para la correspondencia mediante el algoritmo predeterminado de puntuación.

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast"
}

Resultados

Puede usar Ctrl-F para buscar en los resultados términos de interés específicos.

Limitar campos en los resultados de la búsqueda

Agregue "select" para limitar los resultados a los campos con nombre explícito para obtener una salida más legible en el Explorador de búsqueda. Solo los campos que se atribuyen como recuperables en el índice pueden aparecer en los resultados.

{
   "search": "activities `outdoor pool` restaurant OR continental breakfast",
   "count": true,
   "select": "HotelId, HotelName, Tags, Description"
}

Resultados

Devolver el siguiente lote de resultados

Búsqueda de Azure AI devuelve las 50 coincidencias principales en función del rango de búsqueda. El índice hotels-sample solo tiene 50 hoteles, por lo que usamos un número menor para ilustrar la paginación. Para obtener el siguiente conjunto de documentos coincidentes, anexe "top": 20 y "skip": 10 aumente el conjunto de resultados a 20 documentos (el valor predeterminado es 50, el máximo es 1000), omitiendo los primeros 10 documentos. Puede comprobar la clave del documento (HotelId) para identificar un documento.

Recuerde que debe proporcionar criterios de búsqueda, como un término o expresión de consulta, para obtener resultados clasificados. Las puntuaciones de búsqueda disminuyen cuanto más profundiza en los resultados de búsqueda.

{
   "search": "activities `outdoor pool` restaurant OR continental breakfast",
   "count": true,
   "select": "HotelId, HotelName, Tags, Description",
   "top": 20,
   "skip": 10
}

Resultados

Expresiones de filtro (mayor que, menor que, igual a)

Use el filter parámetro para especificar criterios de inclusión o exclusión. El campo se debe atribuir como filtrable en el índice. En este ejemplo se buscan clasificaciones superiores a cuatro:

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast",
    "count": true,
    "select": "HotelId, HotelName, Tags, Description, Rating",
    "filter": "Rating gt 4"
}

Resultados

Ordenar los resultados

Agregue orderby para ordenar los resultados por otro campo además de la puntuación de búsqueda. El campo se debe atribuir como ordenable en el índice. En situaciones en las que el valor filtrado es idéntico (por ejemplo, el mismo precio), el orden es arbitrario, pero puede agregar más criterios para una ordenación más profunda. Esta es una expresión de ejemplo que puede usar para probar esto:

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast",
    "count": true,
    "select": "HotelId, HotelName, Tags, Description, Rating, LastRenovationDate",
    "filter": "Rating gt 4",
    "orderby": "LastRenovationDate desc"
}

Resultados

Conclusiones

En este inicio rápido, ha usado el Explorador de búsqueda para consultar un índice mediante la API REST.

• Los resultados se devuelven como documentos JSON detallados para que pueda ver la construcción y el contenido de cada documento en su totalidad. El select parámetro de una expresión de consulta limita los campos que se devuelven.

• Los resultados de la búsqueda se componen de todos los campos que se atribuyen como recuperables en el índice. Seleccione la pestaña Campos para revisar los atributos.

• La búsqueda de palabras clave, similar a lo que puede escribir en un explorador web comercial, es útil para probar una experiencia del usuario final. Por ejemplo, suponiendo que el índice hotels-sample, puedes escribir "activities 'outdoor pool' restaurant OR continental breakfast", y a continuación, puedes usar Ctrl-F para buscar términos dentro de los resultados de búsqueda.

• Las expresiones de consulta y filtro se articulan en una sintaxis implementada por Búsqueda de Azure AI. El valor predeterminado es una sintaxis simple, pero opcionalmente puede usar Lucene completo para consultas más eficaces. Las expresiones de filtro se articulan en una sintaxis de OData.

Limpieza de recursos

Cuando trabaja en su propia suscripción, es una buena idea finalizar un proyecto quitando los recursos que ya no necesita. Los recursos que quedan en ejecución te pueden costar dinero.

En el portal de Azure, seleccione Todos los recursos o Grupos de recursos en el panel izquierdo para buscar y administrar recursos. Puede eliminar recursos individualmente o eliminar el grupo de recursos para quitar todos los recursos a la vez.

Si usa un servicio de búsqueda gratuito, recuerde que está limitado a tres índices, indexadores y orígenes de datos. Puede eliminar elementos individuales en el portal para que permanezcan por debajo del límite.

Paso siguiente

Para más información sobre las estructuras de consulta y la sintaxis, use un cliente REST para crear expresiones de consulta que usen más partes de la API REST. Documents - Search Post (API REST) es especialmente útil para el aprendizaje y la exploración.