Condividi tramite

Distribuire il connettore Microsoft 365 Copilot elementi di lavoro Azure DevOps

Il connettore Azure DevOps Work Items indicizza gli elementi di lavoro, ad esempio storie utente, attività, bug e funzionalità, dall'organizzazione Azure DevOps Services a Microsoft 365. Questa guida descrive i passaggi per distribuire e personalizzare il connettore.

Per Azure informazioni sulla configurazione di DevOps, vedere Configurare l'ambiente Azure DevOps per l'inserimento del connettore.

Prerequisiti

Prima di distribuire il connettore Azure DevOps Work Items, verificare che l'ambiente DevOps Azure sia configurato nell'organizzazione e che siano soddisfatti i prerequisiti seguenti:

  • È necessario essere un amministratore di Microsoft 365.
  • È stata identificata l'organizzazione Azure DevOps da indicizzare.
  • È stato configurato un account del servizio di ricerca per indicizzazione (entità servizio o utente) in Azure DevOps con almeno le autorizzazioni di lettura necessarie per tutti i progetti e i percorsi di area da indicizzare.

Distribuire il connettore

Per aggiungere il connettore Azure DevOps Work Items per l'organizzazione:

  1. Nel riquadro sinistro della interfaccia di amministrazione di Microsoft 365 scegliere Connettori Copilot>.
  2. Scegliere la scheda Raccolta .
  3. Nell'elenco dei connettori disponibili scegliere Azure elementi di lavoro DevOps.

Impostare il nome visualizzato

Il nome visualizzato viene usato per identificare i riferimenti nelle risposte copilot per consentire agli utenti di riconoscere l'origine di contenuto associata. È possibile accettare il nome visualizzato predefinito Azure Elementi di lavoro DevOps o personalizzarlo in base alle esigenze dell'organizzazione.

Impostare l'URL dell'istanza

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.

Scegliere il tipo di autenticazione

Per sincronizzare gli elementi di lavoro da Azure DevOps, scegliere uno dei metodi di autenticazione supportati e completare la configurazione necessaria:

  • Credenziali federate (scelta consigliata): usa un'entità servizio per eseguire la ricerca per indicizzazione del contenuto.
  • Microsoft Entra ID OAuth: usa l'account amministratore di Microsoft 365 connesso.

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 Project Administrators (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

Microsoft Entra ID OAuth usa l'account amministratore di Microsoft 365 connesso come account del servizio di ricerca per indicizzazione. Per consentire al connettore di accedere Azure DevOps e aggiornare gli elementi di lavoro, concedere le autorizzazioni necessarie.

Verificare che l'organizzazione Azure DevOps sia connessa a Microsoft Entra

Il connettore può indicizzare solo gli elementi di lavoro di un'organizzazione DevOps Azure collegata alla Microsoft Entra ID del tenant.

  1. Passare a Azure DevOps e selezionare l'organizzazione.
  2. Selezionare Impostazioni organizzazione.
  3. Nel riquadro sinistro, in Generale, selezionare Microsoft Entra.
  4. Verificare che l'organizzazione sia connessa all'account Microsoft Entra del tenant.

Nota

L'amministratore che crea la connessione deve avere accesso in lettura al progetto pertinente.

Creare un'app in Microsoft Entra ID
  1. Accedere al portale di Azure con le credenziali di amministratore.
  2. Passare a Microsoft Entra ID>O applicazioni>di identità>Registrazioni app quindi selezionare Nuova registrazione.
  3. Immettere un nome per l'app e selezionare Registra.
  4. Prendere nota dell'ID applicazione (client): verrà usato per concedere l'accesso al progetto in Azure DevOps.
Configurare le autorizzazioni dell'API
  1. Nella registrazione dell'app selezionare Autorizzazioni API.
  2. Scegliere Aggiungi un'autorizzazione> AzureAutorizzazioni delegatedevOps>.
  3. Aggiungere le autorizzazioni seguenti (tutte in vso):
    • vso.analytics - Analisi (lettura)
    • vso.graph - Grafico (lettura)
    • vso.identity - Identità (lettura)
    • vso.project - Progetto e team (lettura)
    • vso.variablegroups_read - Gruppi di variabili (lettura)
    • vso.work : elementi di lavoro (lettura)
  4. Selezionare Concedi consenso amministratore per <TenantName> e confermare.
  5. Verificare che tutte le autorizzazioni mostrino lo stato Concesso.
Configurare le impostazioni di autenticazione
  1. Nella registrazione dell'app selezionare Autenticazione.
  2. Selezionare Aggiungi una piattaforma e scegliere Web.
  3. In URI di reindirizzamento aggiungere l'URI per l'ambiente cloud:
    • Microsoft 365 Enterprise:https://gcs.office.com/v1.0/admin/oauth/callback
    • Microsoft 365 Per enti pubblici: https://gcsgcc.office.com/v1.0/admin/oauth/callback
  4. In Concessione implicita e flussi ibridi selezionare Token ID.
  5. Selezionare Configura per salvare le impostazioni.
Creare un segreto client
  1. Nella registrazione dell'app selezionare Certificati e segreti.
  2. In Segreti client selezionare Nuovo segreto client.
  3. Scegliere un periodo di scadenza e creare il segreto.
  4. Copiare il valore del segreto e archiviarlo in modo sicuro. Non è possibile visualizzarlo di nuovo dopo aver lasciato la pagina.

Usare il segreto client e l'ID applicazione (client) quando si configura il connettore nel interfaccia di amministrazione di Microsoft 365.

Autenticare l'app Microsoft Entra con un account di ricerca per indicizzazione

Quando si accede come amministratore, l'app Microsoft Entra viene autenticata automaticamente tramite Single Sign-On. Microsoft Entra ID rilascia un token di accesso all'app, che include l'identità dell'utente e le autorizzazioni delegate concesse. L'app può accedere solo ai dati e alle azioni a cui l'utente amministratore connesso è autorizzato ad accedere.

Eseguire l'implementazione

Per distribuire il connettore a un gruppo di destinatari limitato, scegliere l'interruttore accanto a Implementazione a gruppi di destinatari limitati e specificare gli utenti o i gruppi a cui distribuire il connettore. In questo modo è possibile convalidare il connettore prima di una distribuzione completa. Per altre informazioni, vedere Implementazione temporanea per i connettori Copilot.

Scegliere Crea per distribuire la connessione. Il connettore Azure DevOps Work Items inizia immediatamente l'indicizzazione del contenuto.

Nella tabella seguente sono elencati i valori predefiniti impostati.

Categoria Valore predefinito
Utenti Solo gli utenti con accesso al contenuto nell'origine dati. Identità dell'origine dati mappate tramite ID Microsoft Entra.
Contenuto Tutti i progetti sono indicizzati.
Sincronizza Ricerca per indicizzazione completa ogni giorno. Ricerca per indicizzazione incrementale ogni 15 minuti.

Per personalizzare questi valori, scegliere Configurazione personalizzata. Per altre informazioni, vedere Personalizzare le impostazioni.

Dopo aver creato la connessione, è possibile esaminare lo stato nella sezione Connettori del interfaccia di amministrazione di Microsoft 365.

Personalizzare le impostazioni (facoltativo)

È possibile personalizzare le impostazioni predefinite per il connettore Azure DevOps Work Items scegliendo Configurazione personalizzata nella pagina del connettore.

Personalizzare le impostazioni utente

Autorizzazioni di accesso

Il connettore Azure DevOps Work Items supporta le autorizzazioni di ricerca seguenti:

  • Visibile a tutti
  • Solo gli utenti con accesso a questa origine dati

Se si sceglie Visibile a 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.

Nota

Aggiornamenti ai gruppi che controllano le autorizzazioni di accesso vengono sincronizzati solo in ricerche per indicizzazione complete. Le ricerche per indicizzazione incrementali non supportano l'elaborazione degli aggiornamenti alle autorizzazioni.

Esegui il mapping delle identità

Il mapping delle identità garantisce che Azure le identità DevOps vengano mappate correttamente agli utenti Microsoft Entra ID. Il connettore usa l'accesso delegato e allinea automaticamente le identità tramite l'account amministratore di Microsoft 365 connesso.

Personalizzare le impostazioni del contenuto

Gestire le proprietà

È possibile aggiungere o rimuovere proprietà dall'origine dati Azure DevOps, 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à indicizzate per impostazione predefinita.

Proprietà Etichetta semantica Descrizione Attributi dello schema
AreaPath Percorso dell'area dell'elemento di lavoro Query, Recupero, Ricerca
AssignedTo Nome della persona a cui è assegnato l'elemento di lavoro Query, Recupero, Ricerca
Autori Autori Recuperare
ChangedBy Autore ultima modifica Nome dell'ultima persona che ha modificato l'elemento di lavoro Query, Retrieve
ChangedDate Data e ora dell'ultima modifica Query, Retrieve
CreatedBy Creato da Nome persona che ha creato l'elemento di lavoro Query, Recupero, Ricerca
CreatedDate Data e ora di creazione Timestamp quando è stato creato l'elemento di lavoro Query, Retrieve
Descrizione Contenuto Descrizione dell'elemento di lavoro Ricerca
IconUrl IconUrl Recuperare
Id ID elemento di lavoro Query, Recupero, Ricerca
Priorità Priorità dell'elemento di lavoro Query, Retrieve
ReproSteps Passaggi per riprodurre una condizione descritta nell'elemento di lavoro
Stato Stato corrente dell'elemento di lavoro Query, Recupero, Ricerca
Tag Query, Recupero, Ricerca
Teamproject Recuperare
Titolo Titolo Titolo dell'elemento di lavoro Recupera, Cerca
URL Url URL dell'elemento di lavoro Recuperare
Workitemtype Query, Recupero, Ricerca

Personalizzare gli intervalli di sincronizzazione

È possibile modificare la frequenza con cui il connettore esegue la ricerca per indicizzazione nell'organizzazione Azure DevOps. Sono disponibili gli intervalli di sincronizzazione seguenti:

  • Ricerca per indicizzazione completa: Esegue di nuovo la ricerca per indicizzazione dell'intero set di dati Azure DevOps.
  • Ricerca per indicizzazione incrementale: Rieseguire la ricerca per indicizzazione solo di elementi aggiornati.

Le impostazioni di sincronizzazione predefinite sono ottimizzate per la maggior parte delle organizzazioni.

Per altre informazioni, vedere Linee guida per le impostazioni di sincronizzazione.

Contenuto correlato

  • Last updated on