Conectar conhecimento com o Azure SRE Agent

O Azure SRE Agent é mais eficaz quando pode usar o mesmo contexto que a sua equipa usa para resolver problemas nos sistemas. Ligue runbooks, documentação, páginas na Web e repositórios para que o seu agente possa consultá-los durante as investigações, em vez de partir do zero.

Sugestão

  • Use a Builder > base de conhecimento para gerir ficheiros, páginas web e repositórios num só lugar.
  • O conhecimento indexado está automaticamente disponível durante as investigações e o chat.
  • Pode carregar documentos diretamente, anexar ficheiros no chat ou ligar repositórios para uma análise consciente da fonte.
  • As fontes de conhecimento mais úteis são aquelas das quais a tua equipa já depende, como runbooks, notas de arquitetura, guias de resolução de problemas e código-fonte.

Por que o conhecimento importa

O seu agente já tem contexto Azure incorporado através de ferramentas de observabilidade e sistemas ligados. O que não tem, por defeito, é o conhecimento interno da sua equipa. Esse conhecimento inclui o runbook que explica um passo comum de recuperação, a nota de arquitetura que identifica uma dependência partilhada, ou o repositório que revela qual a implementação que introduziu uma regressão.

Quando liga essa base de conhecimento, o seu agente pode:

  • Consulte os guias operacionais da equipa durante um incidente.
  • Reutilize passos de resolução de problemas que a sua equipa já tenha documentado.
  • Correlaciona os sintomas com o código-fonte e o contexto de implementação.
  • Responda às perguntas usando os mesmos documentos e referências que os humanos utilizam.

Gerir o conhecimento na base de conhecimento

Utilize a Base de conhecimento do Builder > para gerir as fontes de conhecimento do seu agente.

A página mostra cada fonte com as suas:

  • Nome
  • Status
  • Type
  • Data da última modificação

Estão disponíveis três tipos de fonte:

Tipo de fonte O que oferece Como adicionar
Files Procedimentos operacionais, guias de resolução de problemas, documentos de arquitetura e material de referência Faça o upload através do portal ou peça ao agente para guardar um documento durante o chat
Páginas Web Documentação externa, URLs internas da wiki e páginas de estado Adicione o URL da página para que o agente possa indexar o conteúdo
Repositórios Código-fonte, ficheiros de implementação e definições de infraestrutura Ligar os repositórios do GitHub ou do Azure DevOps

Verificar o estado e a frescura da indexação

Cada fonte de conhecimento apresenta um dos seguintes estados:

Situação Meaning
Indexado O conteúdo é processado e pesquisável
pendente O conteúdo ainda está a ser processado
Não indexado O processamento falhou ou a fonte não pôde ser indexada

Quando uma fonte é indexada, passe o rato sobre o indicador de estado para ver a data e hora de Criação. Este carimbo temporal é útil quando se quer confirmar que a versão mais recente de um runbook ou documento está a ser processada.

Carregar documentos

Carregue documentos quando quiser que o conhecimento continue disponível em futuras conversas.

Exemplos típicos incluem:

  • Guias de Procedimentos para Incidentes
  • Guias de escalada
  • Referências arquitetónicas
  • Listas de verificação de resolução de problemas

Pode carregar ficheiros através do portal, ou pode pedir ao agente para guardar o conteúdo de uma conversa na base de conhecimento.

Para formatos de ficheiro suportados e limites, consulte Carregar documentos de conhecimento.

Para o fluxo de trabalho completo, consulte Carregar documentos de conhecimento.

Partilhar ficheiros no chat

Use anexos de chat quando quiser dar contexto imediato ao agente numa única conversa. Esta abordagem é útil para capturas de ecrã, registos, ficheiros de configuração e outros materiais que ajudam na resolução ativa de problemas.

Sugestão

Se um ficheiro que anexar no chat se tornar conhecimento a longo prazo, peça ao agente para o guardar nas definições de Conhecimento. O agente pode carregar uma cópia para que o conteúdo fique indexado e pesquisável em conversas posteriores.

A tabela seguinte compara os carregamentos de conhecimento a longo prazo com anexos temporários de chat:

Scenario Carregar para a Base de Conhecimento Partilhar no chat
Melhor para Guias operacionais, procedimentos e documentos que pretende ter disponíveis em conversas futuras Ficheiros que queres que o agente analise agora mesmo
Âmbito de armazenamento Nível de agente e pesquisável em conversas futuras Ao nível do tópico e disponível na conversa atual
Como adicionar Carregue no portal ou peça ao agente para guardar o conteúdo Arrastar e soltar, colar a partir da prancheta ou usar + no chat
Pode tornar-se conhecimento a longo prazo Conhecimento já de longo prazo Sim, se pedir ao agente para o guardar

Para mais informações, consulte Partilhar ficheiros no chat.

Adicionar páginas web

Adicione páginas web quando a orientação importante estiver fora dos ficheiros ou repositórios carregados.

Os bons candidatos incluem:

  • Artigos internos da wiki
  • Documentação pública do produto
  • Páginas de estado do serviço
  • Páginas de referência mantidas pela equipa

Depois de adicionar um URL, o agente indexa o conteúdo da página para poder referenciar essa informação durante investigações futuras.

Liga repositórios

Ligue repositórios do GitHub ou do Azure DevOps se o seu agente precisar de contexto com reconhecimento da origem.

Repositórios ligados ajudam o agente:

  • Pesquisa por padrões de erro no código-fonte
  • Correlacionar incidentes com alterações recentes ao código
  • Ficheiros de implementação e configuração de referência
  • Utilizar o conteúdo do repositório durante a análise da causa raiz

Para ligar código-fonte, consulte Conectar código-fonte.

Escolha a fonte de conhecimento certa

Usa o tipo de fonte que corresponde ao tipo de contexto que precisas:

Se precisares de estabelecer ligação... Utiliza...
Um manual de procedimentos ou guia de resolução de problemas armazenado num ficheiro Carregar documentos de conhecimento
Uma captura de ecrã, registo ou ficheiro para uma investigação ativa Partilhar ficheiros no chat
Um repositório GitHub ou Azure DevOps Liga o código-fonte
Sistemas externos como Datadog ou Splunk Conectores MCP