Conector microsoft Graph do Wiki do Azure DevOps
O conector microsoft Graph do Wiki do Azure DevOps permite que a sua organização indexe wikis na respetiva instância do serviço Azure DevOps. Depois de configurar o conector, os utilizadores finais podem procurar wikis de projetos e wikis de código 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 conector do Microsoft Graph do Wiki do Azure DevOps.
Importante
O conector do Microsoft Graph wiki do Azure DevOps suporta apenas o serviço cloud do Azure DevOps. Azure DevOps Server 2019, TFS 2018, TFS 2017, TFS 2015 e TFS 2013 não são suportados por este conector.
Recursos
- Indexar wikis do Azure DevOps
- Permitir que os utilizadores finais façam perguntas relacionadas com wikis de projetos e wikis de código.
- 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
- O conector indexa apenas uma organização ADO por ligação.
Pré-requisitos
Tem de ser o administrador de pesquisa do inquilino do Microsoft 365 da sua organização.
Para permitir que o conector se ligue à sua organização do Azure DevOps, tem de ativar o acesso de aplicações de terceiros através do OAuth. Veja a documentação do Azure DevOps para gerir políticas de segurança para saber mais.
Conta de Serviço: para ligar ao Azure DevOps e permitir que o Conector do Microsoft Graph atualize wikis regularmente, precisa de uma conta de serviço com as seguintes permissões concedidas.
Nome da permissão Tipo de permissão Necessário para Ver informações ao nível do projeto Permissão do projeto Pesquisar Itens de Trabalho do Azure DevOps. Esta permissão é obrigatória para os projetos que precisam de ser indexados. Importante
A conta de serviço tem de ter o nível de acesso Básico . Para saber mais sobre os níveis de acesso no Azure DevOps, leia os níveis de acesso suportados.
Introdução
1. 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.
2. Tipo de autenticação
Para autenticar e sincronizar wikis do Azure DevOps, escolha um dos dois métodos suportados:
Importante
- Microsoft Entra ID OAuth está em pré-visualização e disponível para clientes selecionados. Este é o mecanismo OAuth recomendado .
- O OAuth do Azure DevOps é o mecanismo de autenticação legado e não está a ser investido ativamente.
a. Microsoft Entra ID OAuth (Pré-visualização)
Certifique-se de que a sua Organização do ADO está ligada ao Microsoft Entra
O conector do Azure DevOps Graph indexa apenas conteúdo de uma organização do ADO ligada a Microsoft Entra do seu inquilino. Para garantir que a sua organização do ADO está ligada a Microsoft Entra conta, utilize os seguintes passos.
- Navegue para o Azure DevOps e selecione a organização necessária.
- Selecione
Organization settings. - No painel de navegação esquerdo, selecione
Microsoft Entrapor baixo do cabeçalho "Geral". - Certifique-se de que a organização está ligada à conta Microsoft Entra do seu inquilino.
Criar uma aplicação no Microsoft Entra ID
- Aceda à portal do Azure e inicie sessão com as credenciais de administrador do inquilino.
- Navegue para Microsoft Entra ID ->Manage ->Registros de aplicativo no painel de navegação e selecione Novo registo.
- Forneça um nome para a aplicação e selecione Registar.
- Anote o ID da Aplicação (cliente). Este ID é utilizado para conceder à aplicação Microsoft Entra acesso a projetos na organização do ADO.
- Abra as permissões da API no painel de navegação e selecione Adicionar uma permissão.
- Selecione Azure DevOps e, em seguida , Permissões delegadas.
- Procure as seguintes permissões e selecione Adicionar permissões.
a. Identidade (leitura)
b. Código (leitura)
c. Elegibilidades (leitura)
d. Projeto e Equipa (leitura)
e. Gráfico (leitura)
f. Gestão memberEntitlement (leitura)
g. Wiki (leitura) - Selecione Conceder consentimento do administrador para [TenantName] e confirme ao selecionar Sim.
- Verifique se as permissões estão no estado "Concedido".
- 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 O M365 Enterprise:
https://gcs.office.com/v1.0/admin/oauth/callback - Para o M365 Administração Pública:
https://gcsgcc.office.com/v1.0/admin/oauth/callback
- Para O M365 Enterprise:
- 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. - No painel de navegação, selecione Certificados e segredos em Gerir.
- 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.
- Utilize este Segredo do cliente e o ID da aplicação para configurar o conector.
Conceder à aplicação Microsoft Entra acesso a projetos na organização do ADO
Tem de fornecer à aplicação Microsoft Entra o acesso necessário aos projetos que precisam de ser indexados através dos seguintes passos:
- Navegue para o Azure DevOps e selecione a organização necessária.
- Selecione
Organization settings. - No painel de navegação esquerdo, selecione
Userspor baixo do cabeçalho "Geral". - Selecione
Add users. - Copie o ID da Aplicação (cliente) obtido da aplicação para "Utilizadores ou Principais de Serviço".
- Conceda o
Basicnível de acesso e selecione os projetos para permitir o acesso ao índice. Adicione também aoProject Readergrupo do Azure DevOps (ou equivalente) para garantir o acesso. Desselize a opção para enviar um convite por e-mail aos utilizadores.
Azure DevOps OAuth
Para ligar à instância do Azure DevOps, precisa do ID da Aplicação da organização do Azure DevOps e do segredo do cliente para a autenticação OAuth.
Registrar um aplicativo
Registe uma aplicação no Azure DevOps para que a aplicação Microsoft Search e o Microsoft 365 Copilot possam aceder à instância. Para registar a aplicação, visite a ligação para registar a aplicação. Para saber mais, veja a documentação do Azure DevOps sobre como registar uma aplicação.
A tabela seguinte fornece orientações sobre como preencher o formulário de registo de aplicações:
| Campos obrigatórios | Descrição | Valor recomendado |
|---|---|---|
| Nome da empresa | O nome da sua empresa. | Utilize um valor adequado. |
| Nome do aplicativo | Um valor exclusivo que identifica a aplicação que está a autorizar. | Microsoft Search. |
| Site da aplicação | O URL da aplicação que pede acesso à instância do Azure DevOps durante a configuração do conector. (obrigatório). | Para Microsoft 365 Enterprise: https:// gcs.office.com/, Para o Microsoft 365 Administração Pública: https:// gcsgcc.office.com/ |
| URL de chamada de retorno de autorização | Um URL de chamada de retorno necessário para o qual o servidor de autorização redireciona. | Para Microsoft 365 Enterprise: https:// gcs.office.com/v1.0/admin/oauth/callback, Para o Microsoft 365 Government: https:// gcsgcc.office.com/v1.0/admin/oauth/callback |
| Âmbitos autorizados | O âmbito de acesso da aplicação | Selecione os seguintes âmbitos: Identidade (leitura), Código (leitura), Elegibilidade (leitura), Projeto e Equipa (leitura), Gráfico (leitura), Gestão de Direitos de Membro (leitura), Wiki (leitura). |
Importante
Os âmbitos autorizados selecionados para a aplicação devem corresponder exatamente aos âmbitos listados acima. Se estiverem selecionados mais ou menos âmbitos, a autorização falhará.
Ao registar a aplicação, obtém o ID da Aplicação e o Segredo do Cliente que são utilizados para configurar o conector.
Para revogar o acesso a qualquer aplicação registada no Azure DevOps, aceda a Definições de utilizador na parte superior direita da instância do Azure DevOps. Selecione Perfil e, em seguida, selecione Autorizações na secção Segurança do painel lateral. Paire o cursor sobre uma aplicação OAuth autorizada para ver o botão Revogar no canto dos detalhes da aplicação.
3. Selecione Organização
O conector do Azure DevOps permite a indexação de uma organização por ligação. Para ligar ao serviço de DevOps do Azure, selecione a organização certa na lista de organizações acessíveis à conta de serviço.
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 wikis do Azure DevOps. Pode clicar em Criar para publicar os wikis de ligação e indexação da sua organização do Azure 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:
| Usuários | Descrição |
|---|---|
| Permissões de acesso | Apenas pessoas com acesso a conteúdos na Origem de dados. |
| Mapear Identidades | Identidades de origem de dados mapeadas com Microsoft Entra IDs. |
| Conteúdo | Descrição |
|---|---|
| Projetos de site | Todos os projetos são indexados. |
| Gerir Propriedades | Para marcar propriedades predefinidas e o respetivo esquema, veja conteúdo |
| Sincronização | Descrição |
|---|---|
| Pesquisa Incremental | Frequência: a cada 15 minutos |
| Pesquisa Completa | Frequência: Todos os Dias |
Se quiser editar qualquer um destes valores, tem de escolher a "Configuração Personalizada"
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 Wiki do Azure DevOps 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 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.
Observação
Atualizações a grupos que regem as permissões de acesso são sincronizados apenas em pesquisas completas. As pesquisas incrementais não suportam o processamento de atualizações para permissões.
Conteúdo
Escolher projetos
Neste passo, vai especificar o âmbito dos dados que pretende indexar com o conector microsoft Graph do Wiki do Azure DevOps. 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 wikis em todos os projetos na organização são indexados. Os novos projetos e wikis são indexados durante a próxima pesquisa depois de serem criados.
Se optar por indexar projetos individuais, apenas os wikis nos projetos selecionados são indexados.
Gerir Propriedades
Aqui, pode adicionar ou remover propriedades disponíveis da sua origem de dados do 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.
| Propriedade Source | Rótulo | Descrição | Esquema |
|---|---|---|---|
| Autores | Autores | Atribua um nome a todas as pessoas que participaram/colaboraram no item na origem de dados | Obter |
| CommitId | |||
| Conteúdo | Conteúdo | O corpo do conteúdo do wiki | Pesquisar |
| GitItemPath | |||
| IconUrl | IconUrl | URL do ícone que representa o wiki | Obter |
| isParentPage | |||
| LastPublishedAuthorEmail | Última modificação por | Obter | |
| LastPublishedDate | Hora da última modificação | Data e hora em que o item foi modificado pela última vez na origem de dados | Repetir |
| Organização | Obter | ||
| Caminho | |||
| Project | Obter | ||
| ProjectId | Obter | ||
| RemoteURL | url | O URL do wiki na origem de dados | Obter |
| Título | Título | O título da página wiki | Procurar, Obter |
| Versão | Obter | ||
| WikiId | Obter | ||
| WikiIdentifier | Obter | ||
| WikiType |
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 índice do conector do Graph. 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.
Configurar a página de resultados da pesquisa
Depois de publicar a ligação, tem de personalizar a página de resultados da pesquisa com verticais e tipos de resultados. Para saber mais sobre como personalizar os resultados da pesquisa, reveja como gerir verticais e tipos de resultados.
Também pode utilizar o esquema de resultados de exemplo para o conector microsoft Graph do Wiki do Azure DevOps. Basta copiar e colar o JSON do esquema de resultados para começar.
Solução de problemas
Depois de publicar a ligação, pode rever a status no separador Origens de dados no 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.