Configurare i connettori di Microsoft Graph nel interfaccia di amministrazione di Microsoft 365
Questo articolo descrive i passaggi per configurare un connettore Microsoft Graph nel interfaccia di amministrazione di Microsoft 365. Il processo di configurazione è semplificato, con input minimi che semplificano la creazione della connessione. Tuttavia, è possibile scegliere una configurazione personalizzata per ottimizzare impostazioni specifiche.
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.
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.
Prerequisiti
Prima di iniziare, verificare quanto segue:
- Amministrazione Access: è necessario disporre di uno dei ruoli seguenti nell'interfaccia di amministrazione di M365 per configurare un connettore Graph- Amministratore globale, Amministratore di ricerca o Amministratore Copilot.
- Credenziali origine dati: Raccogliere le credenziali e le autorizzazioni necessarie per l'origine dati da connettere.
- Account del servizio (se applicabile): Se l'origine dati richiede un account del servizio, assicurarsi che disponga dei ruoli o delle autorizzazioni necessari.
Passaggio 1: Aggiungere un connettore Microsoft Graph
Completare la procedura seguente per configurare uno dei connettori di Microsoft Graph (o fare clic qui per accedere direttamente al Catalogo connettori):
Aprire il Amministrazione Microsoft 365 Center:
- Accedere all'interfaccia di amministrazione di Microsoft 365.
Passare a Impostazioni:
- Nel riquadro di spostamento a sinistra selezionare Impostazioni.
- Fare clic su Cerca & intelligence.
Aggiungere una nuova origine dati:
- Passare alla scheda Origini dati.
- Fare clic su +Aggiungi.
- Nell'elenco dei connettori disponibili selezionare l'origine dati da connettere, ad esempio ServiceNow Knowledge, Salesforce e così via.
Passaggio 2: Immettere i dettagli di connessione di base
Nome visualizzato:
- Per consentire agli utenti di riconoscere l'origine in Copilot e i risultati della ricerca, immettere un nome per identificare il connettore.
- Viene fornito un nome predefinito, ma è possibile personalizzarlo in base alle esigenze dell'organizzazione.
URL origine dati:
- Specificare l'URL dell'origine dati. Ad esempio, se ci si connette a ServiceNow, l'URL potrebbe essere simile
https://your-organization-name.service-now.coma .
- Specificare l'URL dell'origine dati. Ad esempio, se ci si connette a ServiceNow, l'URL potrebbe essere simile
Tipo di autenticazione:
- Scegliere un metodo di autenticazione per accedere all'origine dati.
Implementazione a gruppi di destinatari limitati
- Inizialmente, è possibile distribuire il connettore a un subset di utenti per la convalida in Copilot e in altre aree di ricerca. Questa funzionalità consente di testare l'integrazione prima di un'implementazione più ampia.
Nota
Per la maggior parte dei connettori, le impostazioni predefinite sono ottimizzate per l'origine dati. Queste impostazioni includono autorizzazioni di accesso, schema e frequenza di sincronizzazione. Se si desidera modificare una di queste impostazioni, è necessario scegliere l'opzione "Installazione personalizzata".
Passaggio 3: Creare la connessione
- Fare clic su Crea per configurare la connessione. Il connettore inizia a indicizzare il contenuto dall'origine dati usando le impostazioni predefinite.
Dopo aver creato la connessione, è possibile aggiungere una descrizione per la connessione nella schermata di esito positivo. Per aiutare Copilot a migliorare i risultati della connessione per gli utenti, 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.
Installazione personalizzata (facoltativo)
Gli amministratori che desiderano un maggiore controllo sulla configurazione possono scegliere l'opzione Installazione personalizzata . Questa opzione consente di accedere a tre schede per le impostazioni dettagliate: Utenti, Contenuto e Sincronizzazione.
Utenti
Autorizzazioni di accesso:
- Scegliere se i dati indicizzati sono visibili a:
- Tutti gli utenti dell'organizzazione.
- Solo gli utenti con accesso al contenuto nell'origine dati.
- Scegliere se i dati indicizzati sono visibili a:
Identità mappa:
- Per impostazione predefinita, viene eseguito il mapping degli utenti controllando se il messaggio di posta elettronica nell'origine dati corrisponde a o
UserPrincipalNameMailin Microsoft Entra ID. - Se questo valore predefinito non funziona per l'organizzazione, specificare una formula di mapping personalizzata.
- Per impostazione predefinita, viene eseguito il mapping degli utenti controllando se il messaggio di posta elettronica nell'origine dati corrisponde a o
Contenuto
Gestisci proprietà:
- Configurare le proprietà dall'origine dati, ad esempio rendendole ricercabili, ricercabili o perfezionabili.
- Assegnare etichette semantiche e alias per migliorare la rilevanza della ricerca.
Per altre informazioni sulla gestione delle proprietà, vedere di seguito.
Sincronizza
Intervalli di aggiornamento:
Configurare la frequenza di sincronizzazione dei dati tra l'origine dati e l'indice del connettore Graph.
- Ricerca per indicizzazione completa: Sincronizza tutti i dati a intervalli pianificati.
- Ricerca per indicizzazione incrementale: Aggiornamenti solo i dati modificati o nuovi.
Modificare le impostazioni di sincronizzazione predefinite in base alle esigenze dell'organizzazione.
Per altre informazioni sulle impostazioni di sincronizzazione, vedere di seguito.
Altre risorse
Linee guida per 'Gestisci proprietà'
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". 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.
Etichette semantica per le proprietà di origine
È possibile assegnare etichette semantica alle proprietà di origine. Le etichette sono tag noti forniti da Microsoft che forniscono significato semantico. Consentono a Microsoft di integrare i dati del connettore in esperienze di Microsoft 365, ad esempio Copilot, 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à.
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 .
Linee guida per le impostazioni di sincronizzazione
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 (Controllo di accesso Elenchi) 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 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 si ripeteranno 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: questa opzione reimposta la pianificazione 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 scelgono 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. Questo ritardo 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 sospende la ricerca per indicizzazione incrementale e si accoda la ricerca per indicizzazione completa. Dopo il completamento della ricerca per indicizzazione incrementale, poiché la ricerca per indicizzazione in coda è di tipo diverso (completa), si avvia 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
