Usare l'app Web OpenAI di Azure

Insieme ad Azure OpenAI Studio, API e SDK, è possibile usare l'app Web autonoma disponibile per interagire con i modelli del Servizio OpenAI di Azure usando un'interfaccia utente grafica. È possibile distribuire l'app usando Azure OpenAI Studio o una distribuzione manuale.

Considerazioni importanti

• La pubblicazione crea un'istanza del 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 di GPT-4 Turbo with Vision non sono supportati.

• Per impostazione predefinita, l'app viene distribuita con il provider di identità Microsoft già configurato. Il provider di identità limita l'accesso all'app ai membri del tenant di Azure. Per aggiungere o modificare l'autenticazione:

  1. Passare al portale di Azure e cercare il nome dell'app specificato durante la pubblicazione. Selezionare l'app Web e quindi selezionare Autenticazione nel menu a sinistra. Selezionare quindi Aggiungi provider di identità.

     

  2. Selezionare Microsoft come provider di identità. Le impostazioni predefinite in questa pagina limitano l'app solo al tenant, quindi qui non è necessario modificare altri elementi. Selezionare Aggiungi.

  A questo punto agli utenti sarà chiesto di accedere con il proprio account Microsoft Entra per 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 l'utente sia membro 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.

Quando si personalizza l'app, è consigliabile:

• Reimpostare la sessione di chat (cancellare la chat) se gli utenti modificano eventuali impostazioni. Segnalare agli utenti che la cronologia delle chat andrà persa.

• Comunicare chiaramente che qualsiasi impostazione implementata influirà sull'esperienza utente.

• Aggiornare le impostazioni dell'app per ognuna delle app distribuite per l'uso di nuove chiavi API dopo aver ruotato le chiavi per la risorsa di Azure OpenAI o Azure AI Search.

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 dell'implementazione delle app Web.

Aggiornamento dell'app Web

Nota

A partire dal 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 avvio 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. L'app Web deve essere inoltre sincronizzata ogni volta che la versione dell'API usata viene ritirata. Valutare la possibilità di selezionare il pulsante Watch o Star nel repository GitHub dell'app Web per ricevere notifiche sulle modifiche e sugli aggiornamenti al codice sorgente.

Se l'app Web non è stata personalizzata, è possibile usare questi passaggi per sincronizzarla:

1. Passare all'app Web nel portale di Azure.

2. Nel menu a sinistra in Distribuzione selezionare Centro distribuzione.

3. Selezionare Sincronizza nella parte superiore del riquadro e verificare che l'app venga ridistribuita.

   

Se il codice sorgente dell'app è stato personalizzato o modificato, è necessario aggiornare manualmente il codice sorgente dell'app e ridistribuirlo:

• Se l'app è ospitata in GitHub, eseguire il push delle modifiche al codice nel repository e quindi seguire la procedura di sincronizzazione precedente.
• Se si ridistribuisce l'app manualmente, ad esempio tramite l'interfaccia della riga di comando di Azure, seguire i passaggi per la strategia di distribuzione.

Cronologia chat

È possibile attivare la cronologia delle chat per gli utenti dell'app Web. Quando si attiva la funzionalità, gli utenti hanno accesso alle singole query e risposte precedenti.

Per attivare la cronologia delle chat, distribuire o ridistribuire il modello come app Web usando Azure OpenAI Studio e selezionare Abilita cronologia chat nell'app Web.

Importante

L'attivazione della cronologia delle chat crea un'istanza di Azure Cosmos DB nel gruppo di risorse e comporta costi aggiuntivi per l'archiviazione usata.

Dopo aver attivato la cronologia delle chat, gli utenti possono visualizzarla e nasconderla nell'angolo superiore destro dell'app. Quando gli utenti mostrano la cronologia delle chat, possono rinominare o eliminare conversazioni. Poiché gli utenti hanno eseguito l'accesso all'app, le conversazioni vengono ordinate automaticamente dalla più recente alla meno recente. Le conversazioni vengono denominate in base alla prima domanda 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 attivata l'opzione cronologia delle chat in Studio, gli utenti ricevono una notifica di errore di connessione, ma possono continuare a usare l'app Web senza accedere alla cronologia delle chat.

Contenuto correlato

• Progettazione prompt
• Azure OpenAI sui dati