conector Microsoft 365 Copilot de Itens de Trabalho do Azure DevOps

O conector Microsoft 365 Copilot Itens de Trabalho do Azure DevOps permite que a sua organização indexe itens de trabalho na respetiva instância do serviço Azure DevOps. Depois de configurar o conector, os utilizadores finais podem procurar itens de trabalho do Azure DevOps no Microsoft Search e Microsoft 365 Copilot.

Este artigo destina-se a administradores do Microsoft 365 ou a qualquer pessoa que configure, execute e monitorize um Azure conector Copilot de Itens de Trabalho do DevOps.

Recursos

• Indexar Itens de Trabalho do Azure DevOps
• Permitir que os utilizadores finais façam perguntas relacionadas com itens de trabalho.
• Utilize a Pesquisa Semântica no Copilot para permitir que os utilizadores encontrem conteúdos relevantes com base em palavras-chave, preferências pessoais e ligações sociais.

Limitações

• Indexa apenas uma organização ADO por ligação.

Filtros de dados personalizados

O conector Azure Itens de Trabalho do DevOps inclui os seguintes filtros de dados personalizados para a Pesquisa Copilot:

• Caminho da Área
• Atribuído a

Pré-requisitos

• Tem de ser o administrador de pesquisa do inquilino do Microsoft 365 da sua organização.

• O conector utiliza a conta do Administração M365 com sessão iniciada como conta de serviço de pesquisa. Para ligar ao Azure DevOps e permitir que o conector Copilot atualize os itens de trabalho regularmente, tem de conceder à conta de Administração M365 as seguintes permissões.

  Nome da permissão	Tipo de permissão	Necessário para
  Ver informações ao nível do projeto	Permissão do projeto	A pesquisar Azure Itens de Trabalho do DevOps. Esta permissão é obrigatória para os projetos que precisam de ser indexados.
  Ver análise	Permissão do projeto	A pesquisar Azure Itens de Trabalho do DevOps. Esta permissão é obrigatória para os projetos que precisam de ser indexados.
  Ver itens de trabalho neste nó	Caminho da área	Pesquisar Itens de Trabalho num caminho de área. Esta permissão é opcional. Apenas esses caminhos de área são pesquisados para os quais a conta de utilizador tem permissão.

Introdução

Escolher nome a apresentar

Um nome a apresentar é utilizado para identificar cada citação em Copilot, ajudando os utilizadores a reconhecer facilmente o ficheiro ou item associado. O nome a apresentar também significa conteúdo fidedigno. O nome a apresentar também é utilizado como um filtro de origem de conteúdo. Está presente um valor predefinido para este campo, mas pode personalizá-lo para um nome que os utilizadores na sua organização reconhecem.

Adicionar a Organização do ADO

O conector Copilot Azure DevOps Work Items permite a indexação de uma organização por ligação. Para ligar ao Azure serviço DevOps, forneça o nome da organização a indexar.

Fornecer tipo de autenticação

Tem de seguir alguns passos para autenticar e sincronizar itens de trabalho do Azure DevOps.

Microsoft Entra ID OAuth

Certifique-se de que a sua Organização do ADO está ligada ao Microsoft Entra

O conector Copilot Azure Itens de Trabalho do DevOps indexa apenas conteúdo de uma organização ADO ligada a Microsoft Entra do seu inquilino. Para garantir que a sua organização do ADO está ligada a uma conta Microsoft Entra, utilize os seguintes passos.

1. Navegue para Azure DevOps e selecione a organização necessária.
2. Selecione Organization settings.
3. No painel de navegação esquerdo, selecione Microsoft Entra por baixo do cabeçalho "Geral".
4. Certifique-se de que a organização está ligada à conta Microsoft Entra do seu inquilino.

Criar uma aplicação no Microsoft Entra ID

1. Aceda à portal do Azure e inicie sessão com as credenciais de administrador do inquilino.
2. Navegue para Microsoft Entra ID ->Identity ->Applications ->Registros de aplicativo a partir do painel de navegação e selecione Novo registo.
3. Forneça um nome para a aplicação e selecione Registar.
4. Anote o ID da Aplicação (cliente). Este ID é utilizado para conceder à aplicação Microsoft Entra acesso a projetos na organização do ADO.
5. Abra as permissões da API no painel de navegação e selecione Adicionar uma permissão.
6. Selecione Azure DevOps e, em seguida, Permissões delegadas.
7. Procure as seguintes permissões em vso e selecione Adicionar permissões.
   a. vso.analytics - Análise (leitura)
   b. vso.graph - Grafo (leitura)
   c. vso.identity - Identidade (leitura)
   d. vso.project - Projeto e equipa (leitura)
   e. vso.variablegroups_read - Grupos de Variáveis (leitura)
   f. vso.work - Itens de trabalho (leitura)
   
8. Selecione Conceder consentimento do administrador para [TenantName] e confirme ao selecionar Sim.
9. Verifique se as permissões estão no estado "Concedido".
10. Abra a Autenticação a partir do painel de navegação. Selecione e selecione Add a platformWeb. Adicione um dos seguintes URIs em "URIs de Redirecionamento":
    • Para M365 Enterprise: https:// gcs.office.com/v1.0/admin/oauth/callback
    • Para o M365 Government: https:// gcsgcc.office.com/v1.0/admin/oauth/callback
11. Em Concessão implícita e fluxos híbridos, marcar a opção para ID tokens (used for implicit and hybrid flows) e clique em Configurar.
12. No painel de navegação, selecione Certificados e segredos em Gerir.
13. Selecione Novo Segredo do cliente e selecione um período de expiração para o segredo. Copie o segredo gerado (Valor) e guarde-o porque não é apresentado novamente.
14. Utilize este Segredo do cliente e o ID da aplicação para configurar o conector.

Autenticar a aplicação Microsoft Entra com uma conta de pesquisa

A sua aplicação Entra deve ser autenticada automaticamente com a conta de Administração com sessão iniciada devido ao início de sessão único. Microsoft Entra emite um token de acesso à aplicação. Este token de acesso contém informações sobre o utilizador e as permissões delegadas que foram concedidas. A aplicação utiliza o token de acesso para fazer pedidos ao Azure DevOps. A aplicação só pode aceder a dados e executar ações que o utilizador com sessão iniciada também está autorizado a fazer.

4. Implementar para público-alvo limitado

Implemente esta ligação numa base de utilizadores limitada se pretender validá-la no Copilot e noutras superfícies de Pesquisa antes de expandir a implementação para uma audiência mais ampla. Para saber mais sobre a implementação limitada, veja Implementação faseada.

Neste momento, está pronto para criar a ligação para Azure itens de trabalho do DevOps. Pode clicar em Criar para publicar a ligação e indexar itens de trabalho a partir da sua Azure organização do DevOps.

Para outras definições, como Permissões de Acesso, Regras de Inclusão de Dados, Esquema, Frequência de pesquisa, etc., temos predefinições com base no que funciona melhor com os dados do ADO. Pode ver os valores predefinidos abaixo:

Configuração Personalizada

A configuração personalizada destina-se aos administradores que pretendem editar os valores predefinidos das definições listadas na tabela acima. Depois de clicar na opção "Configuração Personalizada", verá mais três separadores : Utilizadores, Conteúdo e Sincronização.

Usuários

Permissões de acesso

O conector Azure DevOps Work Items suporta permissões de pesquisa visíveis para Todos ou Apenas pessoas com acesso a esta origem de dados. Se escolher Todos, os dados indexados são apresentados nos resultados da pesquisa para todos os utilizadores. Se escolher Apenas 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 à mesma.

Conteúdo

Escolher projetos

Neste passo, vai especificar o âmbito dos dados que pretende indexar com o conector Copilot Azure DevOps Work Items. Em seguida, pode escolher a ligação para indexar toda a organização ou projetos específicos na organização selecionada.

Se optar por indexar toda a organização, os itens de trabalho em todos os projetos na organização são indexados. Os novos projetos e itens de trabalho são indexados durante a próxima pesquisa depois de serem criados.

Se optar por indexar projetos individuais, apenas os itens de trabalho nos projetos selecionados são indexados.

Gerir Propriedades

Aqui, pode adicionar ou remover propriedades disponíveis da sua origem de dados Azure DevOps, atribuir um esquema à propriedade (definir se uma propriedade é pesquisável, pesquisável, recuperável ou refinável), alterar a etiqueta semântica e adicionar um alias à propriedade. As propriedades selecionadas por predefinição estão listadas abaixo.

Pré-visualizar dados

Utilize o botão de resultados da pré-visualização para verificar os valores de exemplo das propriedades selecionadas.

Sincronização

O intervalo de atualização determina a frequência com que os dados são sincronizados entre a origem de dados e o Azure índice do conector Copilot de Itens de Trabalho do DevOps. Existem dois tipos de intervalos de atualização: pesquisa completa e pesquisa incremental. Para obter mais informações, veja Definições de atualização.

Se quiser, pode alterar os valores predefinidos do intervalo de atualização a partir daqui.

Solução de problemas

Depois de publicar a ligação, pode rever a status na secção Conectores do centro de administração. Para saber como fazer atualizações e eliminações, consulte Gerir o conector. Pode encontrar passos de resolução de problemas frequentemente vistos aqui.

Se tiver problemas ou quiser fornecer comentários, contacte o Microsoft Graph | Suporte.