De Azure OpenAI-web-app gebruiken
Naast Azure OpenAI Studio, API's en SDK's kunt u ook de beschikbare zelfstandige web-app gebruiken om te communiceren met Azure OpenAI-modellen met behulp van een grafische gebruikersinterface, die u kunt implementeren met behulp van Azure OpenAI Studio of een handmatige implementatie.
Belangrijke aandachtspunten
Publiceren maakt een Azure-app-service in uw abonnement. Er kunnen kosten in rekening worden gebracht, afhankelijk van het prijsplan dat u selecteert. Wanneer u klaar bent met uw app, kunt u deze verwijderen uit Azure Portal.
gpt-4 vision-preview-modellen worden niet ondersteund.
De app wordt standaard geïmplementeerd met de Microsoft-id-provider die al is geconfigureerd, waardoor de toegang tot de app wordt beperkt tot leden van uw Azure-tenant. Verificatie toevoegen of wijzigen:
Ga naar Azure Portal en zoek naar de app-naam die u tijdens het publiceren hebt opgegeven. Selecteer de web-app en ga naar het tabblad Verificatie in het linkernavigatiemenu. Selecteer vervolgens Een id-provider toevoegen.
Selecteer Microsoft als id-provider. De standaardinstellingen op deze pagina beperken de app alleen tot uw tenant, dus u hoeft hier niets anders te wijzigen. Selecteer vervolgens Toevoegen
Gebruikers worden nu gevraagd zich aan te melden met hun Microsoft Entra ID-account om toegang te krijgen tot uw app. U kunt een vergelijkbaar proces volgen om desgewenst een andere id-provider toe te voegen. De app gebruikt de aanmeldingsgegevens van de gebruiker niet op een andere manier dan dat ze lid zijn van uw tenant.
Aanpassing van web-apps
U kunt de front-end- en back-endlogica van de app aanpassen. De app biedt verschillende omgevingsvariabelen voor veelvoorkomende aanpassingsscenario's , zoals het wijzigen van het pictogram in de app. Zie de broncode voor de web-app en meer informatie over GitHub.
Bij het aanpassen van de app raden we het volgende aan:
Stel de chatsessie opnieuw in (wis chat) als de gebruiker instellingen wijzigt. Informeer de gebruiker dat de chatgeschiedenis verloren gaat.
Duidelijk communiceren hoe elke instelling die u implementeert, van invloed is op de gebruikerservaring.
Wanneer u API-sleutels roteert voor uw Azure OpenAI- of Azure AI Search-resource, moet u de app-instellingen voor elk van uw geïmplementeerde apps bijwerken om de nieuwe sleutels te gebruiken.
Voorbeeldbroncode voor de web-app is beschikbaar op GitHub. Broncode wordt 'zoals is' opgegeven en alleen als voorbeeld. Klanten zijn verantwoordelijk voor alle aanpassingen en implementatie van hun web-apps.
De web-app bijwerken
Notitie
Na 1 februari 2024 moet de opstartopdracht van de app worden ingesteld python3 -m gunicorn app:appop . Wanneer u een app bijwerkt die vóór 1 februari 2024 is gepubliceerd, moet u de opstartopdracht handmatig toevoegen vanaf de pagina App Service-configuratie .
We raden u aan om regelmatig wijzigingen op te halen uit de main vertakking voor de broncode van de web-app om ervoor te zorgen dat u over de meest recente bugfixes, API-versie en verbeteringen beschikt. Bovendien moet de web-app worden gesynchroniseerd telkens wanneer de GEBRUIKTE API-versie buiten gebruik wordt gesteld.
U kunt eventueel klikken op de knoppen horloge of ster in de GitHub-opslagplaats van de web-app om op de hoogte te worden gesteld van wijzigingen en updates van de broncode.
Als u de app niet hebt aangepast:
- U kunt de onderstaande synchronisatiestappen volgen
Als u de broncode van de app hebt aangepast of gewijzigd:
- U moet de broncode van uw app handmatig bijwerken en opnieuw implementeren.
- Als uw app wordt gehost op GitHub, pusht u de codewijzigingen naar uw opslagplaats en gebruikt u de onderstaande synchronisatiestappen.
- Als u de app handmatig opnieuw implementeert (bijvoorbeeld Azure CLI), volgt u de stappen voor uw implementatiestrategie.
De web-app synchroniseren
Als u uw app hebt aangepast, werkt u de broncode van de app bij.
Navigeer naar uw web-app in Azure Portal.
Selecteer Implementatiecentrum in het navigatiemenu onder Implementatie.
Selecteer Synchroniseren boven aan het scherm en bevestig dat de app opnieuw wordt geïmplementeerd.
Chatgeschiedenis
U kunt chatgeschiedenis inschakelen voor uw gebruikers van de web-app. Wanneer u de functie inschakelt, hebben uw gebruikers toegang tot hun afzonderlijke vorige query's en antwoorden.
Als u chatgeschiedenis wilt inschakelen, implementeert of implementeert u uw model als een web-app met behulp van Azure OpenAI Studio.
Belangrijk
Als u chatgeschiedenis inschakelt, maakt u een Cosmos DB-exemplaar in uw resourcegroep en worden er extra kosten in rekening gebracht voor de gebruikte opslag.
Zodra u de chatgeschiedenis hebt ingeschakeld, kunnen uw gebruikers deze weergeven en verbergen in de rechterbovenhoek van de app. Wanneer de geschiedenis wordt weergegeven, kunnen ze gesprekken wijzigen of verwijderen. Wanneer ze zijn aangemeld bij de app, worden gesprekken automatisch gesorteerd van nieuw naar oud en benoemd op basis van de eerste query in het gesprek.
Uw Cosmos DB-exemplaar verwijderen
Als u uw web-app verwijdert, wordt uw Cosmos DB-instantie niet automatisch verwijderd. Als u uw Cosmos DB-exemplaar wilt verwijderen, samen met alle opgeslagen chats, moet u naar de bijbehorende resource in Azure Portal navigeren en deze verwijderen. Als u de Cosmos DB-resource verwijdert, maar de chatgeschiedenisoptie ingeschakeld houdt in de studio, krijgen uw gebruikers een melding van een verbindingsfout, maar kunnen ze de web-app blijven gebruiken zonder toegang tot de chatgeschiedenis.