Dela via

Använda Azure OpenAI-webbappen

  • Artikel

Tillsammans med Azure OpenAI Studio, API:er och SDK:er kan du också använda den tillgängliga fristående webbappen för att interagera med Azure OpenAI-modeller med hjälp av ett grafiskt användargränssnitt, som du kan distribuera med antingen Azure OpenAI Studio eller en manuell distribution.

En skärmbild av webbappens gränssnitt.

Viktigt!

  • Publicering skapar en Azure App Service i din prenumeration. Det kan medföra kostnader beroende på vilken prisplan du väljer. När du är klar med din app kan du ta bort den från Azure-portalen.

  • modeller för gpt-4 vision-preview stöds inte.

  • Som standard distribueras appen med Microsoft-identitetsprovidern som redan har konfigurerats, vilket begränsar åtkomsten till appen till medlemmar i din Azure-klientorganisation. Så här lägger du till eller ändrar autentisering:

    1. Gå till Azure-portalen och sök efter det appnamn som du angav under publiceringen. Välj webbappen och gå till fliken Autentisering på den vänstra navigeringsmenyn. Välj sedan Lägg till en identitetsprovider.

      Skärmbild av autentiseringssidan i Azure-portalen.

    2. Välj Microsoft som identitetsprovider. Standardinställningarna på den här sidan begränsar appen endast till din klientorganisation, så du behöver inte ändra något annat här. Välj sedan Lägg till

    Nu uppmanas användarna att logga in med sitt Microsoft Entra-ID-konto för att kunna komma åt din app. Du kan följa en liknande process för att lägga till en annan identitetsprovider om du vill. Appen använder inte användarens inloggningsinformation på något annat sätt än att verifiera att de är medlemmar i din klientorganisation.

Anpassning av webbappar

Du kan anpassa appens klientdels- och serverdelslogik. Appen innehåller flera miljövariabler för vanliga anpassningsscenarier , till exempel att ändra ikonen i appen. Se källkoden för webbappen och mer information på GitHub.

När du anpassar appen rekommenderar vi:

  • Återställa chattsessionen (rensa chatt) om användaren ändrar några inställningar. Meddela användaren att deras chatthistorik kommer att gå förlorad.

  • Att tydligt kommunicera hur varje inställning som du implementerar påverkar användarupplevelsen.

  • När du roterar API-nycklar för din Azure OpenAI- eller Azure AI Search-resurs måste du uppdatera appinställningarna för var och en av dina distribuerade appar så att de använder de nya nycklarna.

Exempel på källkod för webbappen finns på GitHub. Källkoden anges "som den är" och endast som ett exempel. Kunderna ansvarar för all anpassning och implementering av sina webbappar.

Uppdatera webbappen

Kommentar

Efter den 1 februari 2024 kräver webbappen att appstartkommandot är inställt på python3 -m gunicorn app:app. När du uppdaterar en app som publicerades före den 1 februari 2024 måste du manuellt lägga till startkommandot från sidan App Service-konfiguration .

Vi rekommenderar att du hämtar ändringar från grenen main för webbappens källkod ofta för att säkerställa att du har de senaste felkorrigeringarna, API-versionen och förbättringarna. Dessutom måste webbappen synkroniseras varje gång den API-version som används dras tillbaka.

Överväg att antingen klicka på klock - eller stjärnknapparna på webbappens GitHub-lagringsplats för att meddelas om ändringar och uppdateringar av källkoden.

Om du inte har anpassat appen:

  • Du kan följa synkroniseringsstegen nedan

Om du har anpassat eller ändrat appens källkod:

  • Du måste uppdatera appens källkod manuellt och distribuera om den.
    • Om din app finns på GitHub skickar du kodändringarna till lagringsplatsen och använder synkroniseringsstegen nedan.
    • Om du distribuerar om appen manuellt (till exempel Azure CLI) följer du stegen för distributionsstrategin.

Synkronisera webbappen

  1. Om du har anpassat din app uppdaterar du appens källkod.

  2. Gå till din webbapp i Azure-portalen.

  3. Välj Distributionscenter på navigeringsmenyn under Distribution.

  4. Välj Synkronisera överst på skärmen och bekräfta att appen kommer att distribueras om.

    En skärmbild av knappen för synkronisering av webbappar på Azure-portalen.

Chatthistorik

Du kan aktivera chatthistorik för dina användare av webbappen. När du aktiverar funktionen får användarna åtkomst till sina enskilda tidigare frågor och svar.

Om du vill aktivera chatthistorik distribuerar eller distribuerar du om din modell som en webbapp med hjälp av Azure OpenAI Studio.

En skärmbild av knappen för aktivering av chatthistorik i Azure OpenAI Studio.

Viktigt!

Om du aktiverar chatthistorik skapas en Cosmos DB-instans i resursgruppen och extra avgifter debiteras för det lagringsutrymme som används.

När du har aktiverat chatthistorik kan användarna visa och dölja den i appens övre högra hörn. När historiken visas kan de byta namn på eller ta bort konversationer. När de loggas in i appen sorteras konversationer automatiskt från den senaste till den äldsta och namnges baserat på den första frågan i konversationen.

En skärmbild av chatthistoriken i webbappen.

Ta bort din Cosmos DB-instans

Om du tar bort webbappen tas inte Cosmos DB-instansen bort automatiskt. Om du vill ta bort din Cosmos DB-instans, tillsammans med alla lagrade chattar, måste du navigera till den associerade resursen i Azure-portalen och ta bort den. Om du tar bort Cosmos DB-resursen men har alternativet chatthistorik aktiverat i studion meddelas användarna om ett anslutningsfel, men kan fortsätta att använda webbappen utan åtkomst till chatthistoriken.

Nästa steg