C# Azure AI Keresés-alkalmazás üzembe helyezése 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.

A Azure fejlesztői parancssori felület (azdCLI) használatával helyezze üzembe a keresésre alkalmas webhelyet a Azure Container Apps. Ez az üzembe helyezés magában foglalja a React-ügyfelet, a .NET API-t, a Azure AI Keresés, a felügyelt identitást és a Azure erőforrások támogatását.

Az üzembe helyezés a felügyelt identitást használja az Azure AI Keresés alapértelmezett hitelesítési módszereként. A kulcsalapú hitelesítést az üzembe helyezés előtt állíthatja be USE_KEYLESS_AUTHfalse .

Bejelentkezés az Azure-ba

  1. A Visual Studio Code nyisson meg egy terminált az adattár gyökerénél, példáulazure-search-static-web-app.

  2. Az Azure-ba való bejelentkezéshez használja a azd elemet.

    azd auth login

  3. Ha a böngésző kéri, fejezze be a bejelentkezési folyamatot az oktatóanyaghoz használt Azure fiókkal.

Azd-környezet létrehozása

  • Hozzon létre egy azd környezetet. Cserélje le YOUR-ENVIRONMENT-NAME az oktatóanyag üzembe helyezését azonosító rövid névre.

    azd env new YOUR-ENVIRONMENT-NAME

(Nem kötelező) Kulcsalapú hitelesítés konfigurálása

Az alapértelmezett hitelesítési módszer a felügyelt identitás, így a legtöbb környezet kihagyhatja ezt a szakaszt. Ezt a szakaszt csak akkor végezze el, ha a környezethez API-kulcsok szükségesek.

Állítsa be USE_KEYLESS_AUTH-t false-re.

azd env set USE_KEYLESS_AUTH false

Ha nincs beállítva USE_KEYLESS_AUTH, az üzembe helyezés felügyelt identitást használ. A Bicep infrastruktúra hozzáférést biztosít a tárolóalkalmazás identitásának a Azure AI Keresés adatsíkhoz.

Üzembe helyezés az azd up használatával

  1. Az adattár gyökerében futtassa a azd up parancsot.

    azd up

  2. Amikor a rendszer kéri, válassza ki az erőforrások Azure előfizetését és helyét.

  3. azd Várjon, amíg kiépítheti az infrastruktúrát, létrehozhatja a tárolókat, leküldi a rendszerképeket, és üzembe helyezheti a szolgáltatásokat Azure Container Apps.

  4. Tekintse át a kimenetet az üzembe helyezés után. A kimenet tartalmazza az ügyfél és a kiszolgáló teljes tartományneveit (FQDN-eket) a Azure Container Apps üzembe helyezéséhez.

    AZURE_CLIENT_URL: <client-container-app-fqdn>
AZURE_SERVER_URL: <server-container-app-fqdn>
SEARCH_SERVICE_NAME: <search-service-name>

    Használja az AZURE_CLIENT_URL értéket a webhely megnyitásához. Az ügyfélalkalmazás az üzembe helyezés során konfigurált végponton keresztül hívja meg a kiszolgálóalkalmazást.

    Az üzembe helyezés létrehozta a Azure AI Keresés szolgáltatást is, és automatikusan betöltötte az good-books indexet a postprovision mintaadattárban lévő horogon keresztül.

Keresés használata a Container Apps webhelyén

  1. Nyissa meg az ügyfél teljes tartománynevét a azd up kimenetből egy böngészőben.

  2. A webhely keresősávjában adjon meg egy keresési lekérdezést, például code. Az automatikus kiegészítés funkció egyező könyvcímeket javasol.

  3. Válasszon ki egy javaslatot, vagy folytassa a saját lekérdezés beírását. A keresési lekérdezés befejezésekor válassza az Enter billentyűt .

  4. Tekintse át az eredményeket, majd válasszon ki egy könyvet a további részletek megtekintéséhez.

Troubleshooting

Ha a webalkalmazás nem telepít vagy működik, a probléma meghatározásához és megoldásához használja az alábbi listát:

  • Befejeződött azd up ?

    Tekintse át az azd up első sikertelen üzembe helyezési, létrehozási vagy üzembe helyezési lépés kimenetét. Ha az üzembe helyezés leáll a kiépítés során, ellenőrizze az előfizetési engedélyeket és a kijelölt régiót. Ha az üzembe helyezés leáll a tároló összeállítási vagy üzembe helyezési lépései során, futtassa azd up újra a jelentett probléma megoldása után.

  • Meg tudja nyitni az ügyfélvégpontot?

    Nyissa meg az AZURE_CLIENT_URL értéket a azd up kimenetből. Ha a lap nem töltődik be, nyissa meg az Azure portált, nyissa meg az ügyféltároló alkalmazást, és tekintse át a változat állapotát és naplóit.

  • Meghívhatja az ügyfél a kiszolgálóvégpontot?

    Nyissa meg a böngésző fejlesztői eszközeit, és tekintse át az ügyfélalkalmazás hálózati hívásait. Ha az API-ra irányuló hívások sikertelenek, győződjön meg arról, hogy a kiszolgálótároló-alkalmazás fut, és hogy az ügyfélalkalmazás megkapta a kiszolgáló teljes tartománynevét az üzembe helyezés során.

  • Lekérdezhető a kiszolgáló Azure AI Keresés?

    Ha a keresés hibát ad vissza, tekintse át a kiszolgáló tárolóalkalmazás-naplóit. Felügyelt identitás esetén győződjön meg arról, hogy az identitás Azure AI Keresés adatsík-hozzáféréssel rendelkezik. Kulcsalapú hitelesítés esetén ellenőrizze, hogy az üzembe helyezés előtt be van-e állítva USE_KEYLESS_AUTHfalse , és hogy a létrehozott tárolókörnyezet tartalmazza-e a keresési szolgáltatás konfigurációját.

Erőforrások tisztítása

Az oktatóanyag által létrehozott Azure erőforrások törlésére használhatóazd down --purge. A --purge jelölő véglegesen eltávolítja azokat az erőforrásokat, amelyek támogatják a helyreállítható törlést, ahelyett, hogy helyreállítható állapotban hagyná őket a megőrzési időre. Ha később újra üzembe helyezi ezt az oktatóanyagot, a törlés elkerüli az elnevezési ütközéseket.

  1. Az adattár gyökérkönyvtárában futtassa a törlési parancsot.

    azd down --purge

  2. Tekintse át a listákban szereplő azd erőforrásokat.

  3. Kérdés esetén erősítse meg a törlést.

Ha az üzembe helyezésen kívül azd létrehozott egy Azure AI Keresés szolgáltatást, nyissa meg a keresőszolgáltatást a Azure portálon, és válassza a Lap tetején a Törlés lehetőséget.

Következő lépés

A keresési integrációs kód megismerése

  • Last updated on