Condividi tramite


Aggiungere Azure AI Search come origine delle informazioni

Azure AI Search offre un potente motore di ricerca in grado di eseguire ricerche in un'ampia raccolta di documenti. Copilot Studio supporta l'aggiunta di Azure AI Search come origine delle conoscenze.

Per completare la connessione, è necessario un account Azure. Se non si ha un account Azure, è possibile creare un account in Microsoft Azure.

Dopo aver creato l'account Azure, utilizzare i seguenti articoli di Azure per impostare e configurare Azure AI Search. Questi articoli forniscono informazioni sull'installazione e sulla configurazione necessarie per usare la connessione Azure AI Search come origine della knowledge base:

In questo caso viene usata l'autenticazione basata su chiave per connettersi a Azure AI Search.

Copilot Studio supporta indici vettorializzati con vettorizzazione integrata. Preparare i dati e scegliere un modello incorporato, quindi usare Importare e vettorializzare i dati in Azure AI Search per creare indici vettoriali. Questo metodo consente al sistema di utilizzare lo stesso modello incorporato utilizzato per vettorializzare i dati e la richiesta in ingresso in fase di esecuzione, riducendo la necessità di scrivere funzioni speciali per fare la stessa azione.

Copilot Studio supporta anche l'uso della funzionalità semantic ranker. Questa funzionalità deve essere configurata anche in Azure AI Search prima di aggiungere la connessione in Copilot Studio. Per altre informazioni, vedi Come iniziare a utilizzare Classificatore semantico.

Nota

È necessario aggiungere Azure AI Search tramite una connessione formale data. Non configurare manualmente un endpoint e una chiave API.

Se si crea una connessione Azure AI Search non supportata, Copilot Studio potrebbe archiviare una connessione dati difettosa che impedisce il caricamento della finestra di dialogo di connessione Azure AI Search. In questo caso, la finestra di dialogo potrebbe apparire brevemente e quindi generare un errore. Copilot Studio attualmente non fornisce un'interfaccia per eliminare una connessione dati Azure AI Search interrotta. Poiché le connessioni dati vengono gestite a livello di ambiente, questo problema può influire su tutti gli agenti.

Per ripristinare la connessione, reimpostare l'accesso esterno o eliminare l'agente e ricreare l'agente interessato. Quando si aggiunge nuovamente Azure AI Search, usare Origini dati → Azure AI Search con autenticazione Entra ID e non con chiavi API.

  1. Apri l'agente.

  2. Seleziona Aggiungi conoscenza dalla pagina Panoramica o Conoscenza oppure dalle Proprietà di un nodo di risposte generative.

  3. Dalla finestra di dialogo Aggiungi conoscenza, seleziona In primo piano.

  4. Selezionare Azure AI Search.

  5. Seleziona Crea nuova connessione.

  6. Seleziona Tipo di autenticazione. L'utente ha a disposizione le seguenti opzioni:

    • Chiave di accesso
    • Autenticazione tramite certificato del client
    • Principal di servizio (applicazione Microsoft Entra ID)
    • Microsoft Entra ID integrata
  7. Immetti i dettagli necessari per il tipo di autenticazione. Per l'autenticazione basata su chiave, come descritto nella sezione di configurazione precedente, immettere l'URL dell'endpoint <>Azure AI Search e la chiave di amministrazione Azure AI Search.

  8. Seleziona Crea per completare la connessione. Viene visualizzato un segno di spunta verde per confermare la connessione.

  9. Seleziona Avanti.

  10. Immettere l'indice vettoriale Azure AI Search da usare. È possibile aggiungere un solo indice vettoriale.

  11. Seleziona Aggiungi all'agente per completare la connessione.

Dopo aver aggiunto la connessione, viene visualizzata nella tabella delle origini della Knowledge Base. Lo stato viene visualizzato come In progress mentre Copilot Studio indicizza i metadati nelle tabelle. Al termine dell'indicizzazione, lo stato viene aggiornato a Pronto ed è possibile iniziare a testare la fonte di conoscenza. Durante il test, è possibile verificare che siano stati chiamati i riferimenti appropriati esaminando i file e le citazioni dell'agente.

Restituzione citazioni

Per restituire citazioni quando si usa Azure AI Search in Copilot Studio, includere un campo URL con il collegamento effettivo al documento nell'indice di ricerca. Quando il campo metadata_storage_path è incluso nell'indice, Copilot Studio interpreta tale campo come citazione. Tuttavia, se tale campo non esiste, Copilot Studio considera qualsiasi campo contenente un collegamento URL completo come citazione. Per altre informazioni, vedere contenuto del file indice e metadati utilizzando Azure AI Search

Nota

Quando si configurano le citazioni in Azure AI Search, assicurarsi che gli utenti dell'agente dispongano delle autorizzazioni necessarie per accedere alle origini dati a cui puntano le citazioni. Ad esempio, se si aggiunge un URL nell'indice di ricerca che rimanda a un sito Web o a una Knowledge Base, gli utenti dovrebbero avere accesso a tali fonti. Se l'URL punta a un'origine dati con restrizioni, gli utenti non possono accedere alle citazioni generate.

supporto della Rete Virtuale

Copilot Studio supporta gli indici Azure AI Search configurati per le reti virtuali. Questa configurazione consente di usare un endpoint privato per connettere in modo sicuro gli indici di ricerca.

Per istruzioni su come configurare l'endpoint, vedere Creare un endpoint privato per Azure AI Search

Configurare il supporto di Rete virtuale nell'ambiente Power Platform, vedere Configurare il supporto per Rete virtuale per Power Platform.

In Copilot Studio seguire steps per completare la configurazione della connessione.