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 Problemas do GitHub Server integra dados de problemas do GitHub no Microsoft 365. Este artigo descreve os passos para implementar e personalizar o conector Problemas do GitHub Server.
Para obter informações de configuração avançadas do GitHub, veja Configurar o serviço GitHub para ingestão de conectores.
Pré-requisitos
Antes de implementar o conector Problemas 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 | 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:
- É um administrador do Microsoft 365.
- A instância do GitHub Enterprise Server está acessível através da API.
- É criada e instalada uma aplicação do GitHub para autenticação.
- 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).
- Os utilizadores que acedem a dados indexados do GitHub têm identidades de Microsoft Entra ID correspondentes para mapeamento de permissões.
Implementar o conector
Para adicionar o conector problemas 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 Problemas do GitHub Server.
Definir nome a apresentar
O nome a apresentar é utilizado para identificar referências em respostas copilot para ajudar os utilizadores a reconhecer o ficheiro ou item associado. Pode aceitar o nome a apresentar predefinido do GitHub Server Issues ou personalizar o valor para utilizar um nome a apresentar que os utilizadores na sua organização reconheçam.
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. Este URL é o domínio raiz do servidor interno do GitHub. Por exemplo: 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 implementar 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 para os quais pretende implementar o conector. Para obter mais informações, veja Implementação faseada para conectores Copilot.
Selecione Criar para implementar a ligação. O conector Copilot Problemas do GitHub Server inicia a indexação de conteúdo imediatamente.
A tabela seguinte lista os valores predefinidos que são definidos quando implementa o conector.
| Categoria | Valor padrão |
|---|---|
| Usuários | Mapeamento de identidades com base no e-mail, início de sessão ou nome do GitHub |
| Conteúdo | Filtro de intervalo de tempo definido como 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 Problemas 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
Configure as permissões de acesso para garantir que apenas os utilizadores autorizados podem ver problemas do GitHub no Copilot e no Microsoft Search.
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.
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
Filtro de conteúdo
Pode configurar um filtro de intervalo de tempo para o conector. A predefinição é 365 dias.
Gerir propriedades
Verifique os mapeamentos de propriedades nos dados de exemplo para metadados, tais como conteúdo, etiquetas, descrição e carimbos de data/hora.
Personalizar intervalos de sincronização
Pode configurar pesquisas incrementais e completas. No entanto, isso é recomendável somente em ambientes entre florestas.
- A pesquisa incremental é executada a cada 15 minutos.
- A pesquisa completa é executada diariamente.
Para obter mais informações, veja Diretrizes para definições de sincronização.