Zelfstudie: Azure AI Zoeken toevoegen aan een C#-web-app in Azure Container Apps

Note

Azure AI Zoeken is beschikbaar via de Azure-portal, REST API's en Azure-SDK's. Het vormt ook een basis voor Foundry IQ, de beheerde kennislaag die bedrijfsinhoud transformeert in herbruikbare, machtigingsbewuste knowledge bases voor agents in de Microsoft Foundry-portal.

In deze zelfstudie wordt een website gebouwd die door een catalogus met boeken zoekt en de website implementeert op Azure Container Apps. De implementatie maakt gebruik van de Azure Developer CLI (azd) en beheerde identiteit als de standaardverificatiemethode voor Azure AI Zoeken.

In deze handleiding leert u:

  • Implementeer Azure AI Zoeken en seed automatisch een index met de Azure Developer CLI.
  • Integreer zoekquery's, suggesties, facetten, paginering en documentzoekopdrachten in de C#-app.
  • Implementeer de app in Azure Container Apps met beheerde identiteit als standaardverificatiemethode.

Wat doet het voorbeeld?

Deze voorbeeldwebsite biedt toegang tot een catalogus van 10.000 boeken. U kunt in de catalogus zoeken door tekst in te voeren in de zoekbalk. Terwijl u tekst invoert, gebruikt de website de suggestiefunctie van de zoekindex om de tekst automatisch aan te vullen.

Wanneer de query is voltooid, geeft de website de lijst met boeken weer met een deel van hun gegevens. U kunt een boek selecteren om de volledige details te bekijken, die zijn opgeslagen in de zoekindex.

Schermopname van de voorbeeld-app in een browservenster.

De zoekervaring omvat:

  • Zoeken : biedt zoekfunctionaliteit voor de toepassing.
  • Suggesties : biedt suggesties als de gebruikerstypen in de zoekbalk.
  • Facetten en filters : biedt een facetnavigatiestructuur die filtert op auteur of taal.
  • Gepagineerde resultaten : biedt pagineringsbesturingselementen voor het bladeren door de resultaten.
  • Documentzoekactie : zoekt een document op basis van id op om alle inhoud van het document op te halen voor de detailpagina.

Hoe is het voorbeeld ingedeeld?

De voorbeeldcode bevat de volgende onderdelen:

App Doel locatie van GitHub opslagplaats
client React-app (presentatielaag) om boeken weer te geven met zoeken. De API wordt aangeroepen. /azure-search-static-web-app/client
api C# Azure Functions-API (bedrijfslaag), gehost in een container op Azure Container Apps, die de Azure AI Zoeken-API aanroept met de .NET SDK. /azure-search-static-web-app/api
bulk-insert .NET project waarmee de index wordt gemaakt en documenten worden geladen. De azd implementatie voert dit automatisch uit via de postprovision hook. /azure-search-static-web-app/bulk-insert
infra Bicep infrastructuur die wordt gebruikt voor azd het implementeren van Azure AI Zoeken, Azure Container Apps en ondersteunende resources. Azure-Samples/azure-search-static-web-app

De ontwikkelomgeving instellen

Installeer de volgende software voor uw lokale ontwikkelomgeving. De azd up opdracht richt alle Azure resources in, inclusief Azure AI Zoeken, zodat u ze niet vooraf hoeft te maken.

In deze zelfstudie wordt de Azure Functions API niet lokaal uitgevoerd. Als u deze lokaal wilt uitvoeren, installeert u Azure Functions Core Tools.

Het zoekvoorbeeld klonen met Git

U kunt het voorbeeld implementeren vanuit een lokale kloon. De azd up opdracht leest de toepassings- en infrastructuurbestanden uit uw lokale opslagplaats, bouwt de containers, richt Azure resources in en implementeert de client en API in Azure Container Apps.

  1. Kloon de voorbeeldtoepassing in een Bash-terminal naar uw lokale computer.

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

  2. Ga in dezelfde Bash-terminal naar de opslagplaatsmap voor dit zoekvoorbeeld.

    cd azure-search-static-web-app

  3. Gebruik de opdracht code .Visual Studio Code om de opslagplaats te openen. Tenzij anders opgegeven, voltooit u de resterende taken in Visual Studio Code.

    code .

Volgende stap

De app implementeren in Azure Container Apps

  • Last updated on