Connettore Microsoft 365 Copilot Dropbox (anteprima)

Con il connettore dropbox Microsoft 365 Copilot, l'organizzazione in M365 può indicizzare i file accessibili a chiunque in Dropbox, usando Microsoft Copilot e Ricerca.

Questo articolo è destinato agli amministratori di Microsoft 365 o a chiunque configura, esegue e monitora il connettore Dropbox Copilot.

Funzionalità

• Accedere ai file Dropbox usando la potenza della ricerca semantica
• Mantenere gli elenchi di controllo di accesso definiti dall'organizzazione
• Personalizzare la frequenza di ricerca per indicizzazione
• Creare flussi di lavoro usando questa connessione e plug-in da Microsoft Copilot Studio

Limitazioni

• Cartella, le risposte & commenti non sono indicizzabili

Prerequisiti

Prima di creare un connettore Dropbox Copilot, è necessario:

1. Configurare un utente amministratore del team

È stato creato un account Dropbox per le aziende e è stato configurato un utente amministratore del team.

2. Configurare un'app Dropbox

È stata configurata un'app Dropbox con un nome app univoco, l'accesso con ambito attivato e le autorizzazioni Dropbox complete. Vedere la documentazione di Dropbox sulla creazione di un'app.

3. Aggiungere URL diretti

Aggiungere i collegamenti seguenti agli URL di reindirizzamento archiviati nella sezione OAuth 2 della scheda delle impostazioni nella console dell'app Dropbox:

Per M365 Enterprise copiare e incollare: https://gcs.office.com/v1.0/admin/oauth/callback

Per M365 Government copiare e incollare: https://gcsgcc.office.com/v1.0/admin/oauth/callback

4. Aggiungere ambiti API

Passare alla scheda Autorizzazioni nella console dell'app Dropbox e aggiungere le autorizzazioni seguenti:

Singoli ambiti:

files.metadata.read

files.content.read

sharing.read

file_requests.read

Ambiti del team:

team_info.read

team_data.member

team_data.governance.write

team_data.governance.read

team_data.content.read

files.team_metadata.read

members.read

groups.read

events.read

5. Ottenere la chiave dell'app e il segreto dell'app

Passare alla scheda Impostazioni dal riquadro di spostamento a sinistra per ottenere la chiave app e il segreto dell'app da questa pagina.

Configurazione

1. Nome visualizzato

Scegliere un nome visualizzato che consenta agli utenti di riconoscere facilmente i file o gli elementi associati in una risposta Copilot.

2. Tipo di autenticazione

Immettere la chiave dell'app e il segreto dell'app ottenuti dalla console dell'app Dropbox.

3. Implementazione a un pubblico limitato

Distribuire questa connessione a una base di utenti limitata se si vuole convalidarla in Copilot e in altre aree di ricerca prima di espandere l'implementazione a un pubblico più ampio.

Per altre impostazioni, ad esempio autorizzazioni di accesso, regole di inclusione dati, schema, frequenza di ricerca per indicizzazione e così via, vengono impostate le impostazioni predefinite in base a ciò che funziona meglio con i dati in Dropbox. Le impostazioni dei valori predefiniti sono le seguenti.

Pagina	Impostazioni	Valori predefiniti
Utenti	Autorizzazioni di accesso	Tutti i file accessibili a chiunque in Dropbox sono visibili a tutti gli utenti di Microsoft 365 nel tenant, da Microsoft Search o Copilot.
Contenuto	Contenuto indice	Tutti i post e le pagine pubblicati sono selezionati per impostazione predefinita.
Contenuto	Gestisci proprietà	Per controllare le proprietà predefinite e il relativo schema.
Sincronizza	Ricerca per indicizzazione incrementale	Frequenza: ogni 4 ore
Sincronizza	Ricerca per indicizzazione completa	Frequenza: ogni giorno

Se si desidera modificare uno di questi valori, è necessario scegliere l'opzione Installazione personalizzata .

Installazione personalizzata

L'installazione personalizzata è destinata agli amministratori che vogliono modificare i valori predefiniti per le impostazioni. Dopo aver fatto clic sull'opzione "Installazione personalizzata", verranno visualizzate altre tre schede: Utenti, Contenuto e Sincronizzazione.

Utenti

Autorizzazioni di accesso

Il connettore Dropbox Copilot supporta i dati visibili solo agli utenti con accesso a questa origine dati (scelta consigliata) o a Tutti. Se si sceglie Tutti, i dati indicizzati vengono visualizzati nei risultati della ricerca per tutti gli utenti.

Se si sceglie Solo gli utenti con accesso a questa origine dati, è necessario scegliere ulteriormente se gli utenti con provisioning Microsoft Entra ID o non AAD.

Per identificare l'opzione adatta all'organizzazione:

1. Scegliere l'opzione Microsoft Entra ID se l'ID di posta elettronica degli utenti dropbox è uguale all'UPN (UserPrincipalName) degli utenti in Microsoft Entra ID.

2. Scegliere l'opzione non AAD se l'ID di posta elettronica degli utenti dropbox è diverso da UserPrincipalName (UPN) degli utenti in Microsoft Entra ID.

Importante

• Se si sceglie Microsoft Entra ID come tipo di origine identità, il connettore esegue il mapping degli ID di posta elettronica degli utenti ottenuti da Dropbox direttamente alla proprietà UPN da Microsoft Entra ID.
• Se si sceglie "non AAD" per il tipo di identità, vedere Eseguire il mapping delle identità non Azure AD per istruzioni sul mapping delle identità. È possibile usare questa opzione per fornire l'espressione regolare di mapping dall'ID di posta elettronica all'UPN.
• Aggiornamenti agli utenti o ai gruppi che controllano le autorizzazioni di accesso vengono sincronizzati solo in ricerche per indicizzazione complete. Le ricerche per indicizzazione incrementali non supportano attualmente l'elaborazione degli aggiornamenti alle autorizzazioni.

Contenuto

Gestisci proprietà

Qui è possibile aggiungere o rimuovere le proprietà disponibili dall'origine dati Dropbox. Assegnare uno schema alla proprietà (definire se una proprietà è ricercabile, ricercabile, recuperabile o perfezionabile), modificare l'etichetta semantica e aggiungere un alias alla proprietà . Le proprietà selezionate per impostazione predefinita sono:

Proprietà Source	Etichetta	Descrizione	Schema
CreatedBy	Creato da	Indirizzo di posta elettronica dell'autore	Query, Recupero, Ricerca
FileExtension	Estensione del file	Estensione di file.	Query, Refine, Retrieve
IconUrl	IconUrl	URL dell'icona.	Recuperare
LastModifiedBy	Data e ora dell'ultima modifica	Indirizzo di posta elettronica dell'utente che ha modificato il file per l'ultima volta.	Query, Recupero, Ricerca
LastModifiedTime	lastModifiedDateTime	Ultimo utente a modificare il file. L'utente che ha eseguito l'ultima modificaQuesto deve essere un utente di accesso.	Query, Refine, Retrieve
Nome	Nome del file	Nome del file	Query, Recupero, Ricerca
PreviewUrl	URL	URL per la visualizzazione di un'anteprima Web del file condiviso.	Recuperare
Dimensioni		Dimensioni del file in byte.

Sincronizza

È possibile configurare ricerche per indicizzazione complete e incrementali in base alle opzioni di pianificazione disponibili qui. Per impostazione predefinita, la ricerca per indicizzazione incrementale viene impostata per ogni 4 ore e la ricerca per indicizzazione completa viene impostata per ogni giorno. Se necessario, è possibile modificare queste pianificazioni in base alle esigenze di aggiornamento dei dati.

Risoluzione dei problemi

1. Gli ambiti di autorizzazione necessari sono mancanti. Verificare che gli ambiti necessari siano selezionati nell'app Dropbox.

Mancanza degli ambiti di autorizzazione necessari, assicurarsi di aver selezionato tutti gli ambiti nella console dell'app Dropbox:

Singoli ambiti:

files.metadata.read

files.content.read

sharing.read

file_requests.read

Ambiti del team:

team_info.read

team_data.member

team_data.governance.write

team_data.governance.read

team_data.content.read

files.team_metadata.read

members.read

groups.read

events.read

2. Flusso OAuth 2.0 non riuscito. Verificare le informazioni sulle credenziali e assicurarsi che l'app Dropbox sia configurata con le impostazioni corrette.

Errore di autenticazione comune. Indietro alla console dell'app Dropbox e verificare che OAuth2 nella scheda delle impostazioni sia configurato correttamente.

3. Flusso OAuth 2.0 non riuscito. Verificare che l'utente dropbox associato a questo token di accesso al team contenga il ruolo di amministratore del team ed sia un utente attivo.

Errore di autenticazione comune. Indietro alla console dell'app Dropbox e verificare se l'autore ha un ruolo di amministratore e lo stato dell'account è attivo.

4. Le credenziali di sicurezza sono scadute per questa sessione. Indietro e accedere di nuovo con la chiave dell'app e il segreto dell'app.

Le informazioni sulle credenziali sono scadute. Aggiornare la console dell'app Dropbox e copiare la chiave app e il segreto dell'app più recenti dalla scheda delle impostazioni per l'autenticazione.

5. Sono stati rilevati credenziali non valide. Controllare le informazioni sulle credenziali e controllare gli ambiti di autorizzazione dell'app Dropbox.

Errore comune delle credenziali. Indietro alla console dell'app Dropbox e verificare se gli ambiti nella scheda autorizzazioni sono configurati correttamente.