Implementar o conector Microsoft 365 Copilot Problemas da Cloud do GitHub

Os Problemas da Cloud do GitHub Microsoft 365 Copilot conector permitem à sua organização indexar problemas do GitHub para que possam ser apresentados nas experiências Microsoft 365 Copilot e Microsoft Search. Este artigo descreve os passos para implementar e personalizar o conector 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 Problemas 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.

Antes de implementar o conector Problemas da Cloud do GitHub, certifique-se de que:

• É um administrador do Microsoft 365.
• O seu ambiente do GitHub está configurado e acessível através da API.
• É criada uma Aplicativo GitHub para autenticação com as permissões necessárias.
• 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), as contas têm sessão iniciada antes da configuração. O fluxo de autenticação do GitHub não suporta SSO durante a configuração.

Implementar o conector

Para adicionar o conector Problemas da Cloud do GitHub à sua organização:

1. Na Centro de administração do Microsoft 365, no painel esquerdo, selecioneConectoresCopilot>.
2. Aceda ao separador Conectores e, no painel esquerdo, selecione Galeria.
3. Na lista de conectores disponíveis, selecione Problemas na Cloud do GitHub.

Definir nome a apresentar

O nome a apresentar identifica referências em respostas copilot e ajuda os utilizadores a reconhecer a origem de conteúdo associada. Pode aceitar o nome a apresentar predefinido do GitHub Cloud Issues ou personalizá-lo.

Para obter mais informações, veja Enhance Copilot discovery of connector content (Melhorar a deteção copilot de conteúdo do conector).

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 Copilot.

Selecione Criar para implementar a ligação. O conector Problemas da Cloud do GitHub começa a indexar conteúdos imediatamente.

A tabela seguinte lista os valores predefinidos que são definidos quando implementa o conector.

Para personalizar estes valores, selecione Configuração personalizada. Para obter mais informações, veja Personalizar definições.

Depois de criar a ligação, reveja o 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 na 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

Especifique que utilizadores e grupos têm acesso a conteúdos indexados 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.

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 conteúdo

Pode configurar um filtro de intervalo de tempo para o conector. A predefinição é 365 dias.

Gerir propriedades

Pode adicionar ou remover propriedades disponíveis da origem de dados, atribuir um esquema à propriedade (pesquisável, queificável, recuperável ou refinável), alterar a etiqueta semântica e adicionar um alias à propriedade. O conector indexa as seguintes propriedades por predefinição.

Personalizar intervalos de sincronização

Configure os intervalos de sincronização de pesquisa completa e incremental. Seguem-se os valores predefinidos:

• Pesquisa incremental: A cada 15 minutos
• Pesquisa completa: Diariamente

Pode ajustar estes intervalos para satisfazer as necessidades da sua organização. Para obter mais informações, veja Diretrizes para definições de sincronização.

Conteúdo relacionado

• Descrição geral do conector problemas do GitHub Cloud
• Resolver problemas com o conector Problemas da Cloud do GitHub
• Configurar conectores Copilot no Centro de administração do Microsoft 365