Condividi tramite


Come compilare e usare gli indici vettoriali in Studio AI della piattaforma Azure

Importante

Alcune funzionalità descritte in questo articolo potrebbero essere disponibili solo in anteprima. Questa anteprima viene fornita senza un contratto di servizio e non è consigliabile per i carichi di lavoro di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero presentare funzionalità limitate. Per altre informazioni, vedere le Condizioni supplementari per l'uso delle anteprime di Microsoft Azure.

In questo articolo viene illustrato come creare e usare un indice vettoriale per l'esecuzione della RAG (Retrieval Augmented Generation).

Prerequisiti

Devi avere:

  • Un progetto di Studio AI della piattaforma Azure
  • Una risorsa Azure AI Search

Creazione di un indice dalla scheda Indici

  1. Accedere a Studio AI della piattaforma Azure.

  2. Passare al progetto o creare un nuovo progetto in Studio AI della piattaforma Azure.

  3. Dal menu a scomparsa a sinistra selezionare Indici in Componenti.

    Screenshot del menu di progetto a sinistra.

  4. Selezionare + Nuovo indice

  5. Scegliere i dati di origine. È possibile scegliere i dati di origine da un elenco delle origini dati recenti, un URL di archiviazione sul cloud o anche caricare file e cartelle dal computer locale. È inoltre possibile aggiungere una connessione a un'altra origine dati, ad esempio Archiviazione BLOB di Azure.

    Screenshot della selezione dei dati di origine.

  6. Selezionare Avanti dopo aver scelto i dati di origine

  7. Scegliere l'archiviazione indice: la posizione in cui si vuole archiviare l'indice

  8. Se è già stata creata una connessione per un servizio Azure AI Search, è possibile scegliere tale connessione dall'elenco a discesa.

    Screenshot di selezione dell'archivio degli indici.

    1. Se non si ha una connessione esistente, scegliere Connetti un altro servizio Azure AI Search
    2. Selezionare la sottoscrizione e il servizio che si vuole usare.

    Screenshot di selezione dei dettagli dell'archivio degli indici.

  9. Selezionare Avanti dopo aver scelto l'archiviazione indice

  10. Configurare le impostazioni di ricerca

    1. Le Impostazioni del vettore per impostazione predefinita sono True per Aggiungi ricerca vettoriale a questa risorsa di ricerca. Come indicato, questa opzione abilita le opzioni di ricerca ibrida e ibrida + semantica. La disabilitazione di questa opzione comporta la limitazione delle opzioni di ricerca vettoriale a Parola chiave e Semantica.
    2. Per consentire il funzionamento dell'opzione ibrida, è necessario un modello di incorporamento. Scegliere un modello di incorporamento dall'elenco a discesa.
    3. Selezionare il consenso per distribuire un modello di incorporamento, se non esiste già nella risorsa

    Screenshot della configurazione delle impostazioni di ricerca.

    Se un modello OpenAI non di Azure non viene visualizzato nell'elenco a discesa, attenersi alla procedura seguente:

    1. Passare alle impostazioni del progetto in Studio AI della piattaforma Azure.
    2. Passare alla sezione Connessioni nella scheda Impostazioni e selezionare Nuova connessione.
    3. Selezionare Modello serverless.
    4. Digitare il nome della distribuzione modello di incorporamento e selezionare Aggiungi connessione. Se il modello non viene visualizzato nell'elenco a discesa, selezionare l'opzione Immettere manualmente.
    5. Immettere l'endpoint API di distribuzione, il nome del modello e la chiave API nei campi corrispondenti. Aggiungere quindi la connessione.
    6. Il modello di incorporamento dovrebbe ora essere visualizzato nell'elenco a discesa.

    Screenshot della connessione di un modello serverless.

  11. Selezionare Avanti dopo aver configurato le impostazioni di ricerca

  12. Nelle impostazioni dell'indice

    1. Immettere un nome per l'indice o usare il nome inserito automaticamente
    2. Pianificare gli aggiornamenti. È possibile scegliere di aggiornare l'indice ogni ora oppure ogni giorno.
    3. Scegliere il calcolo in cui si vogliono eseguire i processi per creare l'indice. È possibile
      • Selezionare automaticamente per consentire ad Azure per intelligenza artificiale di scegliere una dimensione di macchina virtuale appropriata disponibile
      • Scegliere le dimensioni della macchina virtuale da un elenco di opzioni consigliate
      • Scegliere le dimensioni della macchina virtuale da un elenco di tutte le opzioni possibili

    Screenshot della configurazione delle impostazioni dell'indice.

  13. Selezionare Avanti dopo aver configurato le impostazioni dell'indice

  14. Ricontrollare i dettagli immessi e selezionare Crea

  15. Viene visualizzata la pagina dei dettagli dell'indice, in cui è possibile vedere lo stato della creazione dell'indice.

Creazione di un indice dal playground

  1. Aprire il progetto di Studio AI della piattaforma Azure.

  2. Passare alla scheda Playground.

  3. L'opzione Seleziona indice del progetto disponibile viene visualizzato per gli indici esistenti nel progetto. Se non viene usato un indice esistente, continuare con i passaggi successivi.

  4. Selezionare l'elenco a discesa Aggiungi dati.

    Screenshot del playground con il menu Aggiungi dati.

  5. Se viene creato un nuovo indice, selezionare l'opzione Aggiungi dati. Seguire quindi i passaggi da Creare un indice dalla scheda Indici per spostarsi nella procedura guidata per la creazione di un indice.

    1. Se è in uso un indice esterno, selezionare l'opzione Connetti indice esterno.

    2. In Origine indice

      1. Selezionare l'origine dati
      2. Selezionare il servizio di ricerca basato su intelligenza artificiale
      3. Selezionare i file da utilizzare.

      Screenshot della pagina in cui si seleziona un indice.

    3. Selezionare Avanti dopo aver configurato le impostazioni di ricerca.

    4. Nelle impostazioni dell'indice

      1. Immettere un nome per l'indice o usare il nome inserito automaticamente
      2. Pianificare gli aggiornamenti. È possibile scegliere di aggiornare l'indice ogni ora oppure ogni giorno.
      3. Scegliere il calcolo in cui si vogliono eseguire i processi per creare l'indice. È possibile
        • Selezionare automaticamente per consentire ad Azure per intelligenza artificiale di scegliere una dimensione di macchina virtuale appropriata disponibile
        • Scegliere le dimensioni della macchina virtuale da un elenco di opzioni consigliate
        • Scegliere le dimensioni della macchina virtuale da un elenco di tutte le opzioni possibili
    5. Ricontrollare i dettagli immessi e selezionare Crea.

    6. L'indice è ora pronto per essere usato nel playground.

Usare un indice nel prompt flow

  1. Accedere a Studio AI della piattaforma Azure e selezionare il progetto.

  2. Dal menu a scomparsa a sinistra selezionare Prompt flow.

  3. Aprire un prompt flow esistente o selezionare + Crea per creare un nuovo flusso.

  4. Nel menu in alto nella finestra di progettazione del flusso, selezionare Altri strumenti e quindi selezionare Ricerca indice.

    Screenshot della ricerca dell'indice vettoriale da Altri strumenti.

  5. Specificare un nome per lo strumento di ricerca indice e selezionare Aggiungi.

  6. Selezionare la casella del valore mlindex_content e selezionare l'indice. Dopo aver completato questo passaggio, immettere le query e i query_types da eseguire sull'indice.

    Screenshot del nodo del prompt flow per configurare la ricerca dell'indice.