Självstudie: Lägga till Azure AI-sökning i en C#-webbapp på Azure Container Apps

Note

Azure AI-sökning är tillgängligt via Azure-portalen, REST-API:er och Azure-SDK:er. Den ligger också till grund för Foundry IQ, det hanterade kunskapsskiktet som omvandlar företagsinnehåll till återanvändbara, behörighetsmedvetna kunskapsbaser för agenter i Microsoft Foundry-portalen.

Den här självstudien visar hur du skapar en webbplats som söker igenom en bokkatalog och distribuerar den till Azure Container Apps. Distributionen använder Azure Developer CLI (azd) och hanterad identitet som standardautentiseringsmetod för Azure AI-sökning.

I den här handledningen kommer du att:

  • Distribuera Azure AI-sökning och automatiskt seeda ett index med Azure Developer CLI.
  • Integrera sökfrågor, förslag, fasetter, sidnumrering och dokumentsökning i C#-appen.
  • Distribuera appen till Azure Container Apps med hanterad identitet som standardautentiseringsmetod.

Vad gör exemplet?

Den här exempelwebbplatsen ger åtkomst till en katalog med 10 000 böcker. Du kan söka i katalogen genom att ange text i sökfältet. När du anger text använder webbplatsen sökindexets förslagsfunktion för att komplettera texten automatiskt.

När frågan är klar visar webbplatsen listan över böcker med en del av deras information. Du kan välja en bok för att se fullständig information som lagras i sökindexet.

Skärmbild av exempelappen som visar sökresultat för hund, med redigerings- och språkfasetter och sidnumreringskontroller.

Sökupplevelsen omfattar:

  • Sök – Ger sökfunktioner för programmet.
  • Förslag – Ger förslag när användaren skriver i sökfältet.
  • Fasetter och filter – Ger en fasetterad navigeringsstruktur som filtrerar efter författare eller språk.
  • Sidindelade resultat – Ger sidnavigeringskontroller för att bläddra genom resultaten.
  • Dokumentsökning – Söker efter ett dokument efter ID för att hämta allt dess innehåll för informationssidan.

Hur organiseras provet?

Exempelkoden innehåller följande komponenter:

App Syfte GitHub lagringsplats
client React-appen (presentationsskiktet) för att visa böcker med sökning. Det anropar API:et. /azure-search-static-web-app/client
api C# Azure Functions API (affärslager), som körs i en container på Azure Container Apps och anropar API:et för Azure AI-sökning med .NET SDK:t. /azure-search-static-web-app/api
bulk-insert .NET projekt som skapar indexet och läser in dokument. Distributionen azd kör detta automatiskt via kroken postprovision . /azure-search-static-web-app/bulk-insert
infra Bicep-infrastruktur som används av azd för att distribuera Azure AI-sökning, Azure Container Apps och stödresurser. Azure-Samples/azure-search-static-web-app

Konfigurera utvecklingsmiljön

Installera följande programvara för din lokala utvecklingsmiljö. Kommandot azd up etablerar alla Azure resurser, inklusive Azure AI-sökning, så du behöver inte skapa dem i förväg.

I den här självstudien körs inte Azure Functions API lokalt. Om du vill köra den lokalt installerar du Azure Functions Core Tools.

Klona sökexemplet med Git

Du kan distribuera exemplet från en lokal klon. Kommandot azd up läser program- och infrastrukturfilerna från din lokala lagringsplats, skapar containrar, etablerar Azure resurser och distribuerar klienten och API:et till Azure Container Apps.

  1. I en Bash-terminal klonar du exempelprogrammet till den lokala datorn.

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

  2. I samma Bash-terminal går du till lagringsplatskatalogen för det här sökexemplet.

    cd azure-search-static-web-app

  3. Använd kommandot Visual Studio Code, code ., för att öppna lagringsplatsen. Om inget annat anges slutför du de återstående uppgifterna i Visual Studio Code.

    code .

Nästa steg

Distribuera appen till Azure Container Apps

  • Last updated on