Compartilhar via

Conector de Microsoft 365 Copilot de Pedidos Pull do Bitbucket (pré-visualização)

O conector de Microsoft 365 Copilot de Pedidos Pull do Bitbucket permite à sua organização indexar pedidos Pull e documentação (ficheiros .txt e .md) armazenados no Bitbucket. Depois de configurar o conector e indexar o conteúdo do Bitbucket, os utilizadores podem procurar e obter informações através do Microsoft Search e Microsoft 365 Copilot.

Este artigo destina-se a administradores do Microsoft 365 ou a qualquer pessoa que configure, execute ou monitorize o conector Bitbucket Copilot.

Recursos

  • Indexar repositórios do Bitbucket, pedidos Pull e documentação.
  • Ative o Microsoft Search e o Microsoft 365 Copilot para obter dados do Bitbucket de forma eficiente.
  • Mantenha as ACLs do Bitbucket e as permissões de utilizador.
  • Permitir que os administradores personalizem as preferências de indexação e frequência de pesquisa.

Limitações

  • O conector não suporta a indexação de pipelines CI/CD do Bitbucket para além status indexação.
  • Apenas são indexados repositórios, pedidos Pull, ficheiros .md e .txt.
  • Atualmente, as instâncias do Bitbucket autoalojadas/no local não são suportadas.
  • O conector pode deixar o campo LastModifiedBy em branco nos casos em que as alterações do Git não são mapeadas para uma conta do Bitbucket. Isto ocorre quando uma configuração manual que liga as alterações do Git às contas de utilizador do Bitbucket não é concluída antes de uma pesquisa incremental.

Pré-requisitos

  1. A sua instância do Bitbucket está acessível através da API.
  2. A conta de utilizador utilizada para autenticação tem acesso aos repositórios, pedidos Pull e ficheiros de conhecimento a indexar.
  3. Os utilizadores que acedem a dados do Bitbucket indexados têm identidades de Microsoft Entra ID correspondentes para mapeamento de permissões.
  4. Configurar um consumidor de OAuth no Bitbucket
    1. Aceda à página da área de trabalho no Bitbucket.
    2. Clique no ícone de engrenagem no canto superior direito e selecione Definições da área de trabalho.
    3. No painel de navegação esquerdo, selecione Consumidores OAuth localizados na secção Fluxos de Trabalho.
    4. Clique em Adicionar consumidor e preencha de acordo com os seguintes URLs de redirecionamento:
    • Para Microsoft 365 Enterprise, utilizehttps://gcs.office.com/v1.0/admin/oauth/callback
    • Para o Microsoft 365 Administração Pública, utilize https://gcsgcc.office.com/v1.0/admin/oauth/callback
    1. Ative a chave para ter as seguintes permissões configuradas para ler problemas:
    • Conta
    • Repositórios
    • Pedidos Pull
    1. Guardar a configuração e copiar os valores da chave e do segredo

Recomendamos que utilize contas de utilizador separadas para a autenticação OAuth com cada ligação, uma vez que o limite de taxa do Bitbucket é calculado individualmente por utilizador.

Introdução

Escolher nome a apresentar

Escolha um nome a apresentar que ajude os utilizadores a reconhecer pedidos de intercalação ou documentação numa resposta copilot.

URL da instância do Bitbucket

Introduza o URL da instância do Bitbucket (por exemplo, https://bitbucket.org/testinstance).

Tipo de autenticação

  1. Introduza o ID de Cliente com a chave do consumidor do OAuth do Bitbucket e o Segredo do Cliente com o segredo de consumidor OAuth correspondente.
  2. Selecione Autorizar para iniciar sessão e conceder acesso.
  3. Clique em Autorizar para iniciar sessão e conceder as permissões de acesso necessárias.

Implementar para público-alvo limitado

Antes de implementar o conector, teste a ligação com uma base de utilizadores limitada no Copilot e no Microsoft Search.

Configuração personalizada

Na configuração personalizada, pode editar qualquer um dos valores predefinidos para utilizadores, conteúdos e sincronização.

Usuários

Mapeamento de identidade

Por predefinição, devido à limitação da API do Bitbucket, o conector mapeia e-mails no Microsoft Entra ID através de nomes públicos do Bitbucket. Se este mapeamento não estiver alinhado com a configuração, personalize o mapeamento de identidades.

Para garantir a imposição de permissão correta, mapeie as identidades de utilizador do Bitbucket para Microsoft Entra ID. As opções são as seguintes:

  • Nome completo: Corresponde aos nomes completos do Bitbucket para Microsoft Entra ID propriedades do utilizador.
  • Nome público: Mapeia nomes públicos do Bitbucket com Microsoft Entra ID propriedades de utilizador.

Se o mapeamento direto falhar, utilize expressões regulares (regex) para a transformação. Por exemplo:

  1. Selecione Correio como a propriedade de utilizador Microsoft Entra.
  2. Selecione Nome Completo como a propriedade de utilizador não Microsoft Entra.
  3. Utilize uma expressão regular, como ([^@]+) para capturar uma sequência de um ou mais carateres antes do @ símbolo.
  4. Crie uma fórmula para concluir o mapeamento, como {0}@<your-domain>.

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.

Sincronização

Pode configurar pesquisas incrementais e completas . Seguem-se os valores predefinidos:

  • A pesquisa incremental é executada a cada 15 minutos por predefinição.
  • A pesquisa completa é executada diariamente para garantir a indexação atualizada.

Próximas etapas

  • Reveja o status de ligação no Centro de Administração Microsoft 365.

Se tiver problemas ou quiser fornecer comentários, contacte o suporte do Microsoft Graph.

  • Last updated on