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 bygger en webbplats som söker igenom en katalog med böcker och distribuerar webbplatsen 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 i ett webbläsarfönster.

Sökupplevelsen omfattar:

  • Sök – Ger sökfunktioner för programmet.
  • Föreslå – Innehåller förslag som användartyper i sökfältet.
  • Fasetter och filter – Ger en fasetterad navigeringsstruktur som filtrerar efter författare eller språk.
  • Sidnumrerade resultat – Ger växlingskontroller för rullning genom resultat.
  • 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. Den anropar API:et. /azure-search-static-web-app/client
api C# Azure Functions API (affärslager), som finns i en container på Azure Container Apps, som anropar Azure AI-sökning-API:et med .NET SDK. /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.

Den här självstudien kör 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