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.
Os índices do conector de Itens de Trabalho do Azure DevOps funcionam em itens de trabalho, como histórias de utilizadores, tarefas, erros e funcionalidades, desde Azure DevOps Services ao Microsoft 365 para que os utilizadores possam procurar e obter dados de controlo de trabalho diretamente no Copilot e no Microsoft Search. Este artigo fornece informações de resolução de problemas comuns que poderá encontrar ao implementar ou gerir o conector.
resolução de problemas do conector Itens de Trabalho do Azure DevOps
A tabela seguinte lista erros comuns e passos de resolução de problemas recomendados.
| Problema | Descrição | Etapas para a solução de problemas |
|---|---|---|
| A conta de pesquisa não tem as permissões necessárias | O conector baseia-se na conta de administrador (conta de pesquisa) do Microsoft 365 com sessão iniciada para consultar Azure DevOps com o OAuth delegado. Se esta conta não tiver permissões, a indexação falhará. | - Confirme que a conta de pesquisa tem acesso Básico no Azure DevOps. - Confirme que a conta foi adicionada a todos os projetos que têm de ser indexados. - Adicione a conta a Administradores de Projetos (recomendado) ou Leitores de Projetos (mínimo). - Verifique se a conta tem Ver informações ao nível do projeto e Ver permissões de análise para cada projeto. |
| Os itens de trabalho não aparecem no Copilot ou na Pesquisa | Apenas os itens de trabalho acessíveis à conta de pesquisa podem ser indexados. Permissões em falta ou caminhos de área restritos impedem a ingestão. | - Valide se a conta de pesquisa tem a permissão Ver itens de trabalho neste nó para os Caminhos de Área relevantes. - Confirme que a conta pode abrir os itens de trabalho diretamente no Azure DevOps. - Voltar a verificar a associação ao projeto e à equipa. |
| Falha na autenticação OAuth | O acesso delegado baseado em OAuth requer que a aplicação Microsoft Entra seja configurada corretamente. | - Confirme que todas as permissões delegadas necessárias são concedidas:vso.analytics, vso.graph, vso.identity, vso.project, vso.variablegroups_read, vso.work.- Verifique se o URI de redirecionamento corresponde ao seu ambiente na cloud: - M365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback- M365 Administração Pública: https://gcsgcc.office.com/v1.0/admin/oauth/callback- Certifique-se de que os tokens de ID estão ativados em fluxos implícitos/híbridos. - Confirme que o segredo do cliente é válido e não expirou. |
| O conector não consegue ler itens de determinados projetos | O conector pesquisa apenas o conteúdo a que a conta de pesquisa pode aceder. Se um projeto estiver em falta, as permissões são normalmente a causa. | - Certifique-se de que a conta de pesquisa é adicionada a cada projeto. - Se utilizar privilégios mínimos, confirme que a conta tem, pelo menos, a associação leitores do Project . - Reveja as permissões ao nível do projeto relativamente a incompatibilidades ou restrições herdadas. |
| A pesquisa incremental está lenta ou incompleta | O desempenho da pesquisa incremental depende Azure configuração do webhook de DevOps. | - Adicione a conta de pesquisa aos Administradores do Project para permitir a criação de webhooks. - Confirme que a criação de webhooks é permitida na sua organização Azure DevOps. - Valide se os webhooks estão a ser acionados ao verificar os hooks de serviço ao nível do projeto. |
| Erros de acesso negado durante a ingestão | Azure DevOps restringe o acesso por tipo de permissão e caminho da área. | - Confirme se a conta de pesquisa pode abrir o item afetado no Azure DevOps. - Voltar a verificar as permissões do Caminho da Área. - Valide se a identidade correta está a ser mapeada através de Microsoft Entra ID. |
| O conector falha imediatamente após a configuração | A configuração incorreta da aplicação Entra ou o nome da organização incorreto pode causar falhas precoces. | - Certifique-se de que apenas o nome da organização (e não o URL completo) está introduzido. - Valide o ID da Aplicação (cliente) e o segredo do cliente. - Confirme se o URI de redirecionamento da cloud correto está definido. |