Introduzione alla chat usando un esempio di dati personalizzato per Python

Questo articolo spiega come distribuire ed eseguire l'app di chat con un proprio set di dati di esempio per Python. Questo esempio implementa un'app di chat usando Python, il servizio Azure OpenAI e Retrieval Augmented Generation (RAG) in Ricerca di intelligenza artificiale di Azure per ottenere risposte sui vantaggi dei dipendenti in una società fittizia. L'app viene inizializzata con file PDF che includono il manuale dei dipendenti, un documento sui benefici e un elenco di ruoli e aspettative aziendali.

Guarda il seguente video dimostrativo di .

Seguendo le istruzioni riportate in questo articolo, è possibile:

• Distribuire un'app di chat in Azure.
• Ottenere risposte sui vantaggi dei dipendenti.
• Modificare le impostazioni per modificare il comportamento delle risposte.

Dopo aver completato questa procedura, è possibile iniziare a modificare il nuovo progetto con il codice personalizzato.

Questo articolo fa parte di una raccolta di articoli che illustrano come creare un'app di chat usando Azure OpenAI e Ricerca di intelligenza artificiale di Azure.

Altri articoli della raccolta includono:

• .NET
• Java
• JavaScript
• Front-end JavaScript e back-end Python

Panoramica dell'architettura

Il diagramma seguente illustra una semplice architettura dell'app di chat.

I componenti chiave dell'architettura includono:

• Un'applicazione Web per ospitare l'esperienza di chat interattiva.

• Una risorsa di Ricerca intelligenza artificiale di Azure per ottenere risposte dai propri dati.

• Azure OpenAI fornisce

  • Parole chiave per migliorare la ricerca sui tuoi dati.
  • Risposte dal modello OpenAI di Azure.
  • Incorporamenti dal modello di ada.

Costo

La maggior parte delle risorse in questa architettura usa un piano tariffario di base o a consumo. I prezzi a consumo si basano sull'utilizzo, il che significa che si paga solo per ciò che si usa. È previsto un addebito per accedere a questo articolo, ma è minimo. Quando hai finito con l'articolo, puoi eliminare le risorse per interrompere i costi.

Altre informazioni sui costi nel repository di esempio.

Prerequisiti

Un ambiente di sviluppo è disponibile con tutte le dipendenze necessarie per completare questo articolo. È possibile eseguire il contenitore di sviluppo in GitHub Codespaces (in un browser) o in locale usando Visual Studio Code.

Per usare questo articolo, sono necessari i prerequisiti seguenti.

Aprire un ambiente di sviluppo

Inizia ora con un ambiente di sviluppo che ha tutte le dipendenze installate per completare questo articolo.

Distribuire ed eseguire

Il repository di esempio contiene tutti i file di codice e configurazione necessari per distribuire un'app di chat in Azure. La procedura seguente illustra il processo di distribuzione dell'esempio in Azure.

Distribuire l'app di chat in Azure

1. Esegui il seguente comando Azure Developer CLI per effettuare il provisioning delle risorse di Azure e distribuire il codice sorgente:

   azd up
   

2. Se viene richiesto di immettere un nome di ambiente, mantenerlo breve e usare lettere minuscole. Un esempio è myenv. Viene usato come parte del nome del gruppo di risorse.

3. Quando richiesto, selezionare una sottoscrizione in cui creare le risorse.

4. Quando ti viene richiesto di selezionare una posizione la prima volta, seleziona una posizione nelle vicinanze. Questa posizione viene usata per la maggior parte delle risorse, incluso l'hosting.

5. Se viene richiesta una posizione per il modello Azure OpenAI o per la risorsa Azure AI Document Intelligence, seleziona la località più vicina a te. Se la stessa posizione è disponibile come prima posizione, selezionala.

6. Attendere 5 o 10 minuti dopo la distribuzione dell'app prima di continuare.

7. Dopo la distribuzione dell'applicazione, viene visualizzato un URL nel terminale.

   

8. Selezionare l'URL con etichetta (✓) Done: Deploying service webapp per aprire l'applicazione di chat in un browser.

   

Usare l'app chat per ottenere risposte dai file PDF

L'app di chat viene precaricata con informazioni sui vantaggi dei dipendenti che provengono da file PDF. Puoi usare l'app di chat per porre domande sui vantaggi. I passaggi seguenti illustrano il processo di utilizzo dell'app di chat. Le risposte possono variare man mano che i modelli sottostanti vengono aggiornati.

1. Nel browser selezionare o immettere Cosa accade in una verifica delle prestazioni? nella casella di testo della chat.

   

2. Nella risposta seleziona una citazione.

   

3. Nel riquadro destro puoi utilizzare le schede per comprendere come è stata generata la risposta.

   Scheda	Descrizione
   Processo di pensiero	Questa scheda è uno script delle interazioni nella chat. Puoi visualizzare la richiesta di sistema (content) e la domanda dell'utente (content).
   Contenuto di supporto	Questa scheda include le informazioni per rispondere alla domanda e al materiale di origine. Il numero di citazioni del materiale di origine è annotato nelle impostazioni di Sviluppatore . Il valore predefinito è 3.
   Citazione	In questa scheda viene visualizzata la pagina originale contenente la citazione.

4. Al termine, selezionare di nuovo la scheda per chiudere il riquadro.

Usare le impostazioni dell'app chat per modificare il comportamento delle risposte

L'intelligenza della chat è determinata dal modello OpenAI di Azure e dalle impostazioni usate per interagire con il modello.

I passaggi seguenti illustrano il processo di modifica delle impostazioni.

1. Nel browser selezionare la scheda Impostazioni sviluppatore.

2. Selezionare la casella di controllo Suggerisci domande di completamento e porre nuovamente la stessa domanda.

   What happens in a performance review?
   

   La chat ha restituito domande di follow-up suggerite, ad esempio gli esempi seguenti:

   1. What is the frequency of performance reviews?
   2. How can employees prepare for a performance review?
   3. Can employees dispute the feedback received during the performance review?
   

3. Nella scheda Impostazioni, deselezionare la casella di controllo Usa classificazione semantica per il recupero.

4. Porre di nuovo la stessa domanda.

   What happens in a performance review?
   

5. Qual è la differenza nelle risposte?

   • Con il ranker semantico: durante una revisione delle prestazioni in Contoso Electronics, i dipendenti hanno l'opportunità di discutere dei loro successi e delle sfide sul posto di lavoro (1). La revisione fornisce feedback positivo e costruttivo per aiutare i dipendenti a sviluppare e crescere nei loro ruoli (1). Il dipendente riceve un riepilogo scritto della revisione delle prestazioni, che include una valutazione delle prestazioni, feedback e obiettivi per l'anno prossimo (1). La revisione delle prestazioni è un dialogo bidirezionale tra manager e dipendenti (1).
   • Senza il rango semantico: Durante una valutazione delle prestazioni presso Contoso Electronics, i dipendenti hanno l'opportunità di discutere dei successi e delle sfide nel luogo di lavoro. Viene fornito feedback positivo e costruttivo per aiutare i dipendenti a sviluppare e crescere nei loro ruoli. Viene fornito un riepilogo scritto della revisione delle prestazioni, tra cui una valutazione delle prestazioni, il feedback e gli obiettivi per l'anno prossimo. La revisione è un dialogo bidirezionale tra manager e dipendenti (1).

Pulire le risorse

I passaggi seguenti illustrano il processo di pulizia delle risorse usate.

Pulire le risorse di Azure

Le risorse di Azure create in questo articolo vengono fatturate alla sottoscrizione di Azure. Se prevedi che queste risorse non ti servano in futuro, eliminale per evitare di incorrere in costi aggiuntivi.

Esegui il seguente comando Azure Developer CLI per eliminare le risorse di Azure e rimuovere il codice sorgente:

azd down --purge --force

Le opzioni forniscono:

• purge: Le risorse cancellate vengono immediatamente rimosse così da poter riutilizzare i token OpenAI di Azure per ogni minuto.
• force: l'eliminazione viene eseguita automaticamente, senza richiedere il consenso dell'utente.

Pulire GitHub Codespaces e Visual Studio Code

Come ottenere assistenza

Questo repository di esempio offre informazioni sulla risoluzione dei problemi.

Se il problema non viene risolto, aggiungi il tuo problema alla pagina del repository Problematiche.

Contenuto correlato

• Ottenere il codice sorgente per l'esempio usato in questo articolo.
• Crea un'app di chat con Azure OpenAI architettura delle soluzioni consigliate.
• Scopri il controllo di accesso nelle app di intelligenza artificiale generativa con Azure AI Search.
• Creare una soluzione Azure OpenAI aziendale con Gestione API di Azure.
• Consulta Azure AI Search: supera la ricerca vettoriale con funzionalità ibride di ricerca e classificazione.