Panoramica delle richieste pull del server GitHub Microsoft 365 Copilot connettore

Il connettore GitHub Server Pull Requests Microsoft 365 Copilot integra i dati delle richieste pull da GitHub Enterprise Server in Microsoft 365. Dopo aver configurato il contenuto del connettore e dell'indice di GitHub, gli utenti possono individuare, riepilogare e recuperare le informazioni sulle richieste pull direttamente da Microsoft Search, Microsoft 365 Copilot e Ricerca Copilot. Questa indicizzazione offre ai team di progettazione un accesso più rapido alle modifiche in corso, alle informazioni dettagliate sulla revisione del codice, alle informazioni sulla versione e all'attività del repository, senza cambiare applicazione.

Perché usare il connettore GitHub Server Pull Requests per indicizzare i dati?

I team di sviluppo software moderni si basano su richieste pull per gestire il lavoro, collaborare alle modifiche e valutare la conformità alla versione. Tuttavia, i dati delle richieste pull sono spesso siloed in GitHub, richiedendo a tecnici, program manager (VM), DevOps, SRE e stakeholder di eseguire manualmente ricerche tra i repository per individuare le richieste pull pertinenti.

Il connettore richieste pull di GitHub Server risolve questa sfida tramite l'indicizzazione dei metadati delle richieste pull da GitHub Enterprise Server. Gli utenti possono cercare, filtrare e riepilogare le richieste pull direttamente da Microsoft 365. Con Copilot, gli utenti possono porre domande in linguaggio naturale, ad esempio "Quali richieste pull aperte sono in attesa di revisione nel nostro servizio di pagamento?" e ricevere risposte basate e interattive con collegamenti a GitHub.

I casi d'uso comuni includono:

• Accelerare le revisioni del codice: Surface PR per stato, etichetta, attività cardine o team.
• Migliorare la gestione delle versioni: Identificare le richieste pull destinate ai rami di versione o alle distribuzioni di blocco.
• Supporto della collaborazione interfun funzionalità: Aiutare le macchine virtuali, i team di supporto e la leadership a tenere traccia dei progressi della progettazione.
• Ridurre il cambio di contesto: Consentire agli sviluppatori e agli stakeholder di rimanere all'interno di Microsoft 365 facendo riferimento al lavoro di GitHub.

Creare agenti con il connettore GitHub Server Pull Requests

Gli sviluppatori possono usare questo connettore come origine conoscenze negli agenti dichiarativi compilati con Copilot Studio, Agent Builder in Microsoft 365 Copilot o Microsoft 365 Agents Toolkit.

Incorporando i dati delle richieste pull di GitHub in agenti, gli sviluppatori consentono agli utenti di:

• Recuperare e riepilogare le richieste pull in attesa di revisione.
• Identificare le richieste pull associate al lavoro delle funzionalità, alle attività cardine o alle modifiche dell'infrastruttura.
• Fornire visibilità sullo stato di avanzamento della progettazione durante i cicli di pianificazione e rilascio.

Richieste dell'agente

Gli esempi seguenti mostrano richieste che i generatori di agenti possono usare per consentire agli utenti di recuperare informazioni dalle richieste pull del server GitHub.

Progettazione

• Quali richieste pull aperte sono attualmente in attesa di revisione nel servizio di pagamento?
• Riepilogare le richieste pull bozza create questa settimana per il repository back-end.
• Quali richieste pull sono assegnate a me e qual è lo stato corrente?

DevOps/SRE

• Elencare le richieste pull destinate al ramo di rilascio e riepilogarne l'idoneità.
• Quali richieste pull includono modifiche all'infrastruttura o alla configurazione in base a metadati o etichette?
• Quali richieste pull bloccano la distribuzione di produzione imminente?

Supporto IT/Help desk

• Trovare le richieste pull correlate agli aggiornamenti degli strumenti interni e riepilogare l'impatto previsto.
• Quali richieste pull stanno monitorando i miglioramenti all'ambiente di sviluppo?

Gestione dei prodotti

• Riepilogare le richieste pull collegate all'attività cardine vNext tra i repository di base.
• Quali richieste pull aperte corrispondono alle funzionalità pianificate per la prossima versione?

Leadership di progettazione

• Fornire un riepilogo delle richieste pull ad alta priorità tra i team.
• Quali richieste pull sono aperte più a lungo e chi le possiede?

Funzionalità e limitazioni del connettore richieste pull di GitHub Server

Il connettore GitHub Server Pull Requests consente agli utenti di:

• Eseguire query in linguaggio naturale sui metadati delle richieste pull.
• Recuperare i dettagli della richiesta pull, ad esempio titoli, descrizioni, etichette, attività cardine, autori, revisori, assegnatari e timestamp.
• Contesto a livello di repository di Surface, ad esempio i metadati dell'organizzazione e del repository.
• Gestire i controlli di accesso di GitHub per assicurarsi che solo gli utenti autorizzati visualizzi le richieste pull del repository privato.
• Usare Microsoft 365 Copilot e Microsoft Search per riepilogare ed esplorare i dati delle richieste pull in modo efficiente.
• Personalizzare la frequenza di ricerca per indicizzazione, il mapping delle identità e le preferenze di indicizzazione.

Il connettore GitHub Server Pull Requests presenta le limitazioni seguenti:

• Non indicizzare le differenze di codice, le modifiche ai file, i commenti inline, i messaggi di commit o i dettagli a livello di commit.
• Le pipeline CI/CD oltre i metadati di stato di base non vengono indicizzate.
• Le istanze di GitHub locali o self-hosted che non soddisfano i requisiti di accessibilità dell'API non sono supportate.
• Richiede GitHub Enterprise; I piani GitHub Free o Team potrebbero avere una compatibilità ridotta.
• I commenti, le discussioni in thread e gli artefatti collegati non vengono sottoposti a ricerca per indicizzazione.
• Per motivi di sicurezza, il connettore non supporta l'indicizzazione delle organizzazioni in cui tutti i repository sono pubblici. Per sbloccare questo scenario, contattare il supporto tecnico Microsoft.

Tipi di dati indicizzati da richieste pull del server GitHub

Nella tabella seguente vengono descritti i tipi di dati indicizzati dal connettore.

I tipi di dati seguenti non sono indicizzati: differenze di codice, modifiche di file, commenti, dettagli del commit, pipeline CI/CD o artefatti collegati.

Modello di autorizzazioni e controllo di accesso

Il connettore applica il modello di autorizzazione di GitHub per garantire che gli utenti visualizzino solo le informazioni sulla richiesta pull che sono autorizzati a visualizzare.

Le autorizzazioni per repository e team includono:

• Le richieste pull del repository privato vengono visualizzate solo per gli utenti con accesso al repository.
• Vengono rispettate le restrizioni di accesso a livello di organizzazione o basate su team.
• Il contenuto che non può essere mappato a un'identità valida è nascosto per impedire l'esposizione.

Il mapping delle identità utente include:

• Mapping automatico quando gli indirizzi di posta elettronica di GitHub corrispondono Microsoft Entra ID.
• Supporto per il mapping tramite posta elettronica, accesso o nome.
• Regole di espressione regolare facoltative per trasformare gli attributi di identità per una corrispondenza coerente.
• Mapping di fallback manuale quando il mapping automatico non riesce.
• Requisiti per consentire agli utenti di condividere gli attributi di identità appropriati in scenari come il modello Bring Your Own User (BYOU).

Passaggio successivo