Conectar informações no Azure SRE Agent

Azure agente SRE é mais eficaz quando pode usar o mesmo contexto que sua equipe usa para solucionar problemas de sistemas. Conecte runbooks, documentação, páginas da web e repositórios para que seu agente possa consultá-los durante investigações, em vez de começar do zero.

Dica

• Use a base de dados de conhecimento do Construtor > para gerenciar arquivos, páginas da Web e repositórios em um só lugar.
• O conhecimento indexado está disponível automaticamente durante investigações e chat.
• Você pode carregar documentos diretamente, anexar arquivos no chat ou conectar repositórios para análise com reconhecimento do código-fonte.
• As fontes de conhecimento mais úteis são as que sua equipe já depende, como runbooks, notas de arquitetura, guias de solução de problemas e código-fonte.

Por que o conhecimento importa

Seu agente já tem contexto Azure interno por meio de ferramentas de observabilidade e sistemas conectados. O que ele não tem por padrão é o conhecimento interno da sua equipe. Esse conhecimento inclui o runbook que explica uma etapa de recuperação comum, a nota de arquitetura que identifica uma dependência compartilhada ou o repositório que revela qual implantação introduziu uma regressão.

Quando você conecta esse conhecimento, seu agente pode:

• Consulte os runbooks da equipe durante um incidente.
• Reutilize as etapas de solução de problemas que sua equipe já documentou.
• Correlacionar sintomas com o código-fonte e o contexto de implantação.
• Responda a perguntas usando os mesmos documentos e referências que os humanos usam.

Gerenciar conhecimento na base de dados de conhecimento

Use a Builder > base de conhecimento para gerenciar as fontes de conhecimento do seu agente.

A página mostra cada fonte com sua:

• Name
• Status
• Tipo
• Data da última modificação

Três tipos de origem estão disponíveis:

Tipo de origem	O que ele fornece	Como adicioná-lo
Files	Runbooks, guias de solução de problemas, documentos de arquitetura e material de referência	Fazer upload pelo portal ou solicitar ao agente que salve um documento durante o chat
Páginas da Web	Documentação externa, URLs wiki internas e páginas de status	Adicionar a URL da página para que o agente possa indexar o conteúdo
Repositórios	Código-fonte, arquivos de implantação e definições de infraestrutura	Conectar repositórios de GitHub ou Azure DevOps

Verificar o status e a atualização da indexação

Cada fonte de conhecimento mostra um dos seguintes estados:

Status	Meaning
Indexado	O conteúdo é processado e pesquisável
Pendente	O conteúdo ainda está sendo processado
Não indexado	Falha no processamento ou a origem não pôde ser indexada

Quando uma fonte for indexada, passe o cursor sobre o indicador de status para ver a data e hora de Criado em. Esse carimbo de data/hora é útil quando você deseja confirmar se a versão mais recente de um runbook ou documento foi processada.

Carregar documentos

Carregue documentos quando quiser que o conhecimento permaneça disponível em conversas futuras.

Exemplos típicos incluem:

• Runbooks de incidentes
• Guias de escalonamento
• Referências de arquitetura
• Listas de verificação de solução de problemas

Você pode carregar arquivos por meio do portal ou solicitar ao agente que salve o conteúdo de uma conversa na base de dados de conhecimento.

Para obter os formatos e limites de arquivo com suporte, consulte Carregar documentos de conhecimento.

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

Compartilhar arquivos no chat

Use anexos de chat quando quiser fornecer ao agente contexto imediato em uma única conversa. Essa abordagem é útil para capturas de tela, logs, arquivos de configuração e outros materiais que ajudam na solução de problemas ativa.

Dica

Se um arquivo anexado no chat deve se tornar um conhecimento de longo prazo, peça ao agente para salvá-lo nas configurações de conhecimento. O agente pode carregar uma cópia para que o conteúdo se torne indexado e pesquisável em conversas posteriores.

A tabela a seguir compara uploads de conhecimento de longo prazo com anexos de chat temporários:

Scenario	Fazer upload para a base de conhecimento	Compartilhar no chat
Mais adequado para	Runbooks, procedimentos e documentos que você deseja disponibilizar em conversas futuras	Arquivos que você deseja que o agente analise agora
Escopo de armazenamento	No nível do agente e pesquisável em futuras conversas	No nível do tópico e disponível na conversa atual
Como adicionar	Fazer upload no portal ou solicitar ao agente que salve o conteúdo	Arrastar e soltar, colar da área de transferência ou usar + no chat
Pode se tornar conhecimento de longo prazo	Conhecimento já de longo prazo	Sim, se você pedir ao agente para salvá-lo

Para obter mais informações, consulte Compartilhar arquivos no chat.

Adicionar páginas da Web

Adicione páginas da Web quando as diretrizes importantes estiverem fora dos arquivos ou repositórios carregados.

Bons candidatos incluem:

• Artigos wiki internos
• Documentação do produto público
• Páginas de status do serviço
• Páginas de referência mantidas por equipe

Depois de adicionar uma URL, o agente indexa o conteúdo da página para que ele possa referenciar essas informações durante investigações futuras.

Conectar repositórios

Conecte repositórios do GitHub ou do Azure DevOps quando seu agente precisar de contexto com reconhecimento do código-fonte.

Repositórios conectados ajudam o agente:

• Pesquisar padrões de erro no código-fonte
• Correlacionar incidentes com alterações de código recentes
• Arquivos de implantação e configuração de referência
• Usar o conteúdo do repositório durante a análise de causa raiz

Para conectar o código-fonte, consulte Conectar código-fonte.

Escolha a fonte de conhecimento certa

Use o tipo de origem que corresponde ao tipo de contexto necessário:

Se você precisar se conectar...	Use...
Um runbook ou guia de solução de problemas armazenado como um arquivo	Carregar documentos de conhecimento
Uma captura de tela, um log ou um arquivo para uma investigação ativa	Compartilhar arquivos no chat
Um repositório GitHub ou Azure DevOps	Conectar código-fonte
Sistemas externos, como Datadog ou Splunk	Conectores MCP