Partilhar via


Conectar conhecimento com o Azure SRE Agent

O teu agente vem com observabilidade Azure incorporada, mas cada equipa tem um contexto único: runbooks, documentos de arquitetura, wikis internos e repositórios de código. Ao usar a base de conhecimento, pode gerir todas estas fontes de informação num só local para que o seu agente possa consultá-las durante as investigações.

Sugestão

Principais conclusões

  • Construtor > A base de conhecimento é o local central para gerir todas as fontes de conhecimento, incluindo ficheiros, páginas web e repositórios.
  • Carregue os runbooks e a documentação, adicione páginas web por URL ou conecte repositórios de código-fonte.
  • O seu agente consulta automaticamente o conhecimento indexado durante as investigações.
  • Quanto mais conhecimento relevante tiver o seu agente, mais rápidas e precisas serão as suas respostas.

Por que o conhecimento importa

O seu agente é poderoso e pronto para uso com a observabilidade do Azure e ferramentas conectadas. Mas cada equipa tem um contexto único: runbooks, documentos de arquitetura, wikis internas e repositórios de código que contêm o conhecimento institucional necessário para resolver incidentes rapidamente.

Quando o seu agente tem acesso a este conhecimento, pode:

  • Consulta os livros de regras da tua equipa durante os incidentes em vez de começares do zero.
  • Correlaciona problemas de produção com alterações específicas de código nos teus repositórios.
  • Aplique passos de resolução de problemas que a sua equipa já tenha documentado.

Base de conhecimento

Use a página da Base de Conhecimento no portal (Builder>Knowledge Base) para gerir o conhecimento do seu agente. Pode carregar ficheiros, adicionar páginas web e visualizar repositórios relacionados.

A tabela seguinte descreve os três tipos de fontes de conhecimento.

Tipo de fonte O que oferece Como adicionar
Files Runbooks, guias de resolução de problemas, documentação de arquitetura, referências de configuração Faça upload através do portal, arraste e largue, ou deixe o seu agente assistente criá-los durante as conversas
Páginas Web Documentação externa, páginas de estado, URLs internas da wiki Adicionar por URL. O seu agente indexa o conteúdo da URL dada.
Repositórios Código-fonte para análise de causa raiz, configurações de implementação, infraestrutura como código Conectar-se a repositórios do GitHub ou do Azure DevOps

Cada entrada mostra o seu nome, estado de indexação (Indexado, Pendente ou Não indexado), tipo e data da última modificação .

Carregar documentos

O seu agente pode criar e carregar conhecimento durante as conversas. Peça para que guarde um runbook do que foi resolvido, e ele armazena o documento automaticamente. Também pode carregar ficheiros diretamente através do portal.

Para formatos de ficheiro suportados e limites de tamanho, consulte Carregar documentos de conhecimento: Formatos de ficheiro suportados. Para detalhes completos sobre tipos de ficheiros, limites e documentos gerados por agentes, consulte Carregar documentos de conhecimento.

Partilhar ficheiros no chat

Podes anexar ficheiros diretamente numa conversa usando arrastar e largar, colar a partir da prancheta ou o + botão. O tópico armazena anexos de chat e dá ao seu agente contexto imediato para análise.

Sugestão

Quer manter um ficheiro permanentemente?

Depois de anexar um ficheiro no chat, pergunte ao seu agente: "Guarde isto nas definições de conhecimento." O agente lê o ficheiro do tópico e carrega uma cópia para a base de conhecimento, tornando-o indexado e pesquisável em todas as conversas futuras. O ficheiro original também fica no tópico.

A tabela seguinte compara o carregamento de documentos de conhecimento e a partilha de ficheiros no chat.

Carregar conhecimento Partilhar ficheiros no chat
Where Base de Conhecimento do Construtor >, ou pergunte no chat Entrada de mensagens no chat (+, arrastar/largar, colar)
Armazenamento Nível de agente: Indexado, pesquisável em todas as threads Nível de tópico: Disponível nesta conversa
Melhor para Guias de execução, documentação de arquitetura, procedimentos que pretende que o agente consulte em todas as futuras conversas Capturas de ecrã, registos, ficheiros de configuração que precisas de analisar agora
Promover a conhecimento Já lá está Pergunte ao agente: "Guardar isto nas definições de conhecimento", o que copia o conteúdo para armazenamento ao nível do agente
Formatos 28 tipos, incluindo documentos, dados, imagens 31 tipos incluindo código, scripts, infraestrutura, web
Limites de tamanho 16 MB por ficheiro, 100 MB por upload 10 MB por ficheiro, 50 MB no total, 5 ficheiros

Conectar código-fonte

Ligue repositórios GitHub ou Azure DevOps para que o seu agente possa pesquisar código, correlacionar erros com alterações recentes e referenciar configurações de implementação durante investigações.

Adicionar repositórios

NaBuilder>base de conhecimento, selecione Adicionar repositório para abrir um assistente que o orienta por três etapas:

Step O que fazes
1. Escolha uma plataforma Selecione GitHub ou Azure DevOps. Para Azure DevOps, introduza o nome da sua organização.
2. Autenticar Inicie sessão com OAuth ou introduza um token de acesso pessoal (PAT). O Azure DevOps também suporta identidade gerida.
3. Adicionar repositórios Navegue pelos repositórios disponíveis no menu suspenso ou introduza URLs manualmente. Adicione um nome de exibição e uma descrição opcional para cada entrada. Para Azure DevOps, selecione primeiro um projeto para filtrar a lista de repositórios.

Podes adicionar vários repositórios numa única sessão. Seleciona + para adicionar linhas, depois seleciona Guardar quando terminares.

Após a gravação, os seus repositórios aparecem na lista da base de conhecimento com o estado de indexação. Depois de indexado, o seu agente pode referenciar o código nas conversas.

Plataformas suportadas e autenticação

Plataforma Métodos de autenticação O que precisa
GitHub OAuth, token de acesso pessoal Conta GitHub com acesso ao repositório. Para PAT, crie um token com o escopo de repo.
Azure DevOps OAuth, Token de acesso pessoal, Identidade gerida Acesso à organização Azure DevOps. Para identidade gerida, atribui uma identidade gerida atribuída pelo utilizador ao recurso agente.

Próximo passo