Configurare i connettori di Microsoft Graph nel interfaccia di amministrazione di Microsoft 365

Questo articolo illustra il processo di base necessario per configurare i connettori di Microsoft Graph nel interfaccia di amministrazione di Microsoft 365. Il processo di base include i passaggi seguenti: (Provare a rendere questo contenuto più dinamico).

Nota

Il processo di installazione è simile per tutti i connettori di Microsoft Graph, ma non è esattamente lo stesso. Oltre a leggere questo articolo, assicurarsi di leggere le informazioni specifiche del connettore per l'origine dati.

Passaggio 1: Aggiungere un connettore Microsoft Graph nel interfaccia di amministrazione di Microsoft 365

Completare la procedura seguente per configurare uno dei connettori di Microsoft Graph (o fare clic qui per accedere direttamente al Catalogo connettori):

1. Accedere all'account amministratore nel interfaccia di amministrazione di Microsoft 365.

2. Nel riquadro di spostamento selezionare Impostazioni e quindi selezionare Cerca & intelligence. Selezionare la scheda Origini dati.

3. Selezionare +Aggiungi e quindi selezionare l'origine dati scelta dal menu delle opzioni disponibili.

   

Nota

È possibile aggiungere un massimo di trenta (30) connessioni di Microsoft Graph a ogni tenant.

Consiglio

Indagine sul prodotto

Per comprendere i requisiti relativi alla connessione di altre origini dati a Copilot o Microsoft Search, è necessario attendere alcuni minuti per compilare il modulo del sondaggio. In base ai risultati del sondaggio, Microsoft creerà connettori per le principali origini dati richieste.

Passaggio 2: Assegnare un nome alla connessione

Specificare questi attributi:

• Nome (obbligatorio)
• ID connessione (obbligatorio)
• Descrizione (facoltativo)
• Selezionare la casella di controllo (obbligatorio)

L'ID connessione crea proprietà implicite per il connettore. Deve contenere solo caratteri alfanumerici e deve contenere un massimo di 32 caratteri.

Per migliorare l'amministrazione della connessione e aiutare Copilot a migliorare i risultati della connessione per l'utente, la descrizione deve rispondere brevemente alle domande seguenti:

• Che tipo di contenuto ha questa connessione?
• In che modo gli utenti fanno riferimento a questa origine di contenuto nelle rispettive organizzazioni?
• Quale parte del flusso di lavoro gli utenti fanno riferimento a questo contenuto nel lavoro quotidiano?
• Quali sono alcune caratteristiche del contenuto?

Per altre informazioni, vedere l'articolo Miglioramento dell'individuazione Microsoft Copilot con graph connector.

Passaggio 3: Configurare le impostazioni di connessione

Il processo di configurazione delle impostazioni di connessione varia in base al tipo di origine dati. Per il tipo di origine dati da aggiungere al tenant per completare questo passaggio nel processo di installazione, vedere le informazioni specifiche del connettore.

Per altre informazioni sulla connessione a un'origine dati locale, vedere Configurare Microsoft Graph Connector Agent.

Passaggio 4: Selezionare le proprietà

È possibile scegliere le proprietà indicizzate da Microsoft Search.

Nota

Per aggiornare le proprietà sottoposte a ricerca per indicizzazione dopo la creazione di una connessione, vedere l'articolo gestire lo schema di ricerca .

Passaggio 5: Gestire le autorizzazioni di ricerca

Gli elenchi di controllo di accesso (ACL) determinano quali utenti dell'organizzazione possono accedere a ogni elemento.

Alcuni connettori, ad esempio Microsoft SQL e Azure Data Lake Storage Gen2 supportano in modo nativo Microsoft Entra ID ACL.

Altri connettori come ServiceNow Knowledge, ServiceNow Catalog, Azure DevOps Work Items e Salesforce supportano la sincronizzazione di utenti e gruppi non Azure AD.

La selezione di tutti consente a tutti gli utenti dell'organizzazione di visualizzare i risultati della ricerca da questa origine dati.

Passaggio 6: Assegnare etichette di proprietà

È possibile assegnare etichette semantica alle proprietà di origine nella pagina "Assegna etichette di proprietà". Le etichette sono tag noti forniti da Microsoft che forniscono significato semantico. Consentono a Microsoft di integrare i dati del connettore nelle esperienze di Microsoft 365, ad esempio ricerca avanzata, schede persone, individuazione intelligente e altro ancora.

Nella tabella seguente sono elencate le etichette attualmente supportate e le relative descrizioni.

Etichetta	Descrizione
titolo	Titolo dell'elemento da visualizzare nella ricerca e in altre esperienze
url	URL di destinazione dell'elemento nel sistema di origine
Creato da	Nome della persona che ha creato l'elemento
Autore ultima modifica	Nome della persona che ha modificato l'elemento più di recente
Autori	Nome delle persone che hanno partecipato/collaborato all'elemento
Data e ora di creazione	Ora di creazione dell'elemento
Data e ora dell'ultima modifica	Ora in cui l'elemento è stato modificato più di recente
Nome file	Nome dell'elemento file
Estensione del file	Tipo di elemento file, ad esempio .pdf o .word

Le proprietà in questa pagina sono prese selezionate in base all'origine dati, ma è possibile modificare questa selezione se è presente una proprietà diversa più adatta per una particolare etichetta.

Il titolo dell'etichetta è l'etichetta più importante. È consigliabile avere una proprietà assegnata a questa etichetta per consentire alla connessione di partecipare all'esperienza del cluster dei risultati.

Il mapping errato delle etichette causa un'esperienza di ricerca deteriorata. Per alcune etichette non è possibile assegnare una proprietà.

Passaggio 7: Gestire lo schema

Proprietà Content

È consigliabile selezionare una proprietà contenuto dal menu a discesa delle opzioni o mantenere l'impostazione predefinita se presente. Questa proprietà viene utilizzata per l'indicizzazione full-text del contenuto, la generazione di frammenti di pagina dei risultati di ricerca, la partecipazione al cluster dei risultati , il rilevamento della lingua, il supporto HTML/testo, la classificazione e la pertinenza e la formulazione delle query.

Se si seleziona una proprietà di contenuto, è possibile usare la proprietà generata dal sistema ResultSnippet quando si crea il tipo di risultato. Questa proprietà funge da segnaposto per i frammenti dinamici generati dalla proprietà del contenuto in fase di query. Se si usa questa proprietà nel tipo di risultato, i frammenti di codice vengono generati nei risultati della ricerca.

Alias per le proprietà di origine

È possibile aggiungere alias alle proprietà nella colonna "Alias" nella pagina "Gestisci schema". Gli alias sono nomi descrittivi per le proprietà. Vengono usati nelle query e nella creazione di filtri. Vengono inoltre usati per normalizzare le proprietà di origine da più connessioni in modo che abbiano lo stesso nome. In questo modo è possibile creare un singolo filtro per un verticale con più connessioni. Per altre informazioni, vedere Personalizzare la pagina dei risultati della ricerca.

Attributi dello schema di ricerca

È possibile impostare gli attributi dello schema di ricerca per controllare la funzionalità di ricerca di ogni proprietà di origine. Uno schema di ricerca consente di determinare quali risultati vengono visualizzati nella pagina dei risultati della ricerca e quali informazioni gli utenti finali possono visualizzare e accedere.

Gli attributi dello schema di ricerca includono le opzioni Query, Search, Retrieve e Refine. Nella tabella seguente sono elencati tutti gli attributi supportati dai connettori di Microsoft Graph e vengono illustrate le relative funzioni.

Attributo dello schema di ricerca	Funzione	Esempio
RICERCA	Rende ricercabile il contenuto di testo di una proprietà. Il contenuto della proprietà è incluso nell'indice full-text.	Se la proprietà è title, una query per Enterprise restituisce le risposte che contengono la parola Enterprise in qualsiasi testo o titolo.
QUESITO	Cerca per query una corrispondenza per una particolare proprietà. Il nome della proprietà può quindi essere specificato nella query a livello di codice o verbatim.	Se è possibile eseguire query sulla proprietà Title , la query Title: Enterprise è supportata.
RECUPERARE	Solo le proprietà recuperabili possono essere usate nel tipo di risultato e visualizzate nel risultato della ricerca.
RAFFINARE	L'opzione affinamento può essere usata come nella pagina dei risultati di Microsoft Search.	Gli utenti dell'organizzazione possono filtrare in base all'URL nella pagina dei risultati della ricerca se la proprietà refine è contrassegnata durante l'installazione della connessione.

Per tutti i connettori tranne il connettore condivisione file, i tipi personalizzati devono essere impostati manualmente. Per attivare le funzionalità di ricerca per ogni campo, è necessario eseguire il mapping di uno schema di ricerca a un elenco di proprietà. La configurazione della connessione assistente seleziona automaticamente uno schema di ricerca in base al set di proprietà di origine scelto. È possibile modificare questo schema selezionando le caselle di controllo per ogni proprietà e attributo nella pagina dello schema di ricerca.

Restrizioni e raccomandazioni per le impostazioni dello schema di ricerca

• La proprietà content è ricercabile solo. Dopo la selezione nell'elenco a discesa, questa proprietà non può essere usata con le opzioni recuperate o query.

• Si verificano problemi di prestazioni significativi durante il rendering dei risultati della ricerca con la proprietà content . Un esempio è il campo Contenuto di testo per un articolo della Knowledge Base ServiceNow .

• Solo le proprietà contrassegnate come recuperabili vengono eseguite nei risultati della ricerca e possono essere usate per creare tipi di risultati moderni.Only properties marked as retrievable render in the search results and can be used to create modern result types (MRT).

• Solo le proprietà stringa possono essere contrassegnate come ricercabili.

Nota

Per aggiornare lo schema dopo la creazione di una connessione, vedere l'articolo gestire lo schema di ricerca .

Passaggio 8: Aggiornare le impostazioni

L'intervallo di aggiornamento determina la frequenza con cui i dati vengono sincronizzati tra l'origine dati e Microsoft Search. Ogni tipo di origine dati ha un set diverso di pianificazioni di aggiornamento ottimali in base alla frequenza di modifica dei dati e al tipo di modifiche.

Esistono due tipi di intervalli di aggiornamento, aggiornamento completo e aggiornamento incrementale, ma gli aggiornamenti incrementali non sono disponibili per alcune origini dati.

Con un aggiornamento completo, il motore di ricerca elabora e indicizza gli elementi modificati nell'origine di contenuto, indipendentemente dalle ricerche per indicizzazione precedenti. Un aggiornamento completo funziona meglio per queste situazioni:

• Rilevamento delle eliminazioni di dati.
• L'aggiornamento incrementale ha rilevato errori e non è riuscito.
• Gli ACL sono stati modificati.
• Le regole di ricerca per indicizzazione sono state modificate.
• Lo schema per la connessione è stato aggiornato.

Con un aggiornamento incrementale, il motore di ricerca può elaborare e indicizzare solo gli elementi creati o modificati dopo l'ultima ricerca per indicizzazione riuscita. Di conseguenza, non tutti i dati nell'origine di contenuto vengono reindicizzati. Gli aggiornamenti incrementali funzionano meglio per rilevare contenuto, metadati e altri aggiornamenti.

Nota

Le ricerche per indicizzazione incrementali non supportano attualmente l'elaborazione degli aggiornamenti alle autorizzazioni.

Gli aggiornamenti incrementali sono molto più veloci degli aggiornamenti completi perché gli elementi non modificati non vengono elaborati. Tuttavia, se si sceglie di eseguire aggiornamenti incrementali, è comunque necessario eseguire periodicamente gli aggiornamenti completi per mantenere la sincronizzazione corretta dei dati tra l'origine contenuto e l'indice di ricerca.

Pianificazione della ricerca per indicizzazione

È possibile configurare ricerche per indicizzazione complete e incrementali in base alle opzioni di pianificazione avanzate presenti nella pagina Impostazioni aggiornamento. Alcuni connettori non supportano le ricerche per indicizzazione incrementali e l'opzione per configurare le ricerche per indicizzazione incrementali non sarà disponibile per tali connettori. Per altri, la ricerca per indicizzazione incrementale è una ricerca per indicizzazione facoltativa e abilitata per impostazione predefinita. Per impostazione predefinita, viene selezionata una pianificazione della ricerca per indicizzazione in base al tipo di connettore. Questa impostazione predefinita può essere modificata durante la creazione o la modifica della connessione dopo la pubblicazione di una connessione dal flusso "Modifica" di una connessione. È possibile scegliere tra questi campi:

• Ricorrenza: è possibile scegliere di eseguire le ricerche per indicizzazione ogni giorno, settimana, seconda settimana o 4a settimana.
• Giorno/i: questa opzione è abilitata quando si sceglie di eseguire ricerche per indicizzazione solo in giorni specifici della settimana.
• La casella di controllo Esegui una volta al giorno consente di scegliere l'ora di inizio della ricerca per indicizzazione in un giorno. Se non è selezionata, le ricerche per indicizzazione verranno ripetute in un giorno per impostazione predefinita. È possibile scegliere l'intervallo di ripetizione dall'elenco a discesa.
• Frequenza: selezionare questa opzione se si desidera ripetere le ricerche per indicizzazione in un giorno dopo determinati intervalli di tempo. La frequenza di ripetizione più piccola è di 15 minuti e la più grande è di 12 ore.
• Ora di inizio: selezionare l'ora di inizio della ricerca per indicizzazione.
• Reimpostazione: la pianificazione verrà reimpostata sulla pianificazione predefinita del connettore.

Ecco alcuni punti da notare durante la configurazione della pianificazione della ricerca per indicizzazione:

• Se si lascia uno dei campi vuoti o non selezionati, i connettori Graph sceglieranno il momento migliore per avviare una ricerca per indicizzazione. Ad esempio, se si sceglie una ricorrenza per indicizzazione come "Giorno" e non si seleziona l'ora di inizio, i connettori Graph sceglieranno l'ora in base all'ultima ricerca per indicizzazione per avviare la nuova ricerca per indicizzazione. Se non si vuole specificare un'ora di inizio della ricerca per indicizzazione, è consigliabile consentire al connettore di decidere quando avviare la ricerca per indicizzazione.
• Anche se viene indicata l'ora di inizio, l'inizio della ricerca per indicizzazione può ritardare di un'ora. Ciò può essere dovuto a motivi come il carico di rete e così via.
• Se la ricerca per indicizzazione precedente supera il tempo della ricerca per indicizzazione successiva, non si arresta la ricerca per indicizzazione in corso e si accoda la ricerca per indicizzazione successiva. Al termine della ricerca per indicizzazione in corso, viene eseguita la ricerca per indicizzazione in coda solo se è di un tipo diverso (completo/incrementale) rispetto alla ricerca per indicizzazione precedente. Ad esempio, se una ricerca per indicizzazione incrementale supera la ricerca per indicizzazione completa successiva, non si sospenderà la ricerca per indicizzazione incrementale e si accoderà la ricerca per indicizzazione completa. Dopo il completamento della ricerca per indicizzazione incrementale, poiché la ricerca per indicizzazione in coda è di tipo diverso (completa), verrà avviata immediatamente la ricerca per indicizzazione completa.

Ecco alcuni degli scenari seguenti:

• Eseguire la ricerca per indicizzazione incrementale ogni giorno ogni 15 minuti

Qui selezionando la casella di controllo "Esegui una volta al giorno" è possibile scegliere l'ora di inizio per eseguire la ricerca per indicizzazione incrementale una sola volta al giorno a partire dall'ora specificata. Tuttavia, la deselezione consentirà di scegliere la frequenza delle ripetizioni della ricerca per indicizzazione in un giorno. Se si vuole che i dati vengano aggiornati continuamente, è possibile scegliere di eseguire le ricerche per indicizzazione incrementali di frequente in un giorno. Tuttavia, se il numero di elementi nell'origine dati è elevato e le ricerche per indicizzazione tendono a essere più lunghe o se non sono necessari aggiornamenti frequenti per il contenuto, è possibile scegliere la ricerca per indicizzazione incrementale da eseguire una volta al giorno.

• Eseguire la ricerca per indicizzazione incrementale ogni settimana il mercoledì, il sabato e la domenica ripetendo ogni 15 minuti e a partire dalle 1:00

• Eseguire la ricerca per indicizzazione completa ogni giorno all'1:00

• Eseguire la ricerca per indicizzazione completa ogni settimana il venerdì alle 20:00

Passaggio 9: Esaminare la connessione

È possibile esaminare l'intera configurazione e modificare le impostazioni in base alle esigenze prima di completare la connessione. Se non è già stato fatto, leggere le informazioni specifiche del connettore per l'origine dati. Quando si è pronti per completare la connessione, selezionare Pubblica.

Implementazione a fasi

L'implementazione a fasi è una funzionalità che consente di introdurre gradualmente i connettori di Microsoft Graph a un gruppo selezionato di utenti nell'ambiente di produzione. Selezionare Pubblica per utenti limitati per distribuire il connettore a un gruppo di destinatari limitato. Per altre informazioni, vedere Implementazione temporanea per i connettori di Microsoft Graph.

Passaggio 10: Gestire i risultati della connessione

I risultati della connessione verranno inclusi nella verticale Tutto per impostazione predefinita dopo la pubblicazione. Se non si desidera che i risultati della connessione siano immediatamente disponibili in Tutti dopo la pubblicazione, è possibile rifiutare esplicitamente in questo passaggio.

Passaggio 11: Personalizzare la pagina dei risultati della ricerca

Dopo aver pubblicato la connessione, è possibile personalizzare la pagina dei risultati della ricerca con tipi di risultati e verticali. Per informazioni sulla personalizzazione dei risultati della ricerca, vedere come gestire i tipi di risultati e verticali.

Passaggio 12: Verificare se la configurazione della connessione ha funzionato

Passare all'elenco delle connessioni pubblicate nella scheda Connettori nell'interfaccia di amministrazione. Per informazioni su come eseguire aggiornamenti ed eliminazioni, vedere Monitorare le connessioni.

Risoluzione dei problemi

Leggere le informazioni specifiche del connettore per l'origine dati.

Nota

Attualmente, non tutti gli articoli specifici del connettore includono raccomandazioni per la risoluzione dei problemi.

Limitazioni

Per informazioni sulle limitazioni applicabili a tutte le origini dati, vedere l'articolo Panoramica dei connettori di Microsoft Graph .

Vedere le informazioni specifiche del connettore per l'origine dati per scoprire se si applicano altre limitazioni a quel particolare connettore di Microsoft Graph.