Usare l'app Web OpenAI di Azure
Insieme a Studio OpenAI di Azure, API e SDK, è anche possibile usare l'app Web autonoma disponibile per interagire con i modelli OpenAI di Azure usando un'interfaccia utente grafica, distribuibile mediante Studio OpenAI di Azure o distribuzione manuale.
Considerazioni importanti
La pubblicazione crea un Servizio app di Azure nella sottoscrizione. Potrebbe comportare costi, a seconda del piano prezzi selezionato. Una volta terminato di usare l'app, è possibile eliminarla dal portale di Azure.
I modelli gpt-4 vision-preview non sono supportati.
Per impostazione predefinita, l'app sarà distribuita con il provider di identità Microsoft già configurato, e l'accesso all'app sarà limitato ai membri del tenant di Azure. Per aggiungere o modificare l'autenticazione:
Nel portale di Azure cercare il nome dell'app specificato durante la pubblicazione. Selezionare l'app Web e passare alla scheda Autenticazione nel menu di spostamento a sinistra. Quindi, selezionare Aggiungere un provider di identità.
Selezionare Microsoft come provider di identità. Le impostazioni predefinite in questa pagina limiteranno l'app solo al tenant, quindi non è necessario modificare altri elementi qui. Quindi selezionare Aggiungi
A questo punto agli utenti sarà chiesto di accedere con il proprio account Microsoft Entra per poter accedere all'app. Se si preferisce, è possibile seguire un processo simile per aggiungere un altro provider di identità. L'app usa le informazioni di accesso dell'utente unicamente per verificare che siano membri del tenant.
Personalizzazione dell'app Web
La logica front-end e back-end dell'app sono personalizzabili. L'app fornisce diverse variabili di ambiente per scenari di personalizzazione comuni, ad esempio la modifica dell'icona nell'app. Vedere il codice sorgente per l'app Web e altre informazioni su GitHub.
Quando si personalizza l'app, è consigliabile:
Reimpostazione della sessione di chat (cancella chat) se l'utente modifica le impostazioni. Notificare l'utente per informare che la cronologia delle chat andrà persa.
Comunicare chiaramente che qualsiasi impostazione implementata influirà sull'esperienza utente.
Nel ruotare le chiavi API per la risorsa OpenAI di Azure o Azure AI Search, assicurarsi di aggiornare le impostazioni dell'app per ognuna delle app distribuite per l’uso delle nuove chiavi.
Il codice sorgente di esempio per l'app Web è disponibile in GitHub. Il codice sorgente è fornito "così come è" e vale solo come esempio. I clienti sono responsabili di tutte le personalizzazioni e l'implementazione delle app Web.
Aggiornamento dell'app Web
Nota
Dopo il 1° febbraio 2024, il comando di avvio dell'app Web deve essere impostato su python3 -m gunicorn app:app. Per aggiornare un'app pubblicata prima del 1° febbraio 2024, è necessario aggiungere manualmente il comando di startup dalla pagina Configurazione del servizio app.
È consigliabile eseguire frequentemente il pull delle modifiche dal ramo main per il codice sorgente dell'app Web, per assicurarsi di avere le correzioni di bug, la versione dell'API e i miglioramenti più recenti. Inoltre, l'app Web deve essere sincronizzata ogni volta che la versione dell'API usata viene ritirata.
Prendere in considerazione la possibilità di fare clic sui pulsanti espressione di controllo o stella nel repository GitHub dell'app Web per ricevere notifiche sulle modifiche e sugli aggiornamenti al codice sorgente.
Se l'app non è stata personalizzata:
- È possibile seguire la procedura di sincronizzazione seguente
Se hai personalizzato o modificato il codice sorgente dell'app:
- Dovrai aggiornare il codice sorgente dell'app manualmente e ridistribuirlo.
- Se l'app è ospitata in GitHub, eseguire il push delle modifiche al codice nel repository e seguire questa procedura di sincronizzazione.
- Se si ridistribuisce l'app manualmente (ad esempio l'interfaccia della riga di comando di Azure), seguire i passaggi per la strategia di distribuzione.
Sincronizzare l'app Web
Se l'app è stata personalizzata, aggiornare il codice sorgente dell'app.
Passare all'app Web nel portale di Azure.
Selezionare Centro distribuzione nel menu di spostamento, in Distribuzione.
Selezionare Sincronizza nella parte superiore della schermata e verificare che l'app venga ridistribuita.
Cronologia chat
È possibile abilitare la cronologia delle chat per gli utenti dell'app Web. Quando si abilita la funzionalità, gli utenti avranno accesso alle singole query e alle risposte precedenti.
Per abilitare la cronologia delle chat, distribuire o ridistribuire il modello come app Web usando Azure OpenAI Studio.
Importante
L'abilitazione della cronologia delle chat crea un'istanza Cosmos DB nel gruppo di risorse e comporta costi aggiuntivi per l'archiviazione usata.
Una volta abilitata la cronologia delle chat, gli utenti potranno visualizzarla e nasconderla nell'angolo superiore destro dell'app. Nel visualizzare la cronologia, è possibile rinominare o eliminare conversazioni. Quando vengono registrate nell'app, le conversazioni verranno ordinate automaticamente dalla più recente alla meno recente e denominate in base alla prima query nella conversazione.
Eliminazione dell'istanza di Cosmos DB
L'eliminazione dell'app Web non comporta l'eliminazione automatica dell'istanza di Cosmos DB. Per eliminare l'istanza di Cosmos DB, insieme a tutte le chat archiviate, è necessario passare alla risorsa associata nel portale di Azure ed eliminarla. Se si elimina la risorsa Cosmos DB ma si mantiene abilitata l'opzione cronologia chat in Studio, gli utenti riceveranno una notifica di errore di connessione, ma possono continuare a usare l'app Web senza accedere alla cronologia delle chat.