Connettere gli agenti dati all'indice di ricerca Azure in Microsoft Foundry

Gli autori di Data Agent possono ora connettere gli agenti direttamente agli indici Azure AI Search compilati in Microsoft Foundry, sbloccando potenti scenari di dati non strutturati. Usando l'URL della risorsa, è possibile connettersi in modo sicuro all'indice: gli agenti dati rispettano completamente le autorizzazioni delle risorse di intelligenza artificiale Azure. In Foundry è possibile creare indici avanzati di ricerca di intelligenza artificiale con arricchimenti personalizzati, logica di pre-elaborazione e schemi personalizzati per PDF, file di testo e altro ancora. Dopo la connessione, gli agenti dati possono ragionare su tale contenuto non strutturato e persino unire informazioni dettagliate dall'indice con le origini dati strutturate, offrendo una visualizzazione unificata e intelligente in tutti i dati.

Importante

Questa funzionalità si trova in Anteprima.

Prerequisiti

Configurare la risorsa Azure AI Search

Per connettere l'agente dati a un indice Azure AI Search, verificare prima di tutto che la risorsa di ricerca sia configurata correttamente.

  1. Creare un Azure AI Search index.
    Usa la guida introduttiva Azure AI Search per creare un indice. È possibile iniziare con i dati di esempio o usare dati personalizzati.

  2. Abilitare il controllo degli accessi in base al ruolo.
    Attivare l'autenticazione basata su ruoli per il servizio di ricerca e l'indice. Questa autorizzazione consente all'agente dati di accedere in modo sicuro alla risorsa usando l'identità dell'utente che chiede.

    Screenshot dell'abilitazione del controllo degli accessi in base al ruolo.

  3. Assegnare i ruoli necessari.
    Verificare che l'utente o il principale del servizio disponga dei ruoli seguenti nella risorsa Azure AI Search:

    • Search Index Data Contributor
    • Search Index Data Reader

    Queste autorizzazioni assicurano che l'agente dati possa leggere l'indice e recuperare il contenuto pertinente.

  4. Recuperare l'URL della risorsa.
    Copiare l'URL della risorsa per il servizio Azure AI Search. Questo valore è necessario quando si aggiunge la connessione nella configurazione dell'agente dati.

    Screenshot dell'URL della risorsa Azure AI Search.

Suggerimento

L'agente dati può includere citazioni in modo da visualizzare i documenti usati per generare una risposta. Le citazioni vengono visualizzate nell'esperienza utente solo se è presente almeno uno dei campi seguenti (con distinzione tra maiuscole e minuscole): url, sourceUrlfilePath, path, o folderPath.

Per garantire che le citazioni vengano visualizzate correttamente nell'agente dati, è consigliabile includere uno di questi campi nello schema dell'indice.

Connettere l'indice all'agente di dati

  1. Passare alla scheda Dati e selezionare Aggiungi indice di ricerca di intelligenza artificiale.

    Screenshot della scheda Dati nell'agente dati.

  2. Specificare l'URL della risorsa quando richiesto.

    Screenshot dell'inserimento dell'URL della risorsa del Data Agent.

  3. Porre una domanda, ad esempio "Raccontami di più sull'hotel Uptown Chic" per eseguire una query sull'indice.

    Screenshot della risposta dell'agente dati.

  4. Visualizzare i documenti usati per generare la risposta tramite i passaggi di ragionamento.

Annotazioni

Quando un utente pone una domanda, l'agente dati invia l'identità dell'utente all'indice Azure AI Search. Questa autorizzazione garantisce che vengano rispettati i controlli di accesso e le autorizzazioni definiti nell'indice.

Configurare l'indice nell'agente dati

È possibile configurare il modo in cui l'agente dati usa l'indice di ricerca di intelligenza artificiale. È possibile fornire contesto sull'origine, fornire istruzioni sui campi a cui fare riferimento e regolare i parametri che controllano la quantità di contesto restituito.

Context

Usare questo campo per descrivere l'indice di ricerca di intelligenza artificiale. Includere informazioni dettagliate su ciò che l'indice contiene, sui campi chiave e su come usarlo. In questo modo l'agente indirizza correttamente le domande all'indice appropriato.

Screenshot del contesto dell'Agente Dati.

Configurazione

Usare queste impostazioni per controllare il modo in cui l'agente dati esegue query e interpreta i risultati dell'indice di ricerca di intelligenza artificiale:

Impostazione Description
Nome visualizzato Nome visualizzato per questo indice all'interno dell'Agente Dati.
Tipo di ricerca Scegliere tra le opzioni di ricerca disponibili supportate dall'indice, ad esempio full-text, ibrido o ricerca semantica.
Numero di documenti Selezionare il numero di documenti che l'agente deve recuperare per ogni query. L'intervallo consigliato è 3-20. I valori più elevati possono restituire più contesto, ma possono aumentare il tempo di elaborazione.

Screenshot della configurazione dell'agente dati.

Istruzioni agente

Usare le istruzioni dell'agente per guidare l'elaborazione dell'agente e la composizione della risposta finale. Il passaggio di ricerca recupera i blocchi del documento pertinenti, ma le istruzioni indicano all'agente come interpretare tali informazioni, esaminarle e strutturare la risposta.

Screenshot delle istruzioni del Data Agent.

Passaggi successivi