Självstudie: Distribuera en webbapp för företagschatt

I den här artikeln distribuerar du en företagschattwebbapp som använder dina data med en stor språkmodell i Azure AI Foundry-portalen.

Din datakälla motiverar modellen med specifika data. Jordning innebär att modellen använder dina data för att förstå kontexten för din fråga. Du ändrar inte själva den distribuerade modellen. Dina data förblir separata och säkra i den ursprungliga datakällan.

Stegen i den här självstudien är:

Förutsättningar

• Ett Azure-konto med en aktiv prenumeration. Om du inte har ett skapar du ett kostnadsfritt Azure-konto, som innehåller en kostnadsfri utvärderingsprenumeration.
• Om du inte har något skapar du ett hubbbaserat projekt.

• En distribuerad Azure OpenAI-chattmodell . Slutför snabbstarten för Azure AI Foundry Playground för att skapa den här resursen om du inte har någon.

• En tjänsten Search anslutning för att indexering av exempelproduktdata. Om du inte har någon följer du stegen för att skapa och ansluta en söktjänst.

• En lokal kopia av produktdata. Lagringsplatsen Azure-Samples/rag-data-openai-python-promptflow på GitHub innehåller exempel på produktinformation för detaljhandeln för det här självstudiescenariot. Filen product_info_11.md innehåller produktinformation om TrailWalker-vandringsskorna för det här självstudieexemplet. Ladda ned contoso Trek-exempelproduktdata i en ZIP-fil till din lokala dator.

• En Microsoft.Web-resursprovider registrerad i den valda prenumerationen så att du kan distribuera till en webbapp. Mer information om hur du registrerar en resursprovider finns i Registrera resursprovider.

• Nödvändiga behörigheter för att lägga till rolltilldelningar i din Azure-prenumeration. Endast ägaren av de specifika Azure-resurserna kan bevilja behörigheter genom rolltilldelning.

Azure AI Foundry-portalen och Azure Portal

I den här självstudien utför du vissa uppgifter i Azure AI Foundry-portalen och några uppgifter i Azure Portal.

Azure AI Foundry-portalen är en webbaserad miljö för att skapa, träna och distribuera AI-modeller. Som utvecklare är det här du skapar och distribuerar chattwebbappen.

Med Azure-portalen kan en administratör hantera och övervaka Azure-resurser. Som administratör använder du portalen för att konfigurera inställningar för olika Azure-tjänster som krävs för åtkomst från webbappen.

Konfigurera resurser

Konfigurera rätt behörigheter i Azure-portalen för att få resurserna att fungera korrekt i en webbapp.

Identifiera först de resurser som du behöver konfigurera i Azure AI Foundry-portalen.

1. Öppna Azure AI Foundry-portalen och välj sedan det hubbbaserade projekt som du använde för att distribuera Azure OpenAI-chattmodellen.

2. Välj Hanteringscenter i den vänstra rutan.

3. Välj Anslutna resurser under projektet.

4. Identifiera de tre resurser som du behöver konfigurera: Azure OpenAI, Azure AI Search och Azure Blob Storage som motsvarar ditt arbetsytearkiv.

   

   Tips/Råd

   Om du inte ser Typ i tabellen väljer du Kolumner i det övre högra hörnet och lägger till eller ändrar ordning på de markerade kolumnerna. Om du har flera Azure OpenAI-resurser använder du den som innehåller din distribuerade chattmodell.

5. Sök efter vart och ett av dessa namn i Azure-portalen. Öppna var och en på en ny webbläsarflik så att du kan växla mellan dem.

6. När du är klar har du tre nya webbläsarflikar öppna: Search Service, Azure AI Foundry och blobstore Container. Håll alla tre flikarna öppna eftersom du växlar mellan dem för att konfigurera resurserna.

Aktivera hanterad identitet

På webbläsarfliken för söktjänstresursen i Azure-portalen aktiverar du hanterad identitet:

1. I den vänstra rutan går du till Resurshantering och väljer Identitet.
2. Växla status till På.
3. Välj Spara.

Aktivera hanterad identitet på webbläsarfliken för Azure AI Foundry-resursen i Azure-portalen:

1. I den vänstra rutan går du till Resurshantering och väljer Identitet.
2. Växla status till På.
3. Välj Spara.

Ange åtkomstkontroll för sökning

På webbläsarfliken för söktjänstresursen i Azure-portalen anger du API-åtkomstprincipen:

1. I den vänstra rutan går du till Inställningar och väljer Nycklar.
2. Under API-åtkomstkontroll väljer du Båda.
3. När du uppmanas till det väljer du Ja för att bekräfta.

Tilldela roller

Upprepa det här mönstret för varje resurs i stegen nedan.

Det allmänna mönstret för att tilldela rollbaserad åtkomstkontroll (RBAC) för alla resurser är:

1. Gå till Azure Portal för den angivna resursen.
2. Välj Åtkomstkontroll (IAM) på den vänstra sidan i Azure Portal.
3. Välj + Lägg till>Lägg till rolltilldelning.
4. Sök efter den roll som du behöver tilldela och välj den. Välj sedan Nästa.
5. När du tilldelar en roll till dig själv:
   1. Välj Användare, grupp eller tjänstens huvudnamn.
   2. Välj Välj medlemmar.
   3. Sök efter ditt namn och välj det.
6. När du tilldelar en roll till en annan resurs:
   1. Välj Hanterad identitet.
   2. Välj Välj medlemmar.
   3. Använd listrutan för att hitta den typ av resurs som du vill tilldela. Till exempel Azure AI-tjänster eller tjänsten Search.
   4. Välj resursen i listan som visas. Det kanske bara finns en, men du behöver fortfarande välja den.
7. Fortsätt genom guiden och välj Granska + tilldela för att lägga till rolltilldelningen.

Använd de här stegen för att tilldela roller för de resurser som du har konfigurerat i den här självstudien:

• Tilldela dessa roller på webbläsarfliken för söktjänsten i Azure-portalen:

  • Sökindex dataläsare till den hanterade Azure AI Foundry-identiteten
  • Söktjänstkontributör till den hanterade identiteten för Azure AI Foundry
  • Deltagare till dig själv (om du vill hitta Deltagare växlar du till fliken Privilegierade administratörsroller högst upp. Alla andra roller finns på fliken Jobbfunktionsroller .)

• Tilldela dessa roller på webbläsarfliken för Azure AI Foundry i Azure-portalen:

  • Cognitive Services OpenAI-deltagare i den tjänsten Search hanterade identiteten
  • Deltagare för dig själv.

• Tilldela dessa roller på webbläsarfliken för Azure Blob Storage i Azure-portalen:

  • Storage Blob Data-deltagare till den hanterade identiteten för Azure AI Foundry
  • Storage Blob Data Reader till den tjänsten Search hanterade identiteten
  • Deltagare till dig själv

Du har konfigurerat resurser. Du kan stänga webbläsarflikarna i Azure-portalen nu om du vill.

Lägg till dina data och försök chattmodellen igen

I snabbstarten för Azure AI Foundry Playground (det är en förutsättning för den här självstudien) ser du hur din modell svarar utan dina data. Lägg till dina data i modellen så att den kan svara på frågor om dina produkter.

För att slutföra det här avsnittet behöver du en lokal kopia av produktdata. Lagringsplatsen Azure-Samples/rag-data-openai-python-promptflow på GitHub innehåller exempel på detaljhandelsproduktinformation som är relevant för det här självstudiescenariot. product_info_11.md Mer specifikt innehåller filen produktinformation om TrailWalker-vandringsskorna som är relevanta för det här självstudieexemplet. Ladda ned contoso Trek-exempelproduktdata i en ZIP-fil till din lokala dator.

Följ dessa steg för att lägga till dina data i chattlekplatsen för att hjälpa assistenten att svara på frågor om dina produkter. Du ändrar inte själva den distribuerade modellen. Dina data lagras separat och säkert i din Azure-prenumeration.

1. Gå till projektet i Azure AI Foundry.

2. Välj Lekplatser i den vänstra rutan.

3. Välj Prova chattlekplatsen.

4. Välj din distribuerade chattmodell i listrutan Distribution .

   

5. Till vänster i chattlekplatsen väljer du Lägg till dina data>+ Lägg till en ny datakälla.

   

6. I listrutan Datakälla väljer du Ladda upp filer.

   

7. Välj Ladda upp>uppladdningsfiler för att bläddra bland dina lokala filer.

8. Välj de filer som du vill ladda upp. Välj de produktinformationsfiler som du laddade ned eller skapade tidigare. Lägg till alla filer nu. Du kommer inte att kunna lägga till fler filer senare i samma lekplatssession.

9. Välj Ladda upp för att ladda upp filen till ditt Azure Blob Storage-konto. Välj sedan Nästa.

   

10. Välj din Azure AI Search-tjänst .

11. Som Vektorindexnamn anger du produktinformation och väljer Nästa.

12. På sidan Sökinställningar under Vektorinställningar avmarkerar du kryssrutan Lägg till vektorsökning i den här sökresursen. Den här inställningen hjälper dig att avgöra hur modellen svarar på begäranden. Välj sedan Nästa.

    Anmärkning

    Om du lägger till vektorsökning skulle fler alternativ vara tillgängliga här mot en extra kostnad.

13. Granska inställningarna och välj Skapa vektorindex.

14. På lekplatsen kan du se att datainmatningen pågår. Processen kan ta flera minuter. Vänta tills du ser datakällan och indexnamnet i stället för statusen innan du fortsätter.

    

15. Nu kan du chatta med modellen och ställa samma fråga som tidigare ("Hur mycket är TrailWalker-vandringsskorna") och den här gången använder den information från dina data för att konstruera svaret. Du kan expandera referensknappen för att se de data som användes.

Distribuera din webbapp

När du är nöjd med upplevelsen i Azure AI Foundry-portalen distribuerar du modellen som ett fristående webbprogram.

Hitta resursgruppen i Azure Portal

I den här självstudien distribuerar du webbappen till samma resursgrupp som din Azure AI Foundry-hubb. Du konfigurerar autentisering för webbappen i Azure-portalen.

Följ de här stegen för att gå till resursgruppen i Azure-portalen:

1. Gå till projektet i Azure AI Foundry. Välj Hanteringscenter i den vänstra rutan.

2. Under rubriken Projekt väljer du Översikt.

3. Välj resursgruppens namn för att öppna resursgruppen i Azure Portal. I det här exemplet heter rg-sdg-airesursgruppen .

   

4. Nu är du i Azure-portalen och visar innehållet i resursgruppen där du distribuerade hubben. Observera resursgruppens namn och plats. Du använder den här informationen i nästa avsnitt.

5. Håll den här sidan öppen på en webbläsarflik. Du återgår till det senare.

Distribuera webbapplikationen

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

Så här distribuerar du webbappen:

1. Slutför stegen i föregående avsnitt för att lägga till dina data på lekplatsen. Du kan distribuera en webbapp med eller utan egna data, men du behöver en distribuerad modell enligt beskrivningen i snabbstarten för Azure AI Foundry Playground.

2. Välj Distribuera > ... som en webbapp.

   

3. På sidan Distribuera till en webbapp anger du följande information:

   • Namn: Ett unikt namn för webbappen.
   • Prenumeration: Din Azure-prenumeration. Om du inte ser några tillgängliga prenumerationer registrerar du först Microsoft.Web som resursprovider.
   • Resursgrupp: Välj en resursgrupp där webbappen ska distribueras. Använd samma resursgrupp som hubben.
   • Plats: Välj en plats där webbappen ska distribueras. Använd samma plats som hubben.
   • Prisplan: Välj en prisplan för webbappen.
   • Aktivera chatthistorik i webbappen: För självstudien är inte rutan för chatthistorik markerad. Om du aktiverar funktionen har användarna åtkomst till sina enskilda tidigare frågor och svar. Mer information finns i kommentarer om chatthistorik.

4. Välj Distribuera.

5. Vänta tills appen har distribuerats. Den här processen kan ta några minuter.

6. När den är klar aktiveras knappen Starta i verktygsfältet. Starta inte appen ännu och stäng inte sidan för chattlekplats – du kommer tillbaka till den senare.

Konfigurera webbappautentisering

Som standard är det bara du som har åtkomst till webbappen. I den här självstudien lägger du till autentisering för att begränsa åtkomsten till medlemmar i din Azure-klientorganisation. Användare loggar in med sitt Microsoft Entra-konto för att få åtkomst till din app. Du kan följa en liknande process för att lägga till en annan identitetsprovider om du vill. Appen använder bara användarens inloggningsinformation för att verifiera att de är medlemmar i din klientorganisation.

1. Gå tillbaka till webbläsarfliken med Azure-portalen eller öppna Azure-portalen på en ny webbläsarflik. Visa innehållet i resursgruppen där du distribuerade webbappen. Du kan behöva uppdatera vyn för att se webbappen.

2. Välj App Service-resursen i listan över resurser i resursgruppen.

3. Välj Autentisering på den komprimerade vänstra menyn under Inställningar.

   

4. Om du ser att Microsoft har listat en identitetsprovider på den här sidan behövs inget ytterligare. Du kan hoppa över nästa steg.

5. Lägg till en identitetsprovider med följande inställningar:

   • Identitetsprovider: 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.
   • Klientorganisationstyp: Personal
   • Appregistrering: Skapa en ny appregistrering
   • Namn: Namnet på webbapptjänsten
   • Kontotyper som stöds: Aktuell klientorganisation – enskild klientorganisation
   • Begränsa åtkomst: Kräver autentisering
   • Oautentiserade begäranden: HTTP 302 Hittades omdirigering – rekommenderas för webbplatser

Använd webbappen

Du är nästan där. Nu kan du testa webbappen.

1. Om du har ändrat inställningarna väntar du cirka 10 minuter tills autentiseringsinställningarna börjar gälla.

2. Gå tillbaka till webbläsarfliken med sidan för chattlekplats i Azure AI Foundry-portalen.

3. Välj Starta för att öppna den distribuerade webbappen. Om du uppmanas att göra det godkänner du behörighetsbegäran.

4. Om du inte ser Starta på lekplatsen väljer du Webbappar i den vänstra rutan och väljer sedan din app i listan för att öppna den.

   Om autentiseringsinställningarna inte är aktiva än stänger du webbläsarfliken för webbappen och återgår till chattlekplatsen i Azure AI Foundry-portalen. Vänta lite längre och försök sedan igen.

5. I webbappen ställer du samma fråga som tidigare ("Hur mycket är TrailWalker-vandringsskorna"). Den här gången använder appen information från dina data för att konstruera svaret. Expandera referensknappen för att se de data som används.

   

Förstå chatthistorik

Med funktionen chatthistorik kan användarna se sina tidigare frågor och svar.

Aktivera chatthistorik när du distribuerar webbappen. Markera kryssrutan Aktivera chatthistorik i webbappen .

När du har aktiverat chatthistorik kan användarna visa eller 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 är inloggade i appen sorteras konversationer från den senaste till den äldsta och namnges baserat på den första frågan i konversationen.

Om du tar bort Cosmos DB-resursen men har alternativet chatthistorik aktiverat i studion ser användarna ett anslutningsfel men kan fortsätta använda webbappen utan chatthistorik.

Uppdatera webbappen

Använd lekplatsen för att lägga till mer data eller testa modellen med olika scenarier. När du är redo att uppdatera webbappen med den nya modellen väljer du Distribuera > ... som en webbapp igen. Välj Uppdatera en befintlig webbapp och välj den befintliga webbappen i listan. Den nya modellen distribueras till den befintliga webbappen.

Rensa resurser

För att undvika onödiga Azure-kostnader tar du bort de resurser som du skapade i den här snabbstarten om du inte behöver dem. Hantera resurser i Azure-portalen.

Relaterat innehåll

• Kom igång med att bygga en chattapp med hjälp av prompt flow SDK
• Skapa en anpassad chattapp med Azure AI SDK