Connettore Miro Microsoft Graph (anteprima)

Il connettore Miro Microsoft Graph consente all'organizzazione di indicizzare le schede da Miro. Dopo aver configurato il connettore, gli utenti possono cercare queste schede da Miro in Microsoft 365 Copilot e da qualsiasi client di Microsoft Search.

Questo articolo è destinato agli amministratori di Microsoft 365 o a tutti coloro che configurano, eseguono e monitorano un connettore Miro Microsoft Graph.

Nota

Il connettore Miro è in anteprima pubblica. Per ottenere l'accesso al connettore, abilitare l'anello Rilascio mirato per l'account Amministrazione.

Funzionalità

• Accedere ai file in Copilot usando la potenza della ricerca semantica.
• Personalizzare la frequenza di ricerca per indicizzazione.
• Creare flussi di lavoro usando questa connessione e le azioni da Microsoft Copilot Studio.

Limitazioni

• Non indicizzare gli allegati.
• Non indicizzare i commenti e le risposte.

Prerequisiti

1. Creare un team di sviluppatori per l'account Miro

Creare o usare un account Miro esistente per accedere a Miro e fare clic sul collegamento per creare un team di sviluppatori per l'account Miro attivo. Se l'organizzazione fa parte di un piano Enterprise, passare a Enterprise Developer Teams.If your organization is on an Enterprise plan, go to Enterprise Developer teams. Per altre informazioni, vedere Creare un team di sviluppo.

2. Creare l'app in Miro

Accedere a Miro e creare una nuova app nelle app.

3. Aggiungere autorizzazioni all'app

Aggiungere il boards:read Read boards you have access to piano nell'app creata nella configurazione dell'app

4. Installare l'app e registrare le credenziali

Fare clic su Installa app e ottenere il token OAuth e registrare e Client IDClient secret dalle credenziali dell'app.

Per iniziare

1. Nome visualizzato

Un nome visualizzato viene usato per identificare ogni citazione in Copilot per consentire agli utenti di riconoscere facilmente il file o l'elemento associato. Il nome visualizzato indica anche il contenuto attendibile e viene usato come filtro origine contenuto. Per questo campo viene specificato un valore predefinito; è possibile personalizzarlo in base a un nome riconosciuto agli utenti dell'organizzazione.

2. ID team

Un ID team Miro è un identificatore per un team specifico all'interno della piattaforma Miro. Per trovare l'ID team, accedere a Miro in un browser, passare alle impostazioni del team dal dashboard e copiare l'ID.

Nota

È possibile associare un solo ID team nella connessione. Se nell'area di lavoro Miro sono presenti più ID del team, creare una connessione separata.

3. Tipo di autenticazione

Miro OAuth Immettere l'ID client e il segreto client ottenuti dall'app Miro. Per altre informazioni, vedere Introduzione a OAuth 2.0 e Miro.

4. Distribuire 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 informazioni, vedere Implementazione temporanea per i connettori di Microsoft Graph.

A questo punto è possibile creare la connessione per Miro. Scegliere Crea per pubblicare la connessione e le schede di indice dall'account Miro.

Per altre impostazioni, ad esempio autorizzazioni di accesso, schema e frequenza di ricerca per indicizzazione, i valori predefiniti vengono impostati in base a ciò che funziona meglio con i dati Miro.

Utenti	Descrizione
Autorizzazioni di accesso	Solo gli utenti con accesso al contenuto nell'origine dati.
Esegui il mapping delle identità	Identità dell'origine dati mappate tramite ID Microsoft Entra.

Contenuto	Descrizione
Gestire le proprietà	Per controllare le proprietà predefinite e il relativo schema.

Sincronizza	Descrizione
Ricerca per indicizzazione completa	Frequenza: ogni giorno

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

Configurazione personalizzata

L'installazione personalizzata è destinata agli amministratori che vogliono modificare i valori predefiniti per qualsiasi impostazione. Quando si sceglie Installazione personalizzata, vengono visualizzate tre schede: Utenti, Contenuto e Sincronizzazione.

Utenti

Autorizzazioni di accesso

Il connettore Miro Microsoft Graph supporta le autorizzazioni di ricerca visibili a tutti o solo agli utenti con accesso a questa origine dati. 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, i dati indicizzati vengono visualizzati nei risultati della ricerca per gli utenti che hanno accesso a tale origine.

Mapping delle identità

Il metodo predefinito per eseguire il mapping delle identità dell'origine dati con Microsoft Entra ID consiste nel verificare che l'ID di posta elettronica degli utenti Miro corrisponda al nome dell'entità utente (UPN) o alla posta elettronica degli utenti in Microsoft Entra. Se il mapping predefinito non funziona per l'organizzazione, è possibile fornire una formula di mapping personalizzata. Per altre informazioni, vedere Eseguire il mapping delle identità non Azure AD.

Per identificare l'opzione migliore per l'organizzazione:

• Scegliere l'opzione Microsoft Entra ID se l'ID di posta elettronica degli utenti Miro è uguale all'UPN o alla posta elettronica degli utenti in Microsoft Entra ID.
• Scegliere l'opzione Non Microsoft Entra ID se l'ID di posta elettronica degli utenti di Miro è diverso dall'UPN e dalla posta elettronica degli utenti in Microsoft Entra ID.

Contenuto

Gestire le proprietà

È possibile aggiungere o rimuovere proprietà disponibili da Miro, assegnare uno schema alla proprietà (definire se una proprietà è ricercabile, ricercabile, recuperabile o perfezionabile), modificare l'etichetta semantica e aggiungere un alias alla proprietà. Nella tabella seguente sono elencate le proprietà selezionate per impostazione predefinita.

Proprietà source	Etichetta	Descrizione	Schema
Corpo	ND	ND	Ricerca
CreatedAt	Data e ora di creazione	Data e ora di creazione dell'elemento nell'origine dati	Query, Retrieve
CreatedBy	Creato da	L'utente che ha creato l'elemento	Query, Recupero, Ricerca
Descrizione	ND	ND	Query, Retrieve
Id	ND	ND	Query, Retrieve
ModifiedAt	Data e ora dell'ultima modifica	Data e ora dell'ultima modifica dell'elemento nell'origine dati.	Query, Retrieve
ModifiedBy	Autore ultima modifica	L'utente che ha apportato l'ultima modifica	Query, Recupero, Ricerca
Nome	Titolo	Titolo dell'elemento da visualizzare in Copilot e in altre esperienze di ricerca	Query, Recupero, Ricerca
Team	ND	ND	Query, Retrieve
ViewLink	URL	URL di destinazione dell'elemento nell'origine dati	Query, Retrieve

Anteprima dei dati

Usare il pulsante dei risultati dell'anteprima per verificare i valori di esempio delle proprietà e del filtro di query selezionati.

Sincronizza

L'intervallo di aggiornamento determina la frequenza con cui i dati vengono sincronizzati tra l'origine dati e l'indice del connettore Miro Microsoft Graph. Sono supportati solo gli intervalli di aggiornamento completo della ricerca per indicizzazione. Per altre informazioni, vedere Impostazioni di aggiornamento.

È possibile modificare i valori predefiniti dell'intervallo di aggiornamento.

Risoluzione dei problemi

Di seguito sono riportati gli errori comuni e come risolverli.

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

Non si dispone degli ambiti di autorizzazione necessari. Assicurarsi di aver selezionato boards:read Read boards you have access to nel campo delle autorizzazioni della scheda Configurazione app.

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

Si tratta di un errore di autenticazione comune. Indietro all'app Miro e verificare che OAuth2 nella scheda delle impostazioni sia configurato correttamente.

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

Si tratta di un errore di autenticazione comune. Indietro alla console dell'app Miro e verificare che l'autore abbia un ruolo di amministratore e che lo stato dell'account sia attivo.

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 l'app Miro e copiare l'ID client e il segreto client più recenti dalla scheda delle impostazioni per l'autenticazione.

Credenziali non valide rilevate. Controllare le informazioni sulle credenziali e controllare gli ambiti di autorizzazione dell'app Miro.

Si tratta di un errore comune delle credenziali. Indietro all'app Miro e verificare che gli ambiti nella scheda delle autorizzazioni siano configurati correttamente.

Passaggi successivi

Dopo aver pubblicato la connessione, è possibile esaminare lo stato nella scheda Origini datinell'interfaccia di amministrazione. Per altre informazioni, vedere Gestire il connettore.

Per assistenza e supporto tecnico, vedere Supporto di Microsoft Graph.