Panoramica del connettore knowledge Microsoft 365 Copilot di GitHub Server

Il connettore knowledge Microsoft 365 Copilot di GitHub Server consente alle organizzazioni di indicizzare le informazioni archiviate nei repository di GitHub Enterprise, inclusi file markdown, pagine wiki e blog, in modo che gli utenti possano cercare e recuperare informazioni tramite Microsoft Search e Microsoft 365 Copilot. Dopo aver configurato i dati del connettore e dell'indice, il contenuto di GitHub viene visualizzato direttamente nelle app di Microsoft 365, ad esempio Teams, Outlook e SharePoint. Questi dati supportano la collaborazione e l'individuazione delle conoscenze nell'organizzazione.

Perché usare il connettore Knowledge Connector di GitHub Server per indicizzare i dati?

Il connettore Knowledge Base di GitHub Server è progettato per le organizzazioni che vogliono rendere facilmente individuabile la documentazione tecnica, i wiki e le knowledge base archiviati in GitHub all'interno di Microsoft 365. I casi d'uso comuni includono:

• Consentire a tecnici e writer tecnici di trovare rapidamente la documentazione interna e le procedure consigliate.
• Supportare i team IT e di supporto con accesso alle guide alla risoluzione dei problemi e alle conoscenze operative.
• Facilitare l'onboarding aprendo le conoscenze aziendali in Copilot e Microsoft Search.
• Consentire ai decision maker aziendali di accedere alle informazioni tecniche e ai progetti.

Creare agenti con il connettore knowledge base di GitHub Server

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

I generatori di agenti possono usare i prompt per consentire agli utenti di recuperare informazioni dalla knowledge base di GitHub Server. Le richieste di esempio includono:

• Mostra gli aggiornamenti wiki più recenti per il team di progettazione.
• Trovare le guide alla risoluzione dei problemi per gli strumenti interni.
• Elencare la documentazione di onboarding per i nuovi sviluppatori.
• Recuperare i post di blog contrassegnati con "sicurezza" dal knowledge base di GitHub.

Funzionalità e limitazioni del connettore knowledge base di GitHub Server

Il connettore knowledge base di GitHub Server consente agli utenti di:

• Indicizzare file markdown, pagine wiki e blog dai repository di GitHub Enterprise.
• Eseguire query in linguaggio naturale in Copilot e Microsoft Search per recuperare il contenuto di GitHub pertinente.
• Gestire gli elenchi di controllo di accesso (ACL) di GitHub e le autorizzazioni utente per i dati indicizzati.
• Personalizzare la frequenza di ricerca per indicizzazione e le preferenze di indicizzazione in base alle esigenze dell'organizzazione.
• Eseguire il mapping delle identità utente di GitHub a Microsoft Entra ID per un'applicazione accurata delle autorizzazioni.

Il connettore presenta le limitazioni seguenti:

• Il connettore non supporta l'indicizzazione delle pipeline CI/CD di GitHub oltre all'indicizzazione dello stato.
• Il connettore è progettato in modo specifico per le istanze di GitHub Enterprise Server (locale/self-hosted). GitHub.com (ospitati nel cloud) e i piani non Enterprise non sono supportati.
• Gli utenti nei piani Gratuito o Team potrebbero riscontrare funzionalità limitate o un supporto ridotto.
• 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 Server Knowledge

Il connettore indicizza i tipi di dati seguenti:

• File Markdown (.md)
• Pagine wiki
• Blog e documentazione di testo

Il contenuto indicizzato viene visualizzato nei risultati di Copilot e Microsoft Search, consentendo agli utenti di individuare e interagire con le conoscenze aziendali direttamente all'interno delle app di Microsoft 365.

Modello di autorizzazioni e controllo di accesso

Gli amministratori possono impostare le autorizzazioni per i dati GitHub indicizzati usando il mapping Microsoft Entra ID. Il connettore supporta due modelli di accesso:

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

Le opzioni di mapping delle identità includono:

• Email: esegue il mapping della posta elettronica di GitHub alle proprietà dell'utente Microsoft Entra ID.
• Accesso: esegue l'accesso di GitHub a Microsoft Entra ID proprietà utente.
• Nome: esegue il mapping del nome di GitHub alle proprietà utente Microsoft Entra ID.

Se il mapping diretto non riesce, è possibile usare espressioni regolari (regex) per trasformare i dati di identità. Per gli account personali, le variazioni del dominio di posta elettronica e le impostazioni di visibilità possono influire sull'accuratezza del mapping.

Passaggio successivo

Distribuire il connettore knowledge base di GitHub Server