Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Note
Foundry IQ (Búsqueda de Azure AI) proporciona API directas de indexación y consulta junto con las API de origen de conocimiento y base de conocimiento de nivel superior para la recuperación administrada. Use el portal de Azure, las API REST o SDK de Azure para configurar estas funcionalidades o conectar agentes a las bases de conocimiento en el portal de Microsoft Foundry.
Implemente el sitio web habilitado para la búsqueda en Azure Container Apps mediante la CLI para desarrolladores de Azure (azd). Esta implementación incluye el cliente de React, la API de .NET, Foundry IQ, la identidad administrada y los recursos de Azure auxiliares.
La implementación usa la identidad administrada como método de autenticación predeterminado para Foundry IQ. Puede optar por la autenticación basada en claves estableciendo USE_KEYLESS_AUTH en false antes de la implementación.
Iniciar sesión en Azure
En Visual Studio Code, abra un terminal en la raíz del repositorio, como
azure-search-static-web-app.Inicie sesión en Azure mediante
azd.azd auth loginSi el explorador lo solicita, complete el flujo de inicio de sesión con la cuenta de Azure que usa para este tutorial.
Cree un entorno azd
Cree un
azdentorno. Reemplace porYOUR-ENVIRONMENT-NAMEun nombre corto que identifique esta implementación del tutorial.azd env new YOUR-ENVIRONMENT-NAME
(Opcional) Configurar la autenticación basada en claves
El método de autenticación predeterminado es identidad administrada, por lo que la mayoría de los entornos pueden omitir esta sección. Complete esta sección solo si tu entorno requiere claves de API.
Establece USE_KEYLESS_AUTH en false.
azd env set USE_KEYLESS_AUTH false
Si no establece USE_KEYLESS_AUTH, la implementación usa la identidad administrada. La infraestructura de Bicep concede acceso a la identidad de la aplicación contenedora al plano de datos Foundry IQ.
Implementa con azd up
Desde la raíz del repositorio, ejecute
azd up.azd upCuando se le solicite, seleccione la suscripción Azure y la ubicación de los recursos.
Espere a que
azdaprovisione la infraestructura, compile los contenedores, inserte las imágenes e implemente los servicios en Azure Container Apps.Revise la salida después de la implementación. La salida incluye los nombres de dominio completos (FQDN) de cliente y servidor para la implementación de Azure Container Apps.
AZURE_CLIENT_URL: <client-container-app-fqdn> AZURE_SERVER_URL: <server-container-app-fqdn> SEARCH_SERVICE_NAME: <search-service-name>Use el valor
AZURE_CLIENT_URLpara abrir el sitio web. La aplicación cliente llama a la aplicación de servidor a través del punto de conexión configurado durante la implementación.La implementación también creó el servicio Foundry IQ y cargó el
good-booksíndice automáticamente a través delpostprovisionenlace en el repositorio de ejemplo.
Uso de la búsqueda en el sitio web de Container Apps
Abra el FQDN del cliente desde la salida de
azd upen un explorador.En la barra de búsqueda del sitio web, escriba una consulta de búsqueda, como
code. La función de autocompletar sugiere títulos de libros coincidentes.Seleccione una sugerencia o continúe escribiendo su propia consulta. Seleccione Enter cuando termine de escribir la consulta de búsqueda.
Revise los resultados y, a continuación, seleccione un libro para ver más detalles.
Troubleshooting
Si la aplicación web no se implementa ni funciona, use la siguiente lista para determinar y corregir el problema:
¿Se completó
azd up?Revise la
azd upsalida del primer paso de aprovisionamiento, compilación o implementación con errores. Si la implementación se detiene durante el aprovisionamiento, compruebe los permisos de suscripción y la región seleccionada. Si la implementación se detiene durante los pasos de compilación o implementación del contenedor, vuelva a ejecutarazd updespués de corregir el problema notificado.¿Puede abrir el punto de conexión de cliente?
Abra el valor
AZURE_CLIENT_URLde la salida deazd up. Si la página no se carga, vaya al portal de Azure, abra la aplicación contenedora cliente y revise su estado de revisión y los registros.¿El cliente puede llamar al punto de conexión del servidor?
Abra las herramientas de desarrollo del explorador y revise las llamadas de red desde la aplicación cliente. Si se produce un error en las llamadas a la API, confirme que la aplicación contenedora del servidor se está ejecutando y que la aplicación cliente recibió el FQDN del servidor durante la implementación.
¿Puede el servidor consultar Foundry IQ?
Si las búsquedas devuelven errores, revise los registros de la aplicación contenedora del servidor. Para la identidad administrada, confirme que la identidad tiene acceso al plano de datos de Foundry IQ. Para la autenticación basada en claves, confirme que estableció
USE_KEYLESS_AUTHenfalseantes de la implementación y que el entorno de contenedor generado contiene la configuración del servicio Foundry IQ.
Limpieza de recursos
Use azd down --purge para eliminar los recursos de Azure creados en este tutorial. La --purge marca quita permanentemente los recursos que admiten la eliminación temporal, en lugar de dejarlos en un estado recuperable durante su período de retención. La purga evita conflictos de nomenclatura si vuelve a implementar este tutorial más adelante.
En la raíz del repositorio, ejecute el comando clean-up.
azd down --purgeRevise los recursos que
azdenumera.Cuando se le solicite, confirme la eliminación.
Si creó un servicio Foundry IQ fuera de la azd implementación, vaya al servicio Foundry IQ en el portal de Azure y seleccione Eliminar en la parte superior de la página.