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 da Cloud do GitHub permite que as organizações indexem ficheiros de markdown e texto de repositórios do GitHub para 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 de Conhecimento da Cloud do GitHub, certifique-se de que o ambiente do GitHub Cloud está configurado na sua organização. A tabela seguinte resume os passos para configurar o ambiente e implementar o conector.
| Tarefa | Função |
|---|---|
| Configurar o ambiente | 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 de Conhecimento da Cloud do GitHub, certifique-se de que:
- É um administrador do Microsoft 365 para a sua organização.
- A sua instância do GitHub está acessível através da API.
- É criado um Aplicativo GitHub e configurado para autenticação.
- Os utilizadores que acedem a dados indexados do GitHub têm identidades de Microsoft Entra ID correspondentes para mapeamento de permissões.
- Para os utilizadores geridos pela empresa que se autenticam através do início de sessão único (SSO), a conta tem sessão iniciada antes da configuração. O fluxo de autenticação do GitHub não suporta SSO.
Implementar o conector
Para adicionar o conector de Conhecimento da Cloud do GitHub à 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 GitHub Cloud Knowledge.
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 Cloud Knowledge predefinido ou escolher um nome 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 organização do GitHub que o conector irá indexar. Por exemplo:
https://github.com/<organization-name>
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 obter mais informações, veja Implementação faseada para conectores Microsoft 365 Copilot.
Selecione Criar para implementar a ligação. O conector de Conhecimento da Cloud do GitHub começa imediatamente a indexar conteúdos.
A tabela seguinte lista os valores predefinidos que estão definidos.
| Categoria | Valor padrão |
|---|---|
| Usuários | Apenas pessoas com acesso a esta origem de dados |
| Conteúdo | Markdown e ficheiros 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. 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 de Conhecimento da Cloud do GitHub. 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 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 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.
Escolha os repositórios e tipos de ficheiro (ficheiros Markdown, documentos de texto) que pretende tornar pesquisáveis.
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 |
|---|---|---|---|
| Nome do arquivo | Título | Nome do ficheiro | Pesquisável, Recuperável |
| Repositório | Source | Nome do repositório do GitHub | Pesquisável, Queryable |
| Conteúdo | Corpo | Markdown ou conteúdo do ficheiro de texto | Pesquisável, Recuperável |
Personalizar intervalos de sincronização
O intervalo de atualização determina a frequência com que os seus dados são sincronizados. Valores predefinidos:
- Pesquisa incremental: a cada 15 minutos
- Pesquisa completa: Diariamente
Pode alterar estes valores conforme necessário. 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.