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 Microsoft 365 Copilot Pedidos Pull do GitHub Server integra metadados de pedidos Pull do GitHub Enterprise Server no Microsoft 365. Após a implementação, o conector indexa títulos de PR, descrições, etiquetas, carimbos de data/hora, autores, revisores, marcos e contexto de repositório para que os utilizadores possam procurar, resumir e obter informações do PR com Microsoft 365 Copilot, a Pesquisa Copilot e o Microsoft Search.
Este artigo descreve os passos para implementar e personalizar o conector Pedidos Pull do GitHub Server.
Para obter informações avançadas sobre a configuração do serviço GitHub, veja
Configure o serviço GitHub para a ingestão de conectores de Pedidos Pull do GitHub Server.
Pré-requisitos
Antes de implementar o conector Pedidos Pull do GitHub Server, certifique-se de que o ambiente do GitHub Enterprise Server está configurado para ingestão. A tabela seguinte resume os passos para configurar o ambiente de serviço do GitHub e implementar o conector.
| Tarefa | Função |
|---|---|
| Configurar o ambiente | Administrador do GitHub |
| Implementar o conector no Centro de administração do Microsoft 365 | Administrador do Microsoft 365 |
| Personalizar as definições do conector (opcional) | Administrador do Microsoft 365 |
Antes de implementar o conector, certifique-se de que cumpre os seguintes pré-requisitos:
- Tem de ser um administrador do Microsoft 365.
- A instância do GitHub Enterprise Server tem de estar acessível através da API.
- A aplicação GitHub tem de estar totalmente configurada e instalada na organização de destino.
- O Agente do Conector do Microsoft Graph tem de estar instalado num dispositivo com acesso à sua instância do GitHub (versão 3.1.11.0 ou posterior).
- A conta de utilizador utilizada para autenticação tem de ter acesso aos repositórios e aos pedidos Pull a indexar.
- Os utilizadores que acedem a dados de PR indexados têm de ter identidades Microsoft Entra ID para ativar o mapeamento de permissões.
Implementar o conector
Para adicionar o conector Pedidos Pull do GitHub Server para a sua organização:
- Na Centro de administração do Microsoft 365, no painel esquerdo, selecioneConectoresCopilot>.
- Aceda ao separador Conectores e, no painel esquerdo, selecione Galeria.
- Na lista de conectores disponíveis, escolha Pedidos Pull do GitHub Server.
Definir nome a apresentar
O nome a apresentar é utilizado para identificar referências em respostas copilot para que os utilizadores possam reconhecer origens de conteúdo. Pode manter o nome predefinido Pedidos Pull do GitHub Server ou substituí-lo por um nome a apresentar personalizado que seja relevante para a sua organização.
Para obter mais informações, veja Enhance Copilot discovery of connector content (Melhorar a deteção copilot de conteúdo do conector).
Definir URL da instância
Introduza o URL da instância do GitHub Enterprise Server. Por exemplo:
https://github.<yourdomain>.com
O conector utiliza este URL para pedir metadados de PR durante a ingestão.
Escolher tipo de autenticação
O conector Pedidos Pull do GitHub Server suporta os seguintes tipos de autenticação:
Aplicação GitHub (em nome do utilizador):
- Introduza o ID de Cliente e o Segredo do cliente do seu Aplicativo GitHub.
- Autorizar o acesso.
- Recomendado ao utilizar contas de utilizador separadas para isolamento de limite de taxa.
Aplicação GitHub (instalação):
- Gere uma chave privada a partir da página de configuração da aplicação GitHub.
- Introduza o ID de Cliente, o nome da organização e carregue a chave privada.
Observação
Este tipo de autenticação está atualmente em pré-visualização. Para utilizar este tipo de autenticação, contacte o suporte da Microsoft.
Implementar
Para implementar o conector para uma audiência limitada, selecione o botão de alternar junto a Implementação para audiência limitada e especifique os utilizadores e grupos que devem ter acesso antecipado. Para obter mais informações, confira
Implementação faseada para conectores Copilot.
Selecione Criar para implementar a ligação. O conector começa a indexar conteúdos imediatamente.
A tabela seguinte lista os valores predefinidos que estão definidos.
| Categoria | Valor padrão |
|---|---|
| Usuários | Mapeamento de identidade disponível através das opções de Email, Início de Sessão e Nome |
| Conteúdo | Metadados de PR completos; filtro de intervalo de tempo predefinido: 365 dias |
| Sincronização | Pesquisa incremental a cada 15 minutos; pesquisa completa diariamente |
Para personalizar estes valores, selecione Configuração personalizada. Para obter mais informações, veja Personalizar definições.
Depois de criar a ligação, pode rever a status na secção Conectores do Centro de administração do Microsoft 365.
Personalizar definições (opcional)
Pode personalizar os valores predefinidos para as definições do conector Pedidos Pull do GitHub Server. Para personalizar as definições, na página do conector no centro de administração, selecione Configuração personalizada.
Personalizar as definições do utilizador
Permissões de acesso
O acesso aos dados do PR respeita as permissões da aplicação GitHub e os controlos de acesso ao repositório do GitHub.
Identidades de mapeamento
Para garantir que as permissões são aplicadas corretamente, mapeie as identidades de utilizador do GitHub para Microsoft Entra ID. Escolha uma das seguintes opções de mapeamento:
- Email: mapeia o e-mail do GitHub para Microsoft Entra ID propriedades do utilizador.
- Início de sessão: Mapeia inícios de sessão do GitHub com Microsoft Entra ID propriedades do utilizador.
- Nome: Mapeia o nome do GitHub com Microsoft Entra ID propriedades de utilizador.
Se o mapeamento direto falhar, utilize expressões regulares (regex) para transformar os dados. Por exemplo: [a-zA-Z0-9]+. Para obter mais informações, veja Mapear identidades Microsoft Entra.
Personalizar definições de conteúdo
Cadeia de consulta
Especifique ou refine os parâmetros de consulta utilizados para filtrar ou identificar o conteúdo do pedido Pull.
Gerir propriedades
A tabela seguinte descreve as propriedades que o conector indexa por predefinição.
| Propriedade | Etiqueta semântica | Descrição | Atributos de esquema |
|---|---|---|---|
| Título | Título | Título do pedido Pull | Texto |
| Descrição | Corpo | Descrição do PR | Texto |
| Rótulos | Marcações | Etiquetas de pedido Pull | Coleção |
| Estado | Status | Estado aberto/fechado | Enum |
| Autor | Autor | Criador de RELAÇÕES Públicas | Usuário |
| Revisores | Revisores | Revisores atribuídos | Coleção |
| Assignees | Proprietários | Contribuidores atribuídos | Coleção |
| Marcos | Etapa | Marco de destino | Texto |
| Carimbos de data/hora | Carimbos de data/hora | Horas de criação/atualização | DateTime |
Personalizar intervalos de sincronização
Estão disponíveis dois tipos de pesquisa:
- Pesquisa incremental: É executada a cada 15 minutos por predefinição.
- Pesquisa completa: É executado diariamente para atualizar o índice de RELAÇÕES Públicas.
Pode personalizar estes valores de acordo com as necessidades da sua organização. Para obter mais informações, confira
Diretrizes para definições de sincronização.