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.
Conecte seus wikis do Azure DevOps para que o agente faça referência aos runbooks e procedimentos da sua equipe durante as investigações. O conteúdo wiki é indexado e pesquisável e seu agente localiza a página certa automaticamente. O conector dá suporte tanto à autenticação por identidade gerenciada quanto por token de acesso pessoal (PAT).
O problema: o conhecimento não é utilizado durante incidentes
Sua equipe investe centenas de horas escrevendo runbooks, guias de solução de problemas e procedimentos operacionais em wikis do Azure DevOps. Mas quando um incidente acontece às 3 da manhã, ninguém procura na wiki. O engenheiro de plantão abre uma dúzia de guias, verifica o Azure Monitor e resolve de memória ou escalona. A documentação escrita para exatamente essa situação fica intocada.
O conhecimento existe. O problema é o acesso - não à wiki, mas à página correta no momento certo, no contexto do problema atual.
Como o Agente SRE resolve esse problema
Conecte seu wiki do Azure DevOps uma vez e seu agente o pesquisa automaticamente durante cada investigação:
- Indexa suas páginas wiki – Rastreia e indexa todas as páginas do wiki do Azure DevOps.
- Pesquisa contextualmente: quando você faz uma pergunta ou um incidente é acionado, seu agente pesquisa seu wiki junto com outras fontes de conhecimento.
- Páginas específicas de referências : as respostas incluem citações vinculando de volta à página wiki original.
- Pega as atualizações: reconecte ou atualize o conector para indexar novamente o conteúdo da wiki atualizado.
Antes e depois
| Scenario | Antes | Após |
|---|---|---|
| Resposta a incidentes | A pessoa de plantão não consulta a wiki durante incidentes | Seu agente pesquisa wiki automaticamente para cada consulta |
| Acesso ao conhecimento | O conhecimento no wiki não é utilizado às 3 da manhã | Os runbooks são exibidos exatamente quando necessário |
| Integração | Os novos membros da equipe não sabem qual página wiki verificar | Seu agente localiza a página relevante independentemente da experiência |
| Qualidade da pesquisa | A pesquisa wiki requer saber as palavras-chave certas | Seu agente entende o contexto e localiza o conteúdo relacionado |
O que torna isso diferente
Ao contrário dos uploads de arquivos estáticos, o wiki permanece ativo. Quando sua equipe atualiza um runbook no Azure DevOps, seu agente pega as alterações. Você não precisa carregar arquivos novamente.
Ao contrário da pesquisa wiki de texto completo, seu agente entende o contexto. Não corresponde às palavras-chave. Em vez disso, ele correlaciona sua pergunta com conteúdo wiki relevante, combinando-a com telemetria dinâmica do Azure Monitor, logs do Kusto e outras fontes conectadas.
Ao contrário do acesso wiki externo baseado em MCP, o conector de Documentação interno não requer nenhuma configuração de servidor externo. Você fornece a URL wiki e a autenticação, e seu agente manipula o restante.
Como funciona
O conector de Documentação (tipo de serviço Azure DevOps) rastreia suas páginas wiki e as indexa para pesquisa. Quando o agente recebe uma consulta, ele pesquisa o conteúdo indexado junto com outras fontes de conhecimento, como arquivos carregados, páginas da Web e repositórios conectados.
O conector dá suporte a dois tipos de conteúdo do Azure DevOps:
| Tipo de conteúdo | Padrão de URL | O que é indexado |
|---|---|---|
| Wiki | https://dev.azure.com/{org}/{project}/_wiki/wikis/{wiki-name} |
Todas as páginas wiki (Markdown) |
| Wiki (escopo) | .../_wiki/wikis/{wiki-name}/{pageId}/Page-Name |
Página específica e suas subpáginas |
| Repositório Git | https://dev.azure.com/{org}/{project}/_git/{repo} |
Arquivos de texto (Markdown, documentos, código) |
| Wiki herdado | https://{org}.visualstudio.com/{project}/_wiki/wikis/{wiki-name} |
O mesmo que acima (formato de URL herdado) |
Observação
Quando você inclui uma ID de página na URL wiki, o conector indexa somente essa página e suas subpáginas. Essa abordagem é útil para direcionar seções específicas, como /Operations ou /Runbooks sem indexar todo o wiki.
Como funciona a sincronização de documentação
Uma vez conectado, o agente mantém o índice de documentação atualizado automaticamente. Você não precisa recarregar manualmente nada.
| Aspecto | Detalhes |
|---|---|
| Frequência de sincronização | Rastreamentos automáticos a cada 24 horas |
| Formatos com suporte |
.md, .txt, .rst, .adoc, .asciidoc, , .wiki, .textile, , .org, .htm, .html, , .json, .yaml, .yml, .xml, .csv (15 formatos de arquivo) |
| Processo de indexação | Os documentos são agrupados, inseridos e indexados para pesquisa semântica |
| Atualizações | As alterações em seu repositório são captadas no próximo ciclo de sincronização sem nenhuma ação manual necessária |
Seu agente processa cada documento dividindo-o em partes semanticamente significativas, gerando inserções de vetor e armazenando-as em um índice de pesquisa. Quando uma consulta chega, seu agente executa uma pesquisa semântica em todas as partes indexadas e recupera as passagens mais relevantes, independentemente das correspondências exatas de palavra-chave.
Sua equipe pode atualizar runbooks, adicionar novos procedimentos ou reorganizar páginas wiki e seu agente reflete essas alterações dentro de 24 horas.
Pré-requisitos
| Requisito | Detalhes |
|---|---|
| Wiki do Azure DevOps | Um wiki em seu projeto do Azure DevOps com conteúdo |
| Autenticação | Identidade gerenciada (recomendada) ou PAT (token de acesso pessoal) |
| Permissões | Acesso de leitura ao wiki |
Opções de autenticação
A tabela a seguir descreve os métodos de autenticação disponíveis para o conector wiki do Azure DevOps.
| Método | Mais adequado para | Como funciona |
|---|---|---|
| Identidade gerenciada | Ambientes de produção | Usa a identidade gerenciada do agente, atribuída pelo sistema ou pelo usuário. Requer a adição da identidade como usuário em sua organização do Azure DevOps. |
| PAT (token de acesso pessoal) | Configuração rápida, teste | Gere um PAT no Azure DevOps com escopo de Código (Leitura). |
Exemplo: usar um runbook durante um incidente
Depois de conectar o wiki de operações, pergunte ao agente:
Our payment service is returning 503 errors. What does our runbook say to do?
Seu agente pesquisa seu wiki, localiza a página "Solução de Problemas do Serviço de Pagamento" e responde com o procedimento documentado. A resposta inclui uma citação vinculando de volta à página wiki original no Azure DevOps.