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 gitHub Cloud Pull Requests Microsoft 365 Copilot permite à sua organização indexar pedidos Pull armazenados em repositórios do GitHub em experiências de Microsoft 365 Copilot e Microsoft Search. Este artigo descreve os passos para implementar e personalizar o conector. Para obter informações gerais sobre a implementação do conector Copilot, veja Configurar conectores Copilot no Centro de administração do Microsoft 365.
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 GitHub Cloud Pull Requests, 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 |
|---|---|
| Identificar o nome da organização do GitHub | Administrador do GitHub |
| Garantir o acesso da API à instância do GitHub de destino | Administrador do GitHub |
| Implementar o conector | 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 sua instância do GitHub está acessível através da API.
- É criado um Aplicativo GitHub e configurado para autenticação.
- A conta utilizada para autenticação tem acesso aos repositórios e pedidos Pull a indexar.
- 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 GitHub Cloud Pull Requests 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 Pedidos Pull do GitHub Cloud.
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. O nome a apresentar também significa conteúdo fidedigno e é utilizado como um filtro de origem de conteúdo.
Pode aceitar o nome a apresentar predefinido dos Pedidos Pull do GitHub Cloud ou personalizar o valor para utilizar um nome a apresentar que os utilizadores na sua organização reconheçam.
Para obter mais informações sobre os nomes a apresentar e descrições do conector, veja Melhorar a deteção do Copilot com Microsoft 365 Copilot conteúdos dos conectores.
Escolher tipo de autenticação
O conector suporta os seguintes tipos de autenticação:
OAuth (Recomendado): para utilizar a autenticação OAuth:
- Instale a aplicação GitHub Problemas do GitHub na organização do GitHub.
- Escolha um nome a apresentar que ajude os utilizadores a reconhecer a ligação.
- Introduza o nome da sua organização.
- Selecione Autorizar para iniciar sessão e conceder acesso.
Observação
Este método de autenticação está atualmente em pré-visualização.
Aplicação GitHub personalizada (em nome do utilizador): introduza o ID de cliente e o segredo do cliente a partir da aplicação GitHub e autorize o acesso.
Aplicação GitHub personalizada (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.
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 Pedidos Pull do GitHub Cloud começa imediatamente a indexar conteúdo.
A tabela seguinte lista os valores predefinidos que estão definidos.
| Categoria | Valor padrão |
|---|---|
| Usuários | Mapeamento de identidades com base no e-mail do GitHub |
| Conteúdo | Metadados de pedido Pull (título, descrição, etiquetas, carimbos de data/hora) |
| 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 Cloud. 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 se os dados indexados estão visíveis para:
- Apenas pessoas com acesso a esta origem de dados (predefinição)
- Todos
Se escolher Apenas as pessoas com acesso a esta origem de dados, os dados indexados são apresentados nos resultados da pesquisa para os utilizadores que têm acesso aos mesmos. Se escolher Todos, os dados indexados são apresentados nos resultados da pesquisa para todos os utilizadores.
Identidades de mapeamento
Para garantir a imposição de permissão correta, mapeie as identidades de utilizador do GitHub para Microsoft Entra ID. As opções são as seguintes:
- 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]+
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 Bring Your Own Key (BYOK) em vez de Utilizadores Geridos pela Empresa (EMU), cada utilizador tem de ativar a permissão para partilhar o campo de identidade necessário nas respetivas definições de conta do GitHub. Este passo garante um mapeamento de identidade adequado entre o GitHub e o diretório da sua organização.
Personalizar definições de conteúdo
No separador Conteúdo , pode verificar os mapeamentos de propriedades nos dados de exemplo de metadados, tais como conteúdo, etiquetas, descrição e carimbos de data/hora.
Filtro de intervalo de tempo
Pode configurar um filtro de intervalo de tempo. A predefinição é 365 dias.
Gerir propriedades
Pode adicionar ou remover propriedades, atribuir atributos de esquema e definir etiquetas semânticas. As seguintes propriedades estão indexadas por predefinição.
| Propriedade | Etiqueta semântica | Descrição | Atributos de esquema |
|---|---|---|---|
| title | Título | Título do pedido Pull | Pesquisável |
| description | Conteúdo | Descrição do pedido Pull | Pesquisável |
| etiquetas | Marcações | Etiquetas aplicadas ao pedido Pull | Pesquisável |
| createdDate | Criado | Data em que o pedido Pull foi criado | Pesquisável, Ordenável |
Personalizar intervalos de sincronização
O intervalo de atualização determina a frequência com que os seus dados são sincronizados. Pode personalizar os seguintes valores predefinidos:
- Pesquisa incremental: a cada 15 minutos
- Pesquisa completa: Diariamente
Para obter mais informações, veja Diretrizes para definições de sincronização.
Observação
O suporte do Webhook está agora disponível em pré-visualização. Certifique-se de que define as permissões de Webhooks (Leitura e Escrita) ao nível do Repositório e da Organização. Os Webhooks permitem-lhe tirar partido da automatização melhorada e das atualizações em tempo real para garantir uma experiência de integração mais integrada e reativa.