Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O conector de Conhecimento do GitHub Server integra os conhecimentos do GitHub Enterprise no Microsoft 365, permitindo que o Copilot e o Microsoft Search visualizem páginas wiki relevantes, ficheiros de markdown e blogues diretamente em aplicações como o Teams, Outlook e SharePoint. Este artigo descreve os passos para implementar e personalizar o conector.
Para obter informações de configuração do GitHub, veja Configurar o serviço GitHub para ingestão de conectores.
Pré-requisitos
Antes de implementar o conector de Conhecimento do GitHub Server, certifique-se de que o ambiente do GitHub está configurado na sua organização. A tabela seguinte resume os passos para configurar o ambiente do GitHub e implementar o conector:
| Tarefa | Função |
|---|---|
| Configurar o ambiente do GitHub | 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:
- É um administrador do Microsoft 365.
- A instância do GitHub Enterprise está acessível através da API.
- É criada e instalada uma aplicação do GitHub com as permissões necessárias.
- A conta de utilizador utilizada para autenticação tem acesso aos repositórios e aos conhecimentos a indexar.
- Os utilizadores que acedem a dados indexados do GitHub têm identidades de Microsoft Entra ID correspondentes para mapeamento de permissões.
- O Agente do Conector do Microsoft Graph está instalado num dispositivo com acesso à instância do GitHub (versão 3.1.11.0 ou posterior).
Implementar o conector
Para adicionar o conector de Conhecimento 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, selecione Conhecimento do GitHub Server.
Definir nome a apresentar
O nome a apresentar identifica referências em respostas copilot e significa conteúdo fidedigno. Pode aceitar o nome a apresentar do GitHub Server Knowledge predefinido ou personalizá-lo para um nome que os utilizadores na sua organização reconheçam.
Definir URL da instância
Introduza o URL da instância do seu servidor GitHub Enterprise. Normalmente, este URL é o seguinte formato:
https://github.<your-domain>.com
Escolher tipo de autenticação
O conector suporta os seguintes tipos de autenticação:
- Aplicação GitHub (em nome do utilizador): recomendada para a maioria dos cenários. Introduza o ID de cliente e o segredo do cliente a partir da aplicação GitHub e autorize o acesso.
- Aplicação GitHub (instalação): utilize uma chave privada gerada a partir da sua aplicação GitHub. Introduza o ID de cliente e o nome da organização e carregue a chave privada. Tenha em atenção que este tipo de autenticação está atualmente em pré-visualização. Para utilizar este tipo de autenticação, contacte o suporte da Microsoft.
Para obter informações sobre como criar uma aplicação do GitHub, veja Utilizar uma aplicação gitHub personalizada para autenticação.
Implementar para uma audiência limitada
Implemente esta ligação numa base de utilizadores limitada se pretender validá-la no Copilot e no Microsoft Search antes de expandir a implementação. Para saber mais, veja Implementação faseada para conectores Copilot.
Selecione Criar para implementar a ligação. O conector de Conhecimento do GitHub Server começa imediatamente a indexar conteúdo.
Depois de criar a ligação, pode rever a status na secção Conectores do Centro de administração do Microsoft 365.
A tabela seguinte lista os valores predefinidos que são definidos quando implementa o conector.
| Categoria | Valor padrão |
|---|---|
| Usuários | Permissões de acesso definidas como Apenas pessoas com acesso a esta origem de dados. |
| Conteúdo | Indexar ficheiros markdown e documentação de texto de repositórios selecionados. |
| Sincronização | Pesquisa incremental a cada 15 minutos; pesquisa completa diariamente. |
Para personalizar estes valores, selecione Configuração personalizada. Pode editar permissões de utilizador, gerir mapeamentos de propriedades e ajustar intervalos de sincronização.
Personalizar definições (opcional)
Pode personalizar os valores predefinidos para as definições do conector de Conhecimento 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
Escolha entre:
- Apenas pessoas com acesso a esta origem de dados (predefinição)
- Todos
Mapeamento de identidade
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.
Se o administrador da organização definir permissões de membro predefinidas para restringir o acesso ao repositório, o conector respeita esta definição. Os utilizadores não podem ver os repositórios da organização, a menos que sejam explicitamente adicionados como colaboradores.
Para empresas que utilizam o modelo BYOU (em vez de Utilizadores Geridos pela Empresa), cada utilizador tem de ativar a permissão para partilhar o campo de identidade de utilizador específico necessário para mapear nas definições da conta do GitHub para permitir o mapeamento de identidades.
Personalizar definições de conteúdo
Escolha os repositórios e tipos de ficheiro (ficheiros markdown e documentação de texto) que pretende tornar pesquisáveis.
Gerir propriedades
Pode adicionar ou remover propriedades disponíveis da origem de dados do GitHub, atribuir um esquema à propriedade (definir se uma propriedade é pesquisável, queryable, recuperável ou refinável), alterar a etiqueta semântica e adicionar um alias à propriedade.
Intervalos de sincronização
O intervalo de atualização determina a frequência com que os dados são sincronizados entre a origem de dados e o índice do conector. Seguem-se os valores predefinidos:
- Pesquisa incremental: a cada 15 minutos
- Pesquisa completa: Diariamente
Pode alterar estas predefinições no separador Sincronizar . Para obter mais informações, veja Diretrizes para definições de sincronização.