connettore Microsoft 365 Copilot Wiki Azure DevOps

Il connettore Microsoft 365 Copilot wiki Azure DevOps consente all'organizzazione di indicizzare i wiki nell'istanza del servizio DevOps Azure. Dopo aver configurato il connettore, gli utenti finali possono cercare wiki di progetto e wiki di codice da Azure DevOps in Microsoft Search e Microsoft 365 Copilot.

Questo articolo è destinato agli amministratori di Microsoft 365 o a tutti gli utenti che configurano, eseguono e monitorano un connettore Azure DevOps Wiki Copilot.

Funzionalità

• Indicizzare wiki da Azure DevOps
• Abilitare gli utenti finali per porre domande relative a wiki di progetto e wiki di codice.
• Usare la ricerca semantica in Copilot per consentire agli utenti di trovare contenuti pertinenti in base a parole chiave, preferenze personali e connessioni di social networking.

Limitazioni

• Il connettore indicizza solo un'organizzazione ADO per ogni connessione.

Filtri dati personalizzati

Il connettore Azure DevOps Wiki include i filtri dati personalizzati seguenti per Ricerca Copilot:

• Percorso area
• Assegnata a

Prerequisiti

• È necessario essere l'amministratore della ricerca per il tenant di Microsoft 365 dell'organizzazione.

• Per consentire al connettore di connettersi all'organizzazione Azure DevOps, è necessario abilitare l'accesso alle applicazioni di terze parti tramite OAuth. Per altre informazioni, vedere Gestire i criteri di sicurezza per altre informazioni.

  

• Account del servizio: per connettersi a Azure DevOps e consentire al connettore Azure DevOps Wiki Copilot di aggiornare regolarmente i wiki, è necessario un account del servizio con le autorizzazioni seguenti concesse. L'account del servizio è l'entità servizio pubblicata da Microsoft (per l'autenticazione federata delle credenziali) o l'account amministratore di Microsoft 365 connesso (per Microsoft Entra ID autenticazione OAuth), a seconda del metodo di autenticazione selezionato.

  Nome autorizzazione	Tipo di autorizzazione	Obbligatorio per
  Visualizzare informazioni a livello di progetto	Autorizzazione progetto	Ricerca per indicizzazione Azure Wiki devOps. Questa autorizzazione è obbligatoria per i progetti che devono essere indicizzati.

Introduzione

Scegliere il nome visualizzato

Un nome visualizzato viene usato per identificare ogni citazione 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.

Fornire il tipo di autenticazione

Per autenticare e sincronizzare i wiki da Azure DevOps, scegliere uno dei due metodi supportati:

• Credenziali federate (scelta consigliata): usa un'entità servizio Microsoft Entra pubblicata da Microsoft come account del servizio di ricerca per indicizzazione. Le autorizzazioni concesse a questa entità servizio in Azure DevOps determinano ciò che il connettore può indicizzare.
• Microsoft Entra ID OAuth: usa OAuth delegato in cui l'account amministratore di Microsoft 365 connesso funge da account del servizio di ricerca per indicizzazione. In questo caso, le autorizzazioni Azure DevOps assegnate a tale account amministratore determinano l'indice che il connettore può indicizzare.

Credenziali federate (scelta consigliata)

Federated Credential usa un'applicazione aziendale pubblicata da Microsoft come account del servizio di ricerca per indicizzazione. È necessario concedere a questa entità servizio le autorizzazioni necessarie in Azure DevOps.

Verificare che sia stato effettuato il provisioning dell'app dell'entità servizio

1. Vai alla Interfaccia di amministrazione di Microsoft Entra.
2. Cercare Graph Connector Federated Credential App o usare l'ID app: 933838e2-bec1-440f-a634-9363c82e5b6d.
3. Se non viene effettuato il provisioning dell'app, aprire la pagina Connettori Copilot nel interfaccia di amministrazione di Microsoft 365. Il provisioning può richiedere diverse ore.

Concedere all'app Microsoft Entra l'accesso ai progetti DevOps Azure

Concedere all'entità servizio l'accesso ai progetti Azure DevOps da indicizzare.

1. Passare a Azure DevOps e selezionare l'organizzazione.
2. Selezionare Impostazioni organizzazione.
3. Nel riquadro sinistro, in Generale, selezionare Utenti.
4. Selezionare Aggiungi utenti.
5. In Utenti o entità servizio immettere l'ID app: 933838e2-bec1-440f-a634-9363c82e5b6d.
6. Assegnare il livello di accesso Basic , selezionare i progetti da indicizzare e aggiungere l'app al gruppo Lettori di progetto (o a un gruppo equivalente). Deselezionare l'opzione per inviare un invito tramite posta elettronica.

Configurare l'autenticazione delle credenziali federate

Selezionare Credenziali federate come tipo di autenticazione e eseguire l'autenticazione quando richiesto.

Microsoft Entra ID OAuth

Assicurarsi che l'organizzazione ADO sia connessa a Microsoft Entra

Il connettore Azure DevOps Wiki Copilot indicizza solo il contenuto di un'organizzazione ADO connessa con Microsoft Entra del tenant. Per assicurarsi che l'organizzazione ADO sia connessa con Microsoft Entra account, seguire questa procedura.

1. Passare a Azure DevOps e selezionare l'organizzazione necessaria.
2. Selezionare Organization settings.
3. Nel riquadro di spostamento a sinistra selezionare Microsoft Entra sotto l'intestazione "Generale".
4. Assicurarsi che l'organizzazione sia connessa all'account Microsoft Entra del tenant.

Creare una registrazione dell'app Microsoft Entra ID

1. Passare alla portale di Azure e accedere con le credenziali di amministratore per il tenant.
2. Passare a Microsoft Entra ID ->Manage ->Registrazioni app dal riquadro di spostamento e selezionare Nuova registrazione.
3. Specificare un nome per l'app e selezionare Registra.
4. Prendere nota dell'ID applicazione (client). Questo ID viene usato per concedere all'app Microsoft Entra l'accesso ai progetti nell'organizzazione ADO.
5. Aprire autorizzazioni API dal riquadro di spostamento e selezionare Aggiungi un'autorizzazione.
6. Selezionare Azure DevOps e quindi Autorizzazioni delegate.
7. Cercare le autorizzazioni seguenti e selezionare Aggiungi autorizzazioni.
   a. Identità (lettura)
   b. Codice (lettura)
   c. Diritti (lettura)
   d. Progetto e team (lettura)
   e. Grafico (lettura)
   f. MemberEntitlement Management (lettura)
   g. Wiki (lettura)
8. Selezionare Concedi consenso amministratore per [TenantName] e confermare selezionando Sì.
9. Verificare che le autorizzazioni siano nello stato "Concesso".
10. Aprire Autenticazione dal riquadro di spostamento. Selezionare Add a platform e scegliere Web. Aggiungere uno degli URI seguenti in "URI di reindirizzamento":
    • Per M365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback
    • Per M365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback
11. In Concessione implicita e flussi ibridi controllare l'opzione e ID tokens (used for implicit and hybrid flows) fare clic su Configura.
12. Nel riquadro di spostamento selezionare Certificati e segreti in Gestisci.
13. Selezionare Nuovo segreto client e selezionare un periodo di scadenza per il segreto. Copiare il segreto generato (Valore) e salvarlo perché non viene visualizzato di nuovo.
14. Usare questo segreto client e l'ID applicazione per configurare il connettore.

Concedere all'app Microsoft Entra l'accesso ai progetti nell'organizzazione ADO

È necessario fornire all'app Microsoft Entra l'accesso necessario ai progetti che devono essere indicizzati seguendo questa procedura:

1. Passare a Azure DevOps e selezionare l'organizzazione necessaria.
2. Selezionare Organization settings.
3. Nel riquadro di spostamento a sinistra selezionare Users sotto l'intestazione "Generale".
4. Selezionare Add users.
5. Copiare l'ID applicazione (client) ottenuto dall'app in "Utenti o entità servizio".
6. Concedere il Basic livello di accesso e selezionare i progetti per consentire l'accesso all'indice. Aggiungere inoltre al Project Reader gruppo Azure DevOps (o equivalente) per garantire l'accesso. Deselezionare l'opzione per inviare l'invito tramite posta elettronica agli utenti.

Selezionare l'organizzazione

Specificare il Azure nome dell'organizzazione DevOps. Il Azure nome dell'organizzazione DevOps è il segmento dopo https://dev.azure.com/. Ad esempio:

• URL: https://dev.azure.com/contoso
• Organizzazione: contoso

È necessario solo il nome dell'organizzazione. Non specificare l'URL completo.

Implementare un gruppo di destinatari 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, vedere Implementazione a fasi.

A questo punto, si è pronti per creare la connessione per Azure wiki DevOps. È possibile fare clic su Crea per pubblicare i wiki di connessione e indicizzazione dall'organizzazione Azure DevOps.

Per altre impostazioni, ad esempio autorizzazioni di accesso, regole di inclusione dati, schema, frequenza di ricerca per indicizzazione e così via, sono disponibili impostazioni predefinite basate su ciò che funziona meglio con i dati ADO. Di seguito sono riportati i valori predefiniti:

Se si desidera modificare uno di questi valori, è necessario scegliere la "Configurazione personalizzata"

Installazione personalizzata

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

Utenti

Autorizzazioni di accesso

Il connettore Azure DevOps Wiki Copilot supporta le autorizzazioni di ricerca visibili a Tutti o Solo gli 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.

Contenuto

Scegliere i progetti

In questo passaggio si specifica l'ambito dei dati da indicizzare usando il connettore Azure DevOps Wiki Copilot. È quindi possibile scegliere la connessione per indicizzare l'intera organizzazione o progetti specifici all'interno dell'organizzazione selezionata.

Se si sceglie di indicizzare l'intera organizzazione, i wiki in tutti i progetti dell'organizzazione vengono indicizzati. I nuovi progetti e wiki vengono indicizzati durante la ricerca per indicizzazione successiva dopo che sono stati creati.

Se si sceglie di indicizzare singoli progetti, vengono indicizzati solo i wiki nei progetti selezionati.

Gestire le proprietà

In questo caso, è possibile aggiungere o rimuovere le proprietà disponibili dall'origine dati Azure DevOps, assegnare uno schema alla proprietà (definire se una proprietà è ricercabile, ricercabile, recuperabile o rifinibile), modificare l'etichetta semantica e aggiungere un alias alla proprietà. Di seguito sono elencate le proprietà selezionate per impostazione predefinita.

Anteprima dei dati

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

Sincronizza

L'intervallo di aggiornamento determina la frequenza con cui i dati vengono sincronizzati tra l'origine dati e l'indice del connettore DevOps Wiki Copilot Azure. Esistono due tipi di intervalli di aggiornamento: ricerca per indicizzazione completa e ricerca per indicizzazione incrementale. Per altre informazioni, vedere Impostazioni di aggiornamento.

È possibile modificare i valori predefiniti dell'intervallo di aggiornamento da qui, se si vuole.

Configurare la pagina dei risultati della ricerca

Dopo aver pubblicato la connessione, è necessario 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.

È anche possibile usare il layout dei risultati di esempio per il connettore Azure DevOps Wiki Copilot. Copiare e incollare il codice JSON del layout dei risultati per iniziare.

Risoluzione dei problemi

Dopo aver pubblicato la connessione, è possibile esaminare lo stato nella sezione Connettoridell'interfaccia di amministrazione. Per informazioni su come eseguire aggiornamenti ed eliminazioni, vedere Gestire il connettore.

Per risolvere i problemi, vedere Risoluzione dei problemi.