Connettore Microsoft 365 Copilot Confluence Cloud

Il connettore Microsoft 365 Copilot di Confluence Cloud consente all'organizzazione di indicizzare il contenuto di Confluence. Dopo aver configurato i dati del connettore e dell'indice dal sito di Confluence, gli utenti finali possono cercare il contenuto in Microsoft Search e Microsoft 365 Copilot.

Questo articolo è destinato agli amministratori di Microsoft 365 responsabili della configurazione, dell'esecuzione e del monitoraggio del connettore Confluence Cloud Copilot. Integra le istruzioni generali fornite nella configurazione dei connettori Microsoft Copilot nel interfaccia di amministrazione di Microsoft 365.

Funzionalità

• Gli utenti possono porre domande in linguaggio naturale sul contenuto wiki in Copilot, ad esempio riepilogare il documento di architettura o ottenere l'accesso a un portale.
• Gli utenti possono eseguire query in linguaggio naturale per ottenere risposte accurate.

Prerequisiti

• È necessario essere l'amministratore per il tenant microsoft 365 dell'organizzazione e l'amministratore per il sito Confluence dell'organizzazione.
• Assicurarsi di disporre delle credenziali di autenticazione con l'accesso corretto.

Importante

• Nel gennaio 2024 Atlassian ha deprecato un set di API cloud confluence (versione 1) e rilasciato nuove API (versione 2). Per altre informazioni, vedere Aggiornamenti del log delle modifiche e aggiornamenti generali. Alcune di queste API v1 deprecate vengono usate dal connettore solo per le connessioni OAuth . Di conseguenza, dopo questa modifica, le connessioni confluence esistenti potrebbero smettere di funzionare.
• Nel dicembre 2023 è stato rilasciato un nuovo set di API v2 per tutti i clienti. Dopo il rilascio, le connessioni esistenti dovevano essere riautenticate. Le nuove API v2 richiedono anche altri ambiti (rispetto alle API v1 precedenti), che devono essere forniti durante la nuova autenticazione. Nuovo set di ambiti necessari (elenco completo): read:group:confluence, , read:content-details:confluenceread:user:confluence, Read:space:confluence, Read:permission:confluence, read:audit-log:confluenceread:content.metadata:confluence e read:page:confluence.
• A partire da luglio 2025, Confluence Cloud Connector supporta l'indicizzazione dei commenti e dell'attchement nelle pagine. Per sfruttare questa nuova funzionalità, le connessioni esistenti devono essere riautenticate e altri due ambiti ( read:comment:confluence, read:attachment:confluence) devono essere aggiunti all'app di integation OAuth 2.

Per iniziare

1. Nome visualizzato

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

2. URL del cloud di confluenza

Per connettersi al sito di Confluence, usare l'URL del sito. Un URL del sito cloud di Confluence è in genere simile a https://< organization_name.atlassian.net/>.

3. Tipo di autenticazione

Per autenticare e sincronizzare il contenuto da Confluence On-prem, scegliere uno dei due metodi supportati:

Consiglio

Assicurarsi che l'account del servizio disponga dell'accesso di visualizzazione al contenuto di Confluence da indicizzare.

a. Autenticazione di base
Per eseguire l'autenticazione usando l'autenticazione di base, immettere il nome utente (in genere il messaggio di posta elettronica) e il token API. Per informazioni sulla generazione di un token API, vedere la guida di Atlassian.

b. OAuth 2.0 (scelta consigliata)
Registrare un'app in Confluence Cloud in modo che l'app Microsoft Search e Microsoft 365 Copilot possano accedere all'istanza. Per altre informazioni, vedere la documentazione del supporto di Atlassian su come abilitare OAuth 2.0.

La procedura seguente fornisce indicazioni su come registrare l'app:

1. Accedere alla console di atlassian developer con l'account amministratore di Atlassian Confluence.

2. Fare clic su Crea e selezionare OAuth 2.0 integration.

3. Specificare un nome appropriato per l'applicazione e creare la nuova app.

4. Passare a Permissions dal riquadro di spostamento a sinistra. Fare clic su Aggiungi per Confluence API. Dopo l'aggiunta, fare clic su Configura e Modifica ambiti e selezionare gli ambiti seguenti.

   Nome ambito	Codice	Descrizione
   Visualizzare i dettagli del contenuto	read:content-details:confluence	Eseguire la ricerca per indicizzazione del contenuto soddisfacendo i criteri.
   Visualizzare i gruppi	read:group:confluence	Per accedere alle autorizzazioni di gruppo del contenuto.
   Visualizzare i dettagli utente	read:user:confluence	Per accedere ai dettagli dei singoli utenti per supportare le autorizzazioni.
   Visualizzare i record di controllo	read:audit-log:confluence	Per accedere ai record di controllo per gli eventi di Confluence per supportare le autorizzazioni.
   Visualizzare le pagine	read:page:confluence	Per accedere ai dettagli del contenuto della pagina per supportare le autorizzazioni.
   Visualizzare gli spazi	read:space:confluence	Per accedere ai dettagli dello spazio per supportare le autorizzazioni.
   Visualizzare i riepiloghi del contenuto	read:content.metadata:confluence	Per accedere alle informazioni sul contenuto per supportare le autorizzazioni.
   Visualizzare le restrizioni del contenuto e le autorizzazioni per lo spazio	read:permission:confluence	Per accedere alle restrizioni del contenuto e ai dettagli delle autorizzazioni di spazio per supportare le autorizzazioni.
   Visualizzare i commenti	read:comment:confluence	Visualizzare i commenti nelle pagine o nei post di blog.
   Visualizzare e scaricare allegati di contenuto	read:attachment:confluence	Visualizzare e scaricare gli allegati di una pagina o di un post di blog a cui si ha accesso.

5. Fare clic su Salva.

6. Passare a Authorization dal riquadro di spostamento a sinistra. Aggiungere l'URL di callback, per Microsoft 365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback, per Microsoft 365 Per enti pubblici e https://gcsgcc.office.com/v1.0/admin/oauth/callback salvare le modifiche.

7. Passare a Impostazioni dal riquadro di spostamento a sinistra. È possibile ottenere l'ID client e il segreto da questa pagina.

Completare il passaggio delle impostazioni di connessione usando l'ID client e il segreto.

6. Implementazione a un pubblico limitato

Distribuire questa connessione in 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 sull'implementazione limitata, fare clic qui.

A questo punto, si è pronti per creare la connessione per Confluence Knowledge. È possibile fare clic sul pulsante "Crea" e il connettore Microsoft Graph di Confluence Cloud avvia l'indicizzazione dall'account Confluence.

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 di Confluence. I valori predefiniti sono i seguenti:

Utenti
Autorizzazioni di accesso	Solo gli utenti con accesso al contenuto nell'origine dati.
Identità mappa	Identità dell'origine dati mappate tramite ID Microsoft Entra.

Contenuto
Includi/Escludi spazio	Tutto
Gestisci proprietà	Per controllare le proprietà predefinite e il relativo schema, fare clic qui

Sincronizza
Ricerca per indicizzazione incrementale	Frequenza: ogni 15 minuti
Ricerca per indicizzazione completa	Frequenza: ogni giorno

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

Configurazione personalizzata

Nella configurazione personalizzata è possibile modificare uno qualsiasi dei valori predefiniti per utenti, contenuto e sincronizzazione.

Utenti

Autorizzazioni di accesso

Il connettore Cloud Copilot confluence 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 le persone con accesso a questa origine dati, i dati indicizzati vengono visualizzati nei risultati della ricerca per gli utenti che hanno accesso a questa origine dati. In Confluence Cloud le autorizzazioni di sicurezza per utenti e gruppi vengono definite usando le autorizzazioni di spazio e le restrizioni delle pagine. Le restrizioni a livello di pagina, se presenti, hanno la precedenza sulle autorizzazioni di spazio.

Se non sono presenti restrizioni di pagina, il connettore verifica la presenza di autorizzazioni a livello di spazio -

• Nel caso in cui lo spazio disponga dell'accesso "utenti anonimi" abilitato, il contenuto è visibile a tutti gli utenti all'interno del tenant.
• Nel caso in cui l'accesso anonimo non sia abilitato, le autorizzazioni a livello di spazio vengono rispettate.
• Nel caso in cui le autorizzazioni a livello di spazio non siano definite, il contenuto non è visibile ad alcun utente nel tenant.

Importante

Le autorizzazioni vengono gestite solo a livello di spazio e pagina e le autorizzazioni della pagina padre non vengono prese in considerazione.

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

Per identificare l'opzione adatta all'organizzazione:

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

Nota

• 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 Confluence 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

Includere o escludere i dati da indicizzare

Con una stringa CQL (Confluence Query Language), è possibile specificare le condizioni per la sincronizzazione delle pagine. È come una clausola Where in un'istruzione SQL Select . Ad esempio, è possibile scegliere di indicizzare solo le pagine modificate negli ultimi due anni. Per informazioni sulla creazione di una stringa di query personalizzata, vedere Ricerca avanzata con CQL. Il connettore indicizza tutti i blog e le pagine per impostazione predefinita.

Consiglio

È possibile usare il filtro CQL per indicizzare il contenuto modificato dopo un determinato periodo di tempo usando lastModified >= "12/2018/31"

Usare il pulsante dei risultati dell'anteprima per verificare i valori di esempio delle proprietà selezionate e della stringa CQL.

Gestire le proprietà

Per aggiungere o rimuovere proprietà disponibili da Aha!, 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à seguenti vengono indicizzate per impostazione predefinita.

Proprietà predefinita	Etichetta	Descrizione
Autori	authors	Nome delle persone che hanno partecipato o collaborato all'elemento nell'origine dati.
CreatedByName	createdBy	Nome della persona che ha modificato l'elemento più di recente nell'origine dati.
CreatedOn	createdDateTime	Data e ora di creazione dell'elemento nell'origine dati.
IconUrl	iconUrl	URL dell'icona associato dell'elemento.
Titolo	title	Titolo dell'elemento che si vuole visualizzare nella ricerca e in altre esperienze.
UpdatedByName	lastModifiedBy	Nome della persona che ha modificato l'elemento più di recente nell'origine dati.
UpdatedOn	lastModifiedDateTime	Data e ora dell'ultima modifica dell'elemento nell'origine dati.
Url	url	URL di destinazione dell'elemento nell'origine dati.

Anteprima dei dati

Usare il pulsante dei risultati dell'anteprima per verificare le proprietà e i filtri selezionati.

Sincronizza

L'intervallo di aggiornamento determina la frequenza con cui i dati vengono sincronizzati tra l'origine dati e l'indice del connettore Confluence Cloud Copilot. Esistono due tipi di intervalli di aggiornamento: ricerca per indicizzazione completa e ricerca per indicizzazione incrementale. Per altri dettagli, fare clic qui. È possibile modificare i valori predefiniti dell'intervallo di aggiornamento da qui, se si vuole.

Esaminare e testare la connessione

• Per i test, è possibile scegliere pubblica in gruppi di destinatari limitati
• Cercare e convalidare il contenuto indicizzato e le autorizzazioni usando il browser indice
• È possibile trovare risposte alle domande comuni nella sezione Domande frequenti

Per Microsoft Search, se è necessario personalizzare la pagina dei risultati della ricerca. Per informazioni sulla personalizzazione dei risultati della ricerca, vedere Personalizzare la pagina dei risultati della ricerca.

In caso di problemi o se si desidera fornire commenti e suggerimenti, contattare Microsoft Graph | Supporto.