Compartilhar via


Descrição geral do conector do Microsoft 365 Copilot de Conhecimento da Cloud do GitHub

O conector do GitHub Cloud Knowledge Microsoft 365 Copilot permite que as organizações indexem markdown e ficheiros de texto de repositórios do GitHub para experiências de Microsoft 365 Copilot e Microsoft Search. Ao integrar conteúdos do GitHub com o Microsoft 365, os utilizadores podem aceder diretamente à documentação do projeto e aos guias técnicos em aplicações familiares, reduzindo a mudança de contexto e melhorando a produtividade.

Porquê utilizar o conector de Conhecimento da Cloud do GitHub para indexar os seus dados?

O conector de Conhecimento da Cloud do GitHub é ideal para organizações que utilizam o GitHub para documentação, ficheiros de projeto ou gestão de conteúdos. Pode utilizar o conector para:

  • Torne a documentação do projeto pesquisável no Microsoft 365.
  • Permitir que os utilizadores façam perguntas do Copilot, tais como:
    • Como fazer configurar o Project Alpha?
    • Onde posso encontrar as instruções de implementação?
    • Qual é a descrição geral da arquitetura para este projeto?
  • Resumir secções-chave na documentação do projeto para referência rápida.

Criar agentes com o conector de Conhecimento da Cloud do GitHub

Os programadores podem utilizar este conector como uma origem de conhecimento em agentes declarativos que criam com Copilot Studio, o Agent Builder no Microsoft 365 Copilot ou o Toolkit de Agentes do Microsoft 365.

Pedidos do agente

Os exemplos seguintes mostram pedidos que os construtores de agentes podem utilizar para ajudar os seus utilizadores a obter informações do conector de Conhecimento da Cloud do GitHub.

Função Prompt de exemplo
Developer Resuma a descrição geral da arquitetura do Project Alpha.
Gerente de Projeto Liste todos os passos de implementação para a versão mais recente.
Engenheiro de Suporte Onde posso encontrar instruções de resolução de problemas para a integração da API?

Capacidades e limitações do conector de Conhecimento da Cloud do GitHub

O conector de Conhecimento da Cloud do GitHub permite aos utilizadores:

  • Indexe repositórios, markdown e ficheiros de texto do GitHub Cloud para tornar a documentação do projeto acessível no Microsoft 365.
  • Execute consultas de linguagem natural no Copilot para obter guias técnicos e documentação.
  • Utilize a pesquisa semântica para localizar conteúdos relevantes com base em palavras-chave, preferências e ligações sociais.
  • Resumir a documentação do projeto para referência rápida.

O conector de Conhecimento da Cloud do GitHub tem as seguintes limitações:

  • Apenas os metadados do repositório, markdown e ficheiros de texto são indexados. Os problemas, os pedidos Pull e os comentários não estão indexados.
  • Só são suportados ficheiros de markdown e texto com um tamanho máximo de 30 MB. Os ficheiros maiores não são indexados.
  • Por motivos de segurança, o conector não suporta a indexação de organizações onde todos os repositórios são públicos. Para desbloquear este cenário, contacte o suporte da Microsoft.

Tipos de dados indexados a partir do GitHub Cloud Knowledge

O conector indexa os seguintes tipos de dados.

Tipo de dados Descrição
Ficheiros markdown Documentação e guias do projeto
Arquivos de texto Notas técnicas e instruções
Metadados do repositório Informações básicas do repositório

Os conteúdos indexados são apresentados nas respostas Microsoft 365 Copilot e nos resultados do Microsoft Search.

Modelo de permissões e controlo de acesso

O conector impõe permissões do GitHub ao apresentar os resultados da pesquisa. Os dados indexados podem ser visíveis para:

  • Apenas as pessoas com acesso a esta origem de dados (predefinição): os resultados são apresentados apenas para utilizadores com acesso no GitHub.
  • Todos: os resultados são apresentados para todos os utilizadores na organização.

O mapeamento de identidade entre o GitHub e o Microsoft Entra ID é necessário para a imposição de permissões precisa. As opções de mapeamento incluem:

  • Email
  • Entrar
  • Nome

Se o mapeamento direto falhar, pode utilizar expressões regulares (regex) para transformar dados de identidade.

Próxima etapa