Dela via


Skala Azure OpenAI för Python med Azure API Management

Lär dig hur du lägger till belastningsutjämning i företagsklass i ditt program för att utöka chattappen utöver Azure OpenAI-tjänstens token- och modellkvotgränser. Den här metoden använder Azure API Management för att intelligent dirigera trafik mellan tre Azure OpenAI-resurser.

Den här artikeln kräver att du distribuerar två separata exempel:

  • Chattapp:
    • Vänta med att distribuera chattappen tills lastbalanserarens exempel har distribuerats.
    • Om du redan har distribuerat chattappen en gång ändrar du miljövariabeln så att den stöder en anpassad slutpunkt för lastbalanseraren och distribuerar om den igen.
  • Lastbalanserare med Azure API Management.

Anmärkning

Den här artikeln använder en eller flera AI-appmallar som grund för exemplen och instruktionerna i artikeln. MED AI-appmallar får du väl underhållna referensimplementeringar som är enkla att distribuera. De bidrar till att säkerställa en högkvalitativ startpunkt för dina AI-appar.

Arkitektur för belastningsutjämning av Azure OpenAI med Azure API Management

Eftersom Azure OpenAI-resursen har specifika token- och modellkvotgränser är en chattapp som använder en enda Azure OpenAI-resurs benägen att få konversationsfel på grund av dessa gränser.

diagram som visar chattapparkitektur med en Azure OpenAI-resurs markerad.

Om du vill använda chattappen utan att nå dessa gränser använder du en belastningsutjämningslösning med API Management. Den här lösningen exponerar sömlöst en enskild slutpunkt från API Management till chattappservern.

diagram som visar chattapparkitektur med Azure API Management framför tre Azure OpenAI-resurser.

API Management-resursen, som ett API-lager, finns framför en uppsättning Azure OpenAI-resurser. API-lagret gäller för två scenarier: normalt och begränsat. I ett normalt scenario där token- och modellkvoten är tillgänglig returnerar Azure OpenAI-resursen 200 via API-lagret och bakgrundsappservern.

diagram som visar ett normalt scenario med tre Azure OpenAI-slutpunktsgrupper. Den första gruppen med två slutpunkter hämtar lyckad trafik.

När en resurs begränsas på grund av kvotgränser kan API-lagret försöka igen med en annan Azure OpenAI-resurs omedelbart för att uppfylla den ursprungliga chattappens begäran.

diagram som visar ett strypningsscenario med en felkod 429 och ett svarshuvud för hur många sekunder klienten måste vänta innan de kan försöka igen.

Förutsättningar

Öppna exempelappen för Azure API Management Local Balancer

GitHub Codespaces kör en utvecklingscontainer som hanteras av GitHub med Visual Studio Code för webben som användargränssnitt. För den enklaste utvecklingsmiljön använder du GitHub Codespaces så att du har rätt utvecklarverktyg och beroenden förinstallerade för att slutföra den här artikeln.

Öppna i GitHub Codespaces.

Viktigt!

Alla GitHub-konton kan använda GitHub Codespaces i upp till 60 timmar kostnadsfritt varje månad med två kärninstanser. För mer information, se GitHub Codespaces månadsvis inkluderade lagrings- och kärntimmar.

Distribuera Lastbalanseraren för Azure API Management

  1. Om du vill distribuera lastbalanseraren till Azure loggar du in på Azure Developer CLI (AZD):

    azd auth login
    
  2. Slutför inloggningsinstruktionerna.

  3. Distribuera lastbalanseringsappen:

    azd up
    

    Välj en prenumeration och region för distributionen. Det behöver inte vara samma abonnemang och region som chattapplikationen.

  4. Vänta tills distributionen är klar innan du fortsätter. Den här processen kan ta upp till 30 minuter.

Hämta lastbalanserarens slutpunkt

Kör följande Bash-kommando för att se miljövariablerna från distributionen. Du behöver den här informationen senare.

azd env get-values | grep APIM_GATEWAY_URL

Återdistribuera chattappen med lastbalanserarens slutpunkt

De här exemplen har slutförts i chattappexemplet.

  1. Öppna chattappexemplets utvecklingscontainer med något av följande alternativ.

    Språk GitHub Codespaces Visual Studio Code
    .NÄT Öppna i GitHub Codespaces Öppna i Dev Containers
    JavaScript Öppna i GitHub Codespaces Öppna i Dev Containers
    python Öppna i GitHub Codespaces Öppna i Dev Containers
  2. Logga in på Azure Developer CLI (AZD):

    azd auth login
    

    Slutför inloggningsinstruktionerna.

  3. Skapa en AZD miljö med ett namn som chat-app:

    azd env new <name>
    
  4. Lägg till följande miljövariabel, som instruerar chattappens serverdel att använda en anpassad URL för Azure OpenAI-begäranden:

    azd env set OPENAI_HOST azure_custom
    
  5. Lägg till den här miljövariabeln för att berätta för chattappens serverdel den anpassade URL:en för Azure OpenAI-begäran:

    azd env set AZURE_OPENAI_CUSTOM_URL <APIM_GATEWAY_URL>
    
  6. Driftsätt chattappen:

    azd up
    

Konfigurera TPM-kvoten

Som standard distribueras var och en av Azure OpenAI-instanserna i lastbalanseraren med en kapacitet på 30 000 token per minut (TPM). Du kan använda chattappen med förtroende för att den skalar över många användare utan att kvoten tar slut. Ändra det här värdet när:

  • Du får distributionskapacitetsfel: Sänk värdet.
  • Du behöver högre kapacitet: Öka värdet.
  1. Använd följande kommando för att ändra värdet:

    azd env set OPENAI_CAPACITY 50
    
  2. Omdistribuera lastbalanseraren

    azd up
    

Rensa resurser

När du är klar med chattappen och lastbalanseraren rensar du resurserna. De Azure-resurser som skapas i den här artikeln faktureras till din Azure-prenumeration. Om du inte förväntar dig att behöva dessa resurser i framtiden tar du bort dem för att undvika att debiteras mer.

Rensa chattappens resurser

Gå tillbaka till chattappartikeln för att rensa resurserna.

Rensa lastbalanserarens resurser

Ta bort Azure-resurserna och ta bort källkoden:

azd down --purge --force

Växlarna tillhandahåller:

  • purge: Borttagna resurser rensas omedelbart. Du kan återanvända Azure OpenAI-token per minut.
  • force: Borttagningen sker tyst, utan att behöva användarens medgivande.

Rensa resurser

Att ta bort GitHub Codespaces-miljön säkerställer att du kan maximera antalet kostnadsfria timmar per kärna som du får för ditt konto.

Viktigt!

För mer information om rättigheterna för ditt GitHub-konto, se GitHub Codespaces månadsvis inkluderad lagringskapacitet och kärntimmar.

  1. Logga in på GitHub Codespaces-instrumentpanelen .

  2. Leta upp dina kodområden som körs och som hämtas från azure-samples/openai-apim-lb GitHub-lagringsplats.

    Skärmbild som visar alla kodområden som körs, inklusive deras status och mallar.

  3. Öppna snabbmenyn för objektet GitHub Codespaces och välj sedan Ta bort.

    Skärmbild som visar snabbmenyn för ett enda kodområde med alternativet Ta bort markerat.

Få hjälp

Om du har problem med att distribuera Azure API Management-lastbalanseraren, lägg till ditt problem på lagringsplatsens Problemsida.

Exempelkod

Exempel som används i den här artikeln är: