Oktatóanyag: Azure AI Keresés hozzáadása C#-webalkalmazáshoz Azure Container Apps

Note

Azure AI Keresés a Azure portálon, REST API-kon és Azure SDK-k keresztül érhető el. Emellett a Foundry IQ-t is támogatja, amely a vállalati tartalmakat újrafelhasználható, engedélytudatos tudásbázisokká alakítja át az Microsoft Foundry portálon található ügynökök számára.

Ez az oktatóanyag létrehoz egy webhelyet, amely könyvek katalógusán keresztül keres, és üzembe helyezi a webhelyet Azure Container Apps. Az üzembe helyezés a Azure fejlesztői parancssori felületet (azd) és a felügyelt identitást használja az Azure AI Keresés alapértelmezett hitelesítési módszereként.

Ebben az oktatóanyagban a következőket fogja megtanulni:

• Helyezzen üzembe Azure AI Keresés és automatikusan helyezzen üzembe egy indexet a Azure fejlesztői parancssori felülettel.
• Integrálja a keresési lekérdezéseket, javaslatokat, aspektusokat, lapozást és dokumentumkeresést a C# alkalmazásban.
• Az alkalmazás üzembe helyezése felügyelt identitással Azure Container Apps alapértelmezett hitelesítési módszerként.

Mit csinál a minta?

Ez a mintaweboldal 10 000 könyvből álló katalógushoz biztosít hozzáférést. A katalógusban úgy kereshet, hogy szöveget ír be a keresősávba. A szöveg beírása közben a webhely a keresési index javaslati funkciójával automatikusan kitölti a szöveget.

Amikor a lekérdezés befejeződik, a webhely megjeleníti a könyvek listáját a részletek egy részével. Kiválaszthat egy könyvet a teljes részleteinek megtekintéséhez, amelyek a keresési indexben vannak tárolva.

A keresési felület a következőket tartalmazza:

• Keresés – Keresési funkciókat biztosít az alkalmazáshoz.
• Javaslat – Javaslatok a keresősáv felhasználótípusaként.
• Aspektusok és szűrők – Olyan strukturált navigációs struktúrát biztosít, amely szerző vagy nyelv szerint szűr.
• Lapszámozott eredmények – Lapozási vezérlőket biztosít az eredmények görgetéshez.
• Dokumentumkeresés – Megkeres egy dokumentumot azonosító alapján a részletek lap összes tartalmának lekéréséhez.

Hogyan van rendszerezve a minta?

A mintakód a következő összetevőket tartalmazza:

Alkalmazás	Cél	GitHub adattár helye
client	A React alkalmazás (bemutató réteg) a könyvek kereséssel való megjelenítéséhez. Meghívja az API-t.	/azure-search-static-web-app/client
api	A Azure Container Apps tárolóban üzemeltetett C# Azure Functions API (üzleti réteg), amely meghívja a Azure AI Keresés API-t a .NET SDK-val.	/azure-search-static-web-app/api
bulk-insert	.NET projekt, amely létrehozza az indexet, és betölti a dokumentumokat. Az azd üzembe helyezés ezt automatikusan futtatja a postprovision horogon keresztül.	/azure-search-static-web-app/bulk-insert
infra	Bicep Azure AI Keresés, Azure Container Apps és támogató erőforrások üzembe helyezéséhez használt azd infrastruktúra.	Azure-Samples/azure-search-static-web-app

A fejlesztési környezet beállítása

Telepítse a következő szoftvert a helyi fejlesztési környezethez. A azd up parancs minden Azure erőforrást kiépít, beleértve a Azure AI Keresés is, így nem kell előzetesen létrehoznia őket.

• 9-.NET vagy újabb
• Git
• Visual Studio Code
• C# Dev Tools-bővítmény a Visual Studio Code-hoz
• Azure fejlesztői parancssori felület (azd)
• Docker Desktop vagy más Docker-kompatibilis tároló-futtatókörnyezet

Ez az oktatóanyag nem futtatja helyileg a Azure Functions API-t. Ha helyileg szeretné futtatni, telepítse Azure Functions Core Tools eszközt.

A keresési minta klónozása a Gittel

A mintát helyi klónból is üzembe helyezheti. A azd up parancs beolvassa az alkalmazás- és infrastruktúrafájlokat a helyi adattárból, létrehozza a tárolókat, kiépít Azure erőforrásokat, és üzembe helyezi az ügyfelet és az API-t a Azure Container Apps.

1. Egy Bash-terminálban klónozza a mintaalkalmazást a helyi számítógépre.

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

2. Ugyanabban a Bash-terminálban nyissa meg a keresési példa adattárkönyvtárát.

   cd azure-search-static-web-app
   

3. Az adattár megnyitásához használja a Visual Studio Code parancsotcode .. Ha másként nincs megadva, a fennmaradó feladatokat a Visual Studio Code hajtja végre.

   code .
   

Következő lépés

Az alkalmazás üzembe helyezése Azure Container Apps szolgáltatásba