Kom igång med privata chattslutpunkter för Python

Den här artikeln visar hur du distribuerar och kör företagschattappexempel för Python- som är tillgänglig för privata slutpunkter.

Det här exemplet implementerar en chattapp med hjälp av Python, Azure OpenAI Service och Retrieveal Augmented Generation (RAG) i Azure AI-sökning för att få svar om medarbetarförmåner på ett fiktivt företag. Appen är seedad med PDF-filer som innehåller den anställdas handbok, ett förmånsdokument och en lista över företagsroller och förväntningar.

Genom att följa anvisningarna i den här artikeln:

• Distribuera en chattapp till Azure för offentlig åtkomst i en webbläsare.
• Omdistribuera en chattapp med privata slutpunkter.

När du har slutfört den här proceduren kan du börja ändra det nya projektet med din anpassade kod och distribuera om, med vetskapen om att chattappen endast är tillgänglig via det privata nätverket.

Översikt över arkitektur

Standarddistributionen skapar en chattapp med offentliga slutpunkter.

För chattappar som är berikade med privata data är det viktigt att skydda åtkomsten till chattappen. I den här artikeln beskrivs en lösning med hjälp av ett virtuellt nätverk.

I det virtuella nätverket finns det ett separat undernät för Azure App Service-appen jämfört med de andra Azure-tjänsterna i serverdelen. Den här strukturen gör det enkelt att tillämpa olika regler för nätverkssäkerhetsgrupper på varje undernät.

I det virtuella nätverket använder tjänsterna privata slutpunkter för att kommunicera med varandra. Varje privat slutpunkt är associerad med en privat DNS-zon (Domain Name System) för att matcha den privata slutpunktens namn till en IP-adress i det virtuella nätverket.

Distribueringssteg

Vi rekommenderar att du distribuerar lösningen två gånger. Distribuera en gång med offentlig åtkomst för att verifiera att chattappen fungerar korrekt. Distribuera igen med privat åtkomst för att skydda chattappen med hjälp av ett virtuellt nätverk.

Förutsättningar

En utvecklingscontainer miljö är tillgänglig med alla beroenden som krävs för att slutföra den här artikeln. Du kan köra utvecklingscontainern i GitHub Codespaces (i en webbläsare) eller lokalt med hjälp av Visual Studio Code.

Om du vill använda den här artikeln behöver du följande krav.

Användningskostnad för exempelresurser

De flesta resurser som används i den här arkitekturen ligger under grundläggande eller förbrukningsbaserade prisnivåer. Det innebär att du bara betalar för det du använder, och avgifterna är vanligtvis minimala under utveckling eller testning.

Distribution med privata nätverk medför extra kostnader för distributionen. När du har utvärderat eller distribuerat appen kan du ta bort alla etablerade resurser för att undvika löpande avgifter.

En detaljerad uppdelning av förväntade kostnader finns i Avsnittet Innan du börjar på GitHub-lagringsplatsen för exemplet.

Öppna utvecklingsmiljön

Använd följande instruktioner för att distribuera en förkonfigurerad utvecklingsmiljö som innehåller alla nödvändiga beroenden för att slutföra den här artikeln.

Anpassade inställningar

Den här lösningen konfigurerar och distribuerar infrastrukturen baserat på anpassade inställningar som konfigurerats med Azure Developer CLI. I följande tabell beskrivs de anpassade inställningarna för den här lösningen.

Släpp chattappen

Den första distributionen skapar resurserna och ger en offentligt tillgänglig slutpunkt.

1. Kör följande kommando för att konfigurera den här lösningen för offentlig åtkomst:

   azd env set AZURE_PUBLIC_NETWORK_ACCESS Enabled
   

   När du uppmanas att ange ett miljönamn bör du komma ihåg att miljönamnet används för att skapa resursgruppen. Ange ett beskrivande namn. Om du är i ett team eller i en organisation, inkludera ditt namn, som i morgan-chat-private-endpoints. Anteckna miljönamnet. Du behöver det senare för att hitta resurserna i Azure-portalen.

2. Kör följande kommando för att inkludera etablering av de virtuella nätverksresurserna. Kom ihåg att distributionen inte begränsar åtkomsten förrän den andra distributionen.

   azd env set AZURE_USE_PRIVATE_ENDPOINT true
   

3. Distribuera lösningen med följande kommando:

   azd up
   

   Resurshantering är den mest tidskrävande delen av distributionsprocessen. Vänta tills distributionen är klar innan du fortsätter.

4. I slutet av distributionsprocessen visas appslutpunkten. Kopiera slutpunkten till en webbläsare för att öppna chattappen. Välj en av frågorna på korten och vänta sedan på svaret.

   Anteckna slutpunkts-URL:en eftersom du behöver den igen senare i artikeln.

Distribuera chattappen till Azure med privat åtkomst

Ändra distributionskonfigurationen för att skydda chattappen för privat åtkomst.

1. Kör följande kommando för att använda en VPN-gateway för att komma åt det virtuella nätverket:

   azd env set AZURE_USE_VPN_GATEWAY true
   

2. Kör följande kommando för att inaktivera offentlig åtkomst:

   azd env set AZURE_PUBLIC_NETWORK_ACCESS Disabled
   
   

3. Kör följande kommando för att ändra resurskonfigurationen. Det här kommandot distribuerar inte om programkoden eftersom endast infrastrukturkonfigurationen har ändrats.

   azd provision
   

4. När etableringen är klar, öppna chattappen i en webbläsare igen. Chattappen är inte längre tillgänglig eftersom den offentliga slutpunkten är inaktiverad.

Få åtkomst till chattappen

För att komma åt chattappen använder du ett verktyg som Azure VPN Gateway- eller Azure Virtual Desktop-. Kom ihåg att alla verktyg som du använder för att komma åt appen måste vara säkra och kompatibla med organisationens säkerhetsprinciper.

Rensa resurser

Följande steg beskriver hur du rensar de resurser du använde.

Få hjälp

Den här exempellagringsplatsen erbjuder felsökningsinformation.

Om ditt problem inte åtgärdas, lägg till det på arkivets Problemsida.

Relaterat innehåll

• Se GitHub-arkivet för enterprise-chattappen.
• Skapa en chattapp med Azure OpenAI bästa praxis för lösningsarkitektur.
• Lär dig mer om åtkomstkontroll i generativa AI-appar med Azure AI-sökning.