Een C#-Azure AI Zoeken-app implementeren 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.

Implementeer de zoekwebsite op Azure Container Apps met behulp van de Azure Developer CLI (azd). Deze implementatie omvat de React-client, de .NET-API, Azure AI Zoeken, beheerde identiteit en het ondersteunen van Azure resources.

De implementatie maakt gebruik van beheerde identiteit als de standaardverificatiemethode voor Azure AI Zoeken. U kunt zich aanmelden voor verificatie op basis van sleutels door dit in te stellen USE_KEYLESS_AUTHfalse vóór de implementatie.

Aanmelden bij Azure

  1. Open in Visual Studio Code een terminal in de hoofdmap van de opslagplaats, zoals azure-search-static-web-app.

  2. Meld u aan bij Azure met behulp van azd.

    azd auth login

  3. Als u hierom wordt gevraagd door uw browser, voltooit u de aanmeldingsstroom met behulp van het Azure-account dat u voor deze zelfstudie gebruikt.

Een azd-omgeving maken

  • Maak een azd omgeving. Vervang door YOUR-ENVIRONMENT-NAME een korte naam die deze implementatie van de zelfstudie identificeert.

    azd env new YOUR-ENVIRONMENT-NAME

(Optioneel) Verificatie op basis van sleutels configureren

De standaardverificatiemethode is een beheerde identiteit, zodat de meeste omgevingen deze sectie kunnen overslaan. Voltooi deze sectie alleen als voor uw omgeving API-sleutels zijn vereist.

Stel USE_KEYLESS_AUTH in op false.

azd env set USE_KEYLESS_AUTH false

Als u dit niet instelt USE_KEYLESS_AUTH, gebruikt de implementatie beheerde identiteit. De Bicep-infrastructuur verleent de identiteit van de container-app toegang tot het Azure AI Zoeken gegevensvlak.

Implementeren met azd up

  1. Voer vanuit de root van de repository azd up uit.

    azd up

  2. Wanneer u hierom wordt gevraagd, selecteert u het Azure-abonnement en de locatie voor de resources.

  3. Wacht tot azd de infrastructuur is ingericht, de containers bouwt, de installatiekopieën pusht en de services implementeert naar Azure Container Apps.

  4. Controleer de uitvoer na de implementatie. De uitvoer bevat de FQDN's (Client- en Server Fully Qualified Domain Names) voor de Azure Container Apps-implementatie.

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

    Gebruik de AZURE_CLIENT_URL waarde om de website te openen. De client-app roept de server-app aan via het eindpunt dat tijdens de implementatie is geconfigureerd.

    De implementatie heeft ook de Azure AI Zoeken-service gemaakt en de good-books index automatisch geladen via de postprovision hook in de voorbeeldopslagplaats.

Zoeken gebruiken op uw Container Apps-website

  1. Open de client-FQDN vanuit de azd up uitvoer in een browser.

  2. Voer in de zoekbalk van de website een zoekquery in, zoals code. Met de functie voor automatisch aanvullen worden overeenkomende boektitels voorgesteld.

  3. Selecteer een suggestie of ga door met het invoeren van uw eigen query. Selecteer Enter wanneer u de zoekquery hebt voltooid.

  4. Bekijk de resultaten en selecteer vervolgens een boek voor meer informatie.

Troubleshooting

Als de web-app niet wordt geïmplementeerd of werkt, gebruikt u de volgende lijst om het probleem te bepalen en op te lossen:

  • Is azd up het voltooid?

    Controleer de azd up uitvoer voor de eerste mislukte inrichtings-, build- of implementatiestap. Als de implementatie stopt tijdens het inrichten, controleert u uw abonnementsmachtigingen en de geselecteerde regio. Als de implementatie stopt tijdens de containerbuild- of implementatiestappen, voert u deze opnieuw uit azd up nadat u het gemelde probleem hebt opgelost.

  • Kunt u het clienteindpunt openen?

    Open de AZURE_CLIENT_URL waarde uit de azd up uitvoer. Als de pagina niet wordt geladen, gaat u naar de Azure-portal, opent u de clientcontainer-app en controleert u de revisiestatus en logboeken.

  • Kan de client het servereindpunt aanroepen?

    Open de ontwikkelhulpprogramma's van uw browser en controleer de netwerkoproepen vanuit de client-app. Als aanroepen naar de API mislukken, controleert u of de servercontainer-app wordt uitgevoerd en of de client-app de server-FQDN heeft ontvangen tijdens de implementatie.

  • Kan de serverquery Azure AI Zoeken?

    Als zoekopdrachten fouten retourneren, controleert u de logboeken van de servercontainer-app. Controleer voor beheerde identiteit of de identiteit toegang heeft tot Azure AI Zoeken gegevensvlak. Controleer voor verificatie op basis van sleutels of u deze hebt ingesteld USE_KEYLESS_AUTHfalse vóór de implementatie en of de gegenereerde containeromgeving de configuratie van de zoekservice bevat.

De hulpbronnen opschonen

Gebruik azd down --purge dit om de Azure resources te verwijderen die in deze zelfstudie zijn gemaakt. De --purge vlag verwijdert permanent resources die ondersteuning bieden voor voorlopig verwijderen, in plaats van ze in een herstelbare status te laten staan voor hun bewaarperiode. Opschonen voorkomt naamconflicten als u deze zelfstudie later opnieuw implementeert.

  1. Voer vanuit de hoofdmap van de opslagplaats de opschoonopdracht uit.

    azd down --purge

  2. Bekijk de resources die azd worden vermeld.

  3. Bevestig de verwijdering wanneer hierom wordt gevraagd.

Als u een Azure AI Zoeken service buiten de azd implementatie hebt gemaakt, gaat u naar de zoekservice in de Azure-portal en selecteert u Verwijderen boven aan de pagina.

Volgende stap

De zoekintegratiecode verkennen

  • Last updated on