Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
O conector gitHub Server Pull Requests Microsoft 365 Copilot integra dados de pedidos Pull do GitHub Enterprise Server no Microsoft 365. Depois de configurar o conector e indexar conteúdos do GitHub, os utilizadores podem detetar, resumir e obter informações de pedidos Pull diretamente a partir do Microsoft Search, Microsoft 365 Copilot e copilot Search. Esta indexação dá às equipas de engenharia acesso mais rápido a alterações em curso, informações de revisão de código, informações de versão e atividade de repositório sem mudar de aplicação.
Porquê utilizar o conector Pedidos Pull do GitHub Server para indexar os seus dados?
As equipas modernas de desenvolvimento de software dependem de pedidos Pull para gerir o trabalho, colaborar em alterações e avaliar a preparação do lançamento. No entanto, os dados de pedidos Pull são frequentemente siloados no GitHub, exigindo que engenheiros, gestores de programas (PMs), DevOps, SREs e intervenientes procurem manualmente em repositórios para localizar PRs relevantes.
O conector Pedidos Pull do GitHub Server aborda este desafio ao indexar metadados de pedidos Pull do GitHub Enterprise Server. Os utilizadores podem procurar, filtrar e resumir PRs diretamente a partir do Microsoft 365. Com a Copilot, os utilizadores podem fazer perguntas em linguagem natural, como "Que PRs abertos estão à espera de revisão no nosso serviço de pagamentos?" e receber respostas fundamentadas e acionáveis com ligações para o GitHub.
Os casos de utilização comuns incluem:
- Acelere as revisões de código: PRs do Surface por status, etiqueta, marco ou equipa.
- Melhorar a gestão de versões: Identificar PRs destinados a ramos de versão ou a bloquear implementações.
- Suporte para colaboração multifuncional: Ajude PMs, equipas de suporte e liderança a acompanhar o progresso da engenharia.
- Reduzir a mudança de contexto: Permita que os programadores e intervenientes permaneçam no Microsoft 365 enquanto referenciam o trabalho do GitHub.
Criar agentes com o conector Pedidos Pull do GitHub Server
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.
Ao incorporar dados de pedidos Pull do GitHub em agentes, os programadores permitem que os utilizadores:
- Obter e resumir PRs a aguardar revisão.
- Identifique PRs associados a alterações de infraestrutura, marcos ou trabalho de funcionalidades.
- Forneça visibilidade sobre o progresso da engenharia durante os ciclos de planeamento e lançamento.
Pedidos do agente
Os exemplos seguintes mostram pedidos que os construtores de agentes podem utilizar para ajudar os utilizadores a obter informações a partir de Pedidos Pull do GitHub Server.
Engenharia
- Que PRs abertos estão atualmente a aguardar revisão no serviço de finalização da compra?
- Resumir os pedidos Pull de rascunho criados esta semana para o repositório de back-end.
- Que PRs estão atribuídos a mim e qual é o seu status atual?
DevOps/SRE
- Liste PRs destinados ao ramo de lançamento e resuma a preparação.
- Que PRs incluem alterações de infraestrutura ou configuração com base em metadados ou etiquetas?
- Que PRs estão a bloquear a próxima implementação de produção?
Suporte de TI/Suporte técnico
- Encontre PRs relacionados com atualizações de ferramentas internas e resuma o impacto esperado.
- Que pedidos Pull estão a acompanhar as melhorias no ambiente do programador?
Gestão de produtos
- Resumir PRs ligados ao marco vNext entre repositórios principais.
- Que PRs abertos correspondem às funcionalidades planeadas para a próxima versão?
Liderança de engenharia
- Forneça um resumo de PRs de alta prioridade entre equipas.
- Que PRs estão abertos há mais tempo e quem os possui?
Capacidades e limitações do conector de Pedidos Pull do GitHub Server
O conector Pedidos Pull do GitHub Server permite que os utilizadores:
- Executar consultas de linguagem natural através de metadados de pedidos Pull.
- Obtenha detalhes do pedido Pull, como títulos, descrições, etiquetas, marcos, autores, revisores, detentores e carimbos de data/hora.
- Contexto ao nível do repositório do Surface, como metadados de organização e repositório.
- Mantenha os controlos de acesso do GitHub para garantir que apenas os utilizadores autorizados veem PRs do repositório privado.
- Utilize o Microsoft 365 Copilot e o Microsoft Search para resumir e explorar os dados do PR de forma eficiente.
- Personalizar a frequência de pesquisa, o mapeamento de identidades e as preferências de indexação.
O conector Pedidos Pull do GitHub Server tem as seguintes limitações:
- Não indexa diferenças de código, alterações de ficheiros, comentários inline, mensagens de consolidação ou detalhes ao nível da consolidação.
- Os pipelines ci/CD para além dos metadados básicos status não são indexados.
- As instâncias do GitHub autoalojadas ou no local que não cumpram os requisitos de acessibilidade da API não são suportadas.
- Requer o GitHub Enterprise; Os planos Do GitHub Gratuito ou team podem ter uma compatibilidade reduzida.
- Os comentários, debates por tópicos e artefactos ligados não são pesquisados.
- 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 de Pedidos Pull do GitHub Server
A tabela seguinte descreve os tipos de dados indexados pelo conector.
| Entidade do GitHub | Indexado e apresentado em Copilot e pesquisa |
|---|---|
| Metadados de pedido Pull | Título, corpo/descrição, etiquetas, estado (aberto/fechado), autor, revisores, detentores, marcos, carimbos de data/hora |
| Metadados do repositório | Nome do repositório, organização e campos contextuais utilizados para classificar e filtrar PRs |
Os seguintes tipos de dados não estão indexados: diferenças de código, alterações de ficheiros, comentários, detalhes de consolidação, pipelines ci/CD ou artefactos ligados.
Modelo de permissões e controlo de acesso
O conector impõe o modelo de permissão do GitHub para garantir que os utilizadores apenas veem as informações do pedido Pull que estão autorizados a ver.
As permissões do repositório e da equipa incluem:
- Os pedidos Pull do repositório privado são apresentados apenas para utilizadores com acesso ao repositório.
- As restrições de acesso ao nível da organização ou da equipa são respeitadas.
- Os conteúdos que não podem ser mapeados para uma identidade válida estão ocultos para impedir a exposição.
O mapeamento de identidade do utilizador inclui:
- Mapeamento automático quando os endereços de e-mail do GitHub correspondem Microsoft Entra ID.
- Suporte para mapeamento por e-mail, início de sessão ou nome.
- Regras de expressão regular opcionais para transformar atributos de identidade para correspondência consistente.
- Mapeamento de contingência manual quando o mapeamento automático falha.
- Requisitos para os utilizadores partilharem os atributos de identidade adequados em cenários como o modelo ByOU (Bring Your Own User).