Conectar informações no Azure SRE Agent

Dica

  • Use Builder → base de conhecimento para gerenciar todas as fontes de conhecimento, incluindo arquivos, páginas da Web e repositórios.
  • Carregue os runbooks e os documentos, adicione as páginas da Web por URL ou conecte os repositórios de código-fonte.
  • Seu agente faz referência automaticamente ao conhecimento indexado durante as investigações.
  • Quanto mais conhecimento relevante seu agente tiver, mais rápidas e precisas serão suas respostas.

Por que o conhecimento importa

Seu agente já vem com recursos poderosos, prontos para uso, graças à observabilidade do Azure e às ferramentas conectadas. Mas cada equipe tem um contexto exclusivo, incluindo runbooks, documentos de arquitetura, wikis internos e repositórios de código que contêm o conhecimento tribal necessário para resolver incidentes rapidamente.

Quando o agente tem acesso a esse conhecimento, ele pode:

  • Consulte os runbooks da sua equipe durante incidentes em vez de começar do zero.
  • Correlacionar problemas de produção a alterações de código específicas em seus repositórios.
  • Aplique as etapas de solução de problemas que sua equipe já documentou.

Base de dados de conhecimento: um lugar para todas as fontes

Use a página base de conhecimento no portal (Construtor>Base de conhecimento) para gerenciar o conhecimento do agente. Você pode carregar arquivos, adicionar páginas da Web e exibir repositórios conectados.

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

Tipo de origem O que ele fornece Como adicionar
Files Runbooks, guias de solução de problemas, documentos de arquitetura, referências de configuração Carregue por meio do portal, arraste e solte ou deixe seu agente criá-los durante as conversas
Páginas da Web Documentação externa, páginas de status, URLs wiki internas Adicionar por URL. Seu agente indexa o conteúdo da URL fornecida.
Repositórios Código-fonte para análise de causa raiz, configurações de implantação, infraestrutura como código Conectar o GitHub ou o Azure Repos

Cada entrada mostra seu nome, status de indexação (indexado, pendente ou não indexado), tipo e data da última modificação . Ao passar o mouse sobre o status ✓ Indexado, você verá um Criado em tooltip que mostra exatamente quando a origem foi indexada.

Verificar a atualização de dados

Quando uma fonte de conhecimento é indexada, passe o mouse sobre o status ✓ Indexado para ver a dica de ferramenta Criação em com a data e hora exatas em que ela foi processada. Essas informações ajudam você a confirmar que seu agente está trabalhando com a versão mais atual de cada documento. Isso é especialmente útil depois de atualizar um runbook ou um guia de solução de problemas.

As fontes de conhecimento exibem um dos três status:

Status Meaning
✓ Indexado O conteúdo é processado e pesquisável. Passe o mouse para ver o carimbo de data/hora Criação em.
Pendente O conteúdo está sendo processado. Volte em breve.
⚠ Não indexado Falha no processamento. Tente carregar novamente ou verificar a URL de origem.

Carregar documentos

Seu agente pode criar e carregar conhecimento durante as conversas. Peça para ela salvar um runbook do que você acabou de resolver e ela armazenará o documento automaticamente. Você também pode carregar arquivos diretamente por meio do portal.

Para obter formatos de arquivo com suporte e limites de tamanho, consulte Carregar Documentos de Conhecimento → formatos de arquivo com suporte.

Para obter detalhes completos sobre tipos de arquivo, limites e documentos gerados por agente, consulte Carregar Documentos de Conhecimento.

Compartilhar arquivos no chat

Você também pode anexar arquivos diretamente no chat. Arraste e solte, cole da área de transferência ou use o botão +. Os anexos de chat são armazenados com o thread e fornecem ao agente contexto imediato para análise.

Dica

Depois de anexar um arquivo no chat, pergunte ao seu agente: "Salve-o nas configurações de conhecimento". O agente lê o arquivo do thread e carrega uma cópia para as configurações de conhecimento, tornando-o indexado e pesquisável em todas as conversas futuras. O original também permanece no thread.

Attribute Carregar conhecimento Compartilhar arquivos no chat
Onde Construtor → configurações de conhecimento ou pergunte no chat Entrada de mensagem de chat (+, arrastar/soltar, colar)
Armazenamento Nível do agente: indexado, pesquisável em todos os threads Nível de tópico: disponível nesta conversa
Mais adequado para Runbooks, documentos de arquitetura, procedimentos que você deseja que o agente referencie em todas as conversas futuras Capturas de tela, logs, arquivos de configuração que você precisa analisar agora
Promover para conhecimento Já está lá Pergunte ao agente: "Salve isso nas configurações de conhecimento". Em seguida, o agente copia o conteúdo para o armazenamento no nível do agente.
Formatos 28 tipos: documentos, dados, imagens 31 tipos: adiciona código, scripts, infraestrutura, Web
Limites de tamanho 16 MB por arquivo · 100 MB por upload 10 MB por arquivo · Total de 50 MB · 5 arquivos

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

Conectar código-fonte

Conecte GitHub ou Azure Repos para que o agente possa pesquisar código, correlacionar erros com alterações recentes e referenciar configurações de implantação durante investigações.

Adicionar repositórios

Nabase de dados de conhecimento do >, selecione Adicionar repositório para abrir um assistente guiado que orienta você por três etapas:

Etapa O que você faz
1. Escolher uma plataforma Selecione GitHub ou Azure DevOps. Para Azure DevOps, insira o nome da sua organização.
2. Autenticar Entre com o OAuth ou insira um PAT (token de acesso pessoal). Azure DevOps também dá suporte à identidade gerenciada.
3. Adicionar repositórios Navegue pelos repositórios disponíveis na lista suspensa ou insira URLs manualmente. Adicione um nome de exibição e uma descrição opcional para cada entrada. Para Azure DevOps, selecione um projeto primeiro para filtrar a lista de repositórios.

Você pode adicionar vários repositórios em uma única sessão. Selecione + para adicionar linhas e, em seguida, selecione Salvar quando terminar.

Depois de salvar, seus repositórios aparecem na lista de base de dados de conhecimento com o status de indexação. Depois de indexado, seu agente pode referenciar o código em conversas.

Plataformas e autenticação com suporte

Plataforma Métodos de autenticação O que você precisa
GitHub OAuth, token de acesso pessoal Conta no GitHub com acesso ao repositório. Para o PAT, crie um token com o escopo de repo.
Azure DevOps OAuth, token de acesso pessoal, identidade gerenciada Acesso à organização do Azure DevOps. Para identidade gerenciada, atribua uma identidade gerenciada atribuída pelo usuário ao recurso do agente.

Introdução

Recurso O que aprendeu
Carregar documentos de conhecimento → Adicionar runbooks e documentos às base de conhecimento do agente
Conectar-se ao ADX → Conectar Azure Data Explorer para consultas de log
Conectar GitHub → Conectar um repositório de código-fonte

Conteúdo relacionado

Capability O que ele adiciona
Carregar documentos de conhecimento Formatos de arquivo persistentes, limites e conhecimento gerado pelo agente
Compartilhar arquivos no chat Anexos de arquivo temporários para análise imediata em uma conversa
Conector GitHub Código-fonte, problemas, solicitações de pull e acesso ao fluxo de trabalho
Azure DevOps Connector Código-fonte, itens de trabalho, conhecimento do wiki e acesso ao pipeline
Conectores MCP Estender para Datadog, Splunk e outros sistemas externos
  • Last updated on