Tutorial: Adición de Búsqueda de Azure AI a una aplicación web de C# en Azure Container Apps

Note

Búsqueda de Azure AI está disponible a través del portal de Azure, las API REST y los SDK de Azure. También respalda Foundry IQ, la capa de conocimiento administrada que transforma el contenido empresarial en bases de conocimiento reutilizables y compatibles con permisos para agentes en el portal de Microsoft Foundry.

En este tutorial se crea un sitio web que busca en un catálogo de libros e implementa el sitio web en Azure Container Apps. La implementación usa la CLI de Azure Developer (azd) y la identidad administrada como método de autenticación predeterminado para Búsqueda de Azure AI.

En este tutorial, usted hará lo siguiente:

  • Implementar Búsqueda de Azure AI e inicializar automáticamente un índice con Azure Developer CLI.
  • Integre consultas de búsqueda, sugerencias, facetas, paginación y búsqueda de documentos en la aplicación de C#.
  • Implemente la aplicación en Azure Container Apps con identidad administrada como método de autenticación predeterminado.

¿Qué hace la muestra?

En este sitio web de ejemplo se proporciona acceso a un catálogo de 10 000 libros. Puede buscar en el catálogo escribiendo un texto en la barra de búsqueda. Mientras escribe el texto, el sitio web usa la característica de sugerencias del índice de búsqueda para autocompletar el texto.

Cuando finaliza la consulta, el sitio web muestra la lista de libros con una parte de sus detalles. Puede seleccionar un libro para ver sus detalles completos, que se almacenan en el índice de búsqueda.

Captura de pantalla de la aplicación de ejemplo en la que se muestran los resultados de búsqueda para perros, con facetas de autor y lenguaje y controles de paginación.

La experiencia de búsqueda incluye:

  • Buscar : proporciona funcionalidad de búsqueda para la aplicación.
  • Sugerir - Proporciona sugerencias mientras el usuario escribe en la barra de búsqueda.
  • Facetas y filtros : proporciona una estructura de navegación por facetas que filtra por autor o lenguaje.
  • Resultados paginados : proporciona controles de paginación para desplazarse por los resultados.
  • Búsqueda de documentos: busca un documento por identificador para recuperar todo su contenido para la página de detalles.

¿Cómo se organiza la muestra?

El código de ejemplo incluye los siguientes componentes:

Aplicación Propósito ubicación del repositorio de GitHub
client Aplicación React (capa de presentación) para mostrar libros con búsqueda. Llama a la API. /azure-search-static-web-app/client
api API de Azure Functions en C# (capa de negocio), alojada en un contenedor de Azure Container Apps, que invoca la API de Búsqueda de Azure AI con el SDK de .NET. /azure-search-static-web-app/api
bulk-insert .NET proyecto que crea el índice y carga documentos. La azdimplementación ejecuta esto automáticamente a través del postprovisiongancho. /azure-search-static-web-app/bulk-insert
infra Infraestructura de Bicep utilizada por azd para implementar Búsqueda de Azure AI, Azure Container Apps y recursos de apoyo. Azure-Samples/azure-search-static-web-app

Configure su entorno de desarrollo

Instale el siguiente software para el entorno de desarrollo local. El azd up comando aprovisiona todos los recursos Azure, incluidos los Búsqueda de Azure AI, por lo que no es necesario crearlos de antemano.

Este tutorial no ejecuta la API de Azure Functions localmente. Si quiere ejecutarlo localmente, instale Azure Functions Core Tools.

Clonación del ejemplo de búsqueda con Git

Puede implementar el ejemplo desde un clon local. El azd up comando lee los archivos de infraestructura y aplicación del repositorio local, compila los contenedores, aprovisiona Azure recursos e implementa el cliente y la API en Azure Container Apps.

  1. En un terminal de Bash, clone la aplicación de ejemplo en el equipo local.

    git clone https://github.com/Azure-Samples/azure-search-static-web-app.git

  2. En el mismo terminal de Bash, vaya al directorio del repositorio para este ejemplo de búsqueda.

    cd azure-search-static-web-app

  3. Use el comando Visual Studio Code , code .para abrir el repositorio. A menos que se especifique lo contrario, complete las tareas restantes en Visual Studio Code.

    code .

Paso siguiente

Implementación de la aplicación en Azure Container Apps

  • Last updated on