Použití webové aplikace Azure OpenAI

Společně s Azure OpenAI Studio, rozhraními API a sadami SDK můžete také použít dostupnou samostatnou webovou aplikaci k interakci s modely Azure OpenAI pomocí grafického uživatelského rozhraní, které můžete nasadit pomocí sady Azure OpenAI Studio nebo ručního nasazení.

Důležitá poznámka

• Publikování vytvoří ve vašem předplatném službu Aplikace Azure. V závislosti na vybraném cenovém plánu můžou nastat náklady. Až budete s aplikací hotovi, můžete ji odstranit z webu Azure Portal.

• Modely gpt-4 vision-preview se nepodporují.

• Ve výchozím nastavení se aplikace nasadí se zprostředkovatelem identity Microsoftu, který už je nakonfigurovaný a omezí přístup k aplikaci členům vašeho tenanta Azure. Přidání nebo úprava ověřování:

  1. Přejděte na web Azure Portal a vyhledejte název aplikace, který jste zadali při publikování. Vyberte webovou aplikaci a v levé navigační nabídce přejděte na kartu Ověřování . Pak vyberte Přidat zprostředkovatele identity.

     

  2. Jako zprostředkovatele identity vyberte Microsoft. Výchozí nastavení na této stránce omezí aplikaci jenom na vašeho tenanta, takže tady nemusíte měnit nic jiného. Pak vyberte Přidat.

  Teď se uživatelům zobrazí výzva, aby se přihlásili pomocí svého účtu Microsoft Entra ID, aby měli přístup k vaší aplikaci. Pokud chcete, můžete postupovat podle podobného postupu a přidat dalšího zprostředkovatele identity. Aplikace nepoužívá přihlašovací údaje uživatele jiným způsobem než ověřením, že je členem vašeho tenanta.

Přizpůsobení webové aplikace

Logiku front-endu a back-endu aplikace můžete přizpůsobit. Aplikace poskytuje několik proměnných prostředí pro běžné scénáře přizpůsobení, jako je změna ikony v aplikaci. Podívejte se na zdrojový kód webové aplikace a další informace o GitHubu.

Při přizpůsobení aplikace doporučujeme:

• Resetování relace chatu (vymazání chatu), pokud uživatel změní nastavení. Upozorněte uživatele, že dojde ke ztrátě historie chatu.

• Jasně komunikují o tom, jak každé implementující nastavení ovlivní uživatelské prostředí.

• Při obměně klíčů rozhraní API pro prostředek Azure OpenAI nebo Azure AI Search nezapomeňte aktualizovat nastavení aplikace pro každou z nasazených aplikací tak, aby používaly nové klíče.

Ukázkový zdrojový kód pro webovou aplikaci je k dispozici na GitHubu. Zdrojový kód je poskytován jako "tak, jak je" a pouze jako ukázka. Zákazníci zodpovídají za veškeré přizpůsobení a implementaci svých webových aplikací.

Aktualizace webové aplikace

Poznámka:

Po 1. únoru 2024 webová aplikace vyžaduje, aby byla nastavena možnost python3 -m gunicorn app:appspuštění aplikace . Při aktualizaci aplikace publikované před 1. únorem 2024 je nutné ručně přidat spouštěcí příkaz ze stránky Konfigurace služby App Service.

Doporučujeme často stahovat změny z main větve zdrojového kódu webové aplikace, abyste měli jistotu, že máte nejnovější opravy chyb, verzi rozhraní API a vylepšení. Webová aplikace se navíc musí synchronizovat při každém vyřazení používané verze rozhraní API.

Zvažte buď kliknutí na tlačítka kukátka nebo hvězdičky v úložišti GitHub webové aplikace, abyste dostávali oznámení o změnách a aktualizacích zdrojového kódu.

Pokud jste aplikaci nepřizpůsobili:

• Můžete postupovat podle následujících kroků synchronizace.

Pokud jste přizpůsobili nebo změnili zdrojový kód aplikace:

• Zdrojový kód aplikace budete muset aktualizovat ručně a znovu ho nasadit.
  • Pokud je vaše aplikace hostovaná na GitHubu, nasdílejte změny kódu do úložiště a použijte následující postup synchronizace.
  • Pokud aplikaci nasazujete ručně (například Azure CLI), postupujte podle pokynů pro strategii nasazení.

Synchronizace webové aplikace

1. Pokud jste aplikaci přizpůsobili, aktualizujte zdrojový kód aplikace.

2. Přejděte na webovou aplikaci na webu Azure Portal.

3. V navigační nabídce v části Nasazení vyberte Centrum nasazení.

4. V horní části obrazovky vyberte Synchronizovat a potvrďte, že se aplikace znovu nasadí.

   

Historie chatu

Historii chatu můžete povolit uživatelům webové aplikace. Když tuto funkci povolíte, budou mít uživatelé přístup k jednotlivým předchozím dotazům a odpovědím.

Pokud chcete povolit historii chatu, nasaďte nebo znovu nasaďte model jako webovou aplikaci pomocí azure OpenAI Studia.

Důležité

Povolením historie chatu se ve vaší skupině prostředků vytvoří instance Cosmos DB a za využité úložiště se účtují další poplatky .

Jakmile povolíte historii chatu, uživatelé ji budou moct zobrazit a skrýt v pravém horním rohu aplikace. Když se zobrazí historie, můžou konverzace přejmenovat nebo odstranit. Když jsou přihlášeni k aplikaci, konverzace se budou automaticky řadit od nejnovějších po nejstarší a pojmenované na základě prvního dotazu v konverzaci.

Odstranění instance Cosmos DB

Odstraněním webové aplikace se instance Cosmos DB neodstraní automaticky. Pokud chcete odstranit instanci Cosmos DB společně se všemi uloženými chaty, musíte přejít na přidružený prostředek na webu Azure Portal a odstranit ji. Pokud odstraníte prostředek Cosmos DB, ale ponecháte v studiu povolenou možnost historie chatu, budou vaši uživatelé upozorněni na chybu připojení, ale můžou webovou aplikaci dál používat bez přístupu k historii chatu.

Další kroky

• Vytváření efektivních dotazů
• Azure OpenAI na vašich datech