Panoramica del connettore GitHub Cloud Knowledge Microsoft 365 Copilot

Il connettore GitHub Cloud Knowledge Microsoft 365 Copilot consente alle organizzazioni di indicizzare i file markdown e di testo dai repository GitHub in esperienze di ricerca Microsoft 365 Copilot e Microsoft. Integrando il contenuto di GitHub con Microsoft 365, gli utenti possono accedere alla documentazione del progetto e alle guide tecniche direttamente nelle app familiari, riducendo il cambio di contesto e migliorando la produttività.

Perché usare il connettore GitHub Cloud Knowledge per indicizzare i dati?

Il connettore GitHub Cloud Knowledge è ideale per le organizzazioni che usano GitHub per la documentazione, i file di progetto o la gestione del contenuto. È possibile usare il connettore per:

• Rendere la documentazione del progetto ricercabile in Microsoft 365.
• Consentire agli utenti di porre domande copilot, ad esempio:
  • Ricerca per categorie configurare Project Alpha?
  • Dove è possibile trovare le istruzioni per la distribuzione?
  • Qual è la panoramica dell'architettura per questo progetto?
• Riepilogare le sezioni chiave nella documentazione del progetto per informazioni di riferimento rapido.

Creare agenti con il connettore GitHub Cloud Knowledge

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.

Richieste dell'agente

Gli esempi seguenti mostrano le richieste che i generatori di agenti possono usare per consentire agli utenti di recuperare informazioni dal connettore GitHub Cloud Knowledge.

Ruolo	Richiesta di esempio
Developer	Riepilogare la panoramica dell'architettura per Project Alpha.
Project manager	Elencare tutti i passaggi di distribuzione per la versione più recente.
Tecnico del supporto tecnico	Dove è possibile trovare le istruzioni per la risoluzione dei problemi per l'integrazione dell'API?

Funzionalità e limitazioni del connettore GitHub Cloud Knowledge

Il connettore GitHub Cloud Knowledge consente agli utenti di:

• Indicizzare i repository, il markdown e i file di testo di GitHub Cloud per rendere accessibile la documentazione del progetto in Microsoft 365.
• Eseguire query in linguaggio naturale in Copilot per recuperare guide tecniche e documentazione.
• Usare la ricerca semantica per trovare contenuto pertinente in base a parole chiave, preferenze e connessioni di social networking.
• Riepilogare la documentazione del progetto per informazioni di riferimento rapido.

Il connettore GitHub Cloud Knowledge presenta le limitazioni seguenti:

• Vengono indicizzati solo i metadati del repository, il markdown e i file di testo. I problemi, le richieste pull e i commenti non sono indicizzati.
• Sono supportati solo i file markdown e di testo fino a 30 MB. I file di dimensioni maggiori non sono indicizzati.
• 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 GitHub Cloud Knowledge

Il connettore indicizza i tipi di dati seguenti.

Tipo di dati	Descrizione
File markdown	Documentazione e guide del progetto
File di testo	Note tecniche e istruzioni
Metadati del repository	Informazioni di base sul repository

Il contenuto indicizzato viene visualizzato nelle risposte Microsoft 365 Copilot e nei risultati di Microsoft Search.

Modello di autorizzazioni e controllo di accesso

Il connettore applica le autorizzazioni di GitHub durante la visualizzazione dei risultati della ricerca. I dati indicizzati possono essere visibili a:

• Solo gli utenti con accesso a questa origine dati (impostazione predefinita): i risultati vengono visualizzati solo per gli utenti che hanno accesso in GitHub.
• Tutti: i risultati vengono visualizzati per tutti gli utenti dell'organizzazione.

Il mapping delle identità tra GitHub e Microsoft Entra ID è necessario per un'applicazione accurata delle autorizzazioni. Le opzioni di mapping includono:

• Posta elettronica
• Accesso
• Nome

Se il mapping diretto non riesce, è possibile usare espressioni regolari (regex) per trasformare i dati di identità.

Passaggio successivo

Distribuire il connettore GitHub Cloud Knowledge