Tutorial: Carregar documentos de conhecimento no Azure SRE Agent

Neste tutorial, carrega documentos de conhecimento para o seu Agente Azure SRE para que possa consultá-los em futuras investigações. Aprendes a guardar os resultados da investigação diretamente nas definições de Conhecimento através do chat e a carregar ficheiros existentes através da interface do portal.

Neste tutorial, aprenderás como:

  • Transforma uma investigação num livro de instruções reutilizável e guarda-o nas definições de Conhecimento
  • Verifique se o conteúdo carregado está indexado e pesquisável
  • Carregue ficheiros ou pastas individuais através do portal
  • Teste se o seu agente consegue recuperar o conteúdo carregado numa nova conversa

Tempo estimado: 10 minutos

Pré-requisitos

  • Um agente SRE do Azure no estado Em execução
  • Permissões de escrita no agente
  • Modo de execução do agente definido para Revisão ou Autónomo

Passo 1: Comece com uma investigação

Os melhores documentos de dados vêm de investigações reais. Em vez de criar conteúdo do zero, capture o que o seu agente já aprendeu.

  1. Vai a sre.azure.com e escolhe o teu agente.
  2. Na barra lateral esquerda, em Chats, encontra um tópico de investigação anterior – qualquer conversa onde o teu agente diagnosticou ou resolveu um problema – e seleciona-o.

Se ainda não tens um tópico de investigação, começa um novo chat e pede ao teu agente para investigar algo:

Investigate high memory usage on our container apps

Espere que a investigação termine e depois continue com o Passo 2.

Passo 2: Peça ao seu agente para criar um manual de operações

No mesmo tópico de investigação, peça ao seu agente para transformar as descobertas num manual de operações e guardá-lo nas configurações de Conhecimento. Seja específico quanto ao nome do ficheiro.

Create a runbook from the investigation we just did. Include the root cause
analysis, the diagnostic steps, mitigations, and escalation triggers.
Save it to Knowledge settings as high-memory-runbook.md

O seu agente:

  1. Sintetiza o contexto da investigação num manual estruturado.
  2. Gera-se secções como Análise da Causa Raiz, Etapas de Diagnóstico, Mitigações e Desencadeadores de Escalonamento.
  3. Guarda o documento nas definições de Conhecimento e confirma o carregamento.

O agente confirma que o documento foi guardado e fornece um link para download. O seu runbook está agora guardado nas definições de Conhecimento e indexado para pesquisa.

Ponto de controlo

  • O agente gerou um manual estruturado a partir da investigação.
  • O agente confirmou que o documento foi salvo.

Passo 3: Verificar nas definições de Conhecimento

  1. Na barra lateral esquerda, selecione Construtor para expandir a secção.
  2. Selecione Definições de Conhecimento.

A página de definições de Conhecimento mostra os seus documentos numa tabela com colunas para Nome do Ficheiro, Estado, Tipo e Última modificação. A coluna Estado mostra ✓ Indexado quando o documento está indexado e pronto para pesquisa.

Se o estado indicar Pendente, selecione Atualizar. A indexação normalmente termina em poucos segundos.

Ponto de controlo

  • Navegado para Builder → Definições de Conhecimento
  • O documento aparece com ✓ Estado indexado

Passo 4: Carregar ficheiros através do portal

Podes carregar ficheiros individuais ou pastas inteiras diretamente. Este método é útil para roteiros de execução, documentação ou materiais de referência existentes que a sua equipa já utiliza.

Carregar ficheiros individuais

  1. Na página de Fontes de Conhecimento , selecione Adicionar ficheiro.
  2. Arraste um ficheiro para a zona de largada, ou seleciona procurar ficheiros para escolher um.
  3. Selecione Adicionar ficheiro para carregar.

Carregar uma pasta

Também podes arrastar uma pasta inteira – incluindo subpastas aninhadas – para a zona de drop.

  1. Na página de Fontes de Conhecimento , selecione Adicionar ficheiro.
  2. Arraste uma pasta do gestor de ficheiros diretamente para a zona de largada.
  3. O portal extrai todos os ficheiros suportados da pasta e das suas subpastas, e depois lista-os no diálogo.
  4. Revê a lista de ficheiros – remove quaisquer ficheiros que não queiras selecionando o ícone de eliminar ao lado de cada ficheiro.
  5. Selecione Adicionar ficheiro para carregar todos os ficheiros listados.

O portal filtra automaticamente ficheiros com extensões não suportadas. Para a lista completa de extensões suportadas e limites de tamanho, consulte a página de funcionalidade Upload Knowledge Documents.

O tamanho máximo do ficheiro é de 16 MB por ficheiro, com até 100 MB por upload.

Observação

Quando carregas uma pasta, o portal não preserva a estrutura da pasta – os ficheiros das subpastas aparecem como documentos individuais. Se ficheiros em subpastas diferentes partilharem o mesmo nome, apenas o primeiro ficheiro é carregado.

Ponto de controlo

  • Selecionei Adicionar ficheiro e vi o diálogo de upload.
  • Carreguei um ficheiro ou arrastei uma pasta com sucesso.
  • Os ficheiros aparecem em fontes de Conhecimento com o estado ✓ Indexado .

Passo 5: Recolha de testes numa nova conversa

Inicie uma nova conversa de chat e faça uma pergunta que os seus documentos carregados devem responder.

What are the steps for troubleshooting high memory usage on container apps?

O seu agente pesquisa nas configurações de Conhecimento, encontra o seu runbook carregado e faz referência a ele na resposta. Este processo confirma que o conhecimento é indexado e recuperável.

Ponto de controlo

  • Comecei um novo tópico de chat
  • Fiz uma pergunta relacionada com o conteúdo carregado
  • O agente referiu o documento carregado na sua resposta

Eliminar um documento de conhecimento

  1. Vai a Builder → Definições de Conhecimento.
  2. Na lista de documentos, selecione um ou mais documentos usando as caixas de seleção.
  3. Selecione Excluir na barra de ferramentas.
  4. Um diálogo de confirmação lista os documentos a remover. Selecione Eliminar para confirmar.

Quando elimina documentos, remove-os das definições de Conhecimento do agente e eles deixam de aparecer nos resultados de pesquisa.

Observação

Não podes editar documentos de conhecimento no local. Para atualizar um documento, carregue uma nova versão com o mesmo nome de ficheiro. A nova versão substitui a versão anterior.

O que aprendeu

  • O seu agente pode transformar investigações reais em runbooks estruturados e guardá-los nas configurações de Conhecimento.
  • Pode carregar ficheiros manualmente através da interface do portal nas definições do Builder → Knowledge. Suporta muitos formatos, incluindo PDF, documentos do Office e imagens.
  • O sistema indexa documentos carregados para pesquisa semântica, e eles estão disponíveis em todas as conversas futuras.
  • Para atualizar documentos, carregue-os usando o mesmo nome de ficheiro.

Troubleshooting

Erro Motivo Corrigir
"A memória do agente está desativada. Não pode carregar documentos." As definições de conhecimento não estão ativadas no seu agente Contacte o seu administrador para ativar as definições de Conhecimento
"Não tenho acesso de escrita às tuas definições de Conhecimento" O agente não conseguiu localizar a ferramenta de upload Reformule o seu pedido: "Guardar nas definições de Conhecimento como filename.md"
"Extensão de ficheiro inválida. Só ficheiros .md e .txt são permitidos." O nome do ficheiro não termina em .md ou .txt (carregamento do chat) Use uma extensão .md ou .txt ao pedir ao agente para guardar
"O conteúdo do documento excede o tamanho máximo de 16MB" Conteúdo demasiado grande para um único documento Dividir em vários documentos mais pequenos
"O nome do ficheiro não pode estar vazio" Não foi fornecido nome de ficheiro Inclua um nome de ficheiro no seu prompt (por exemplo, runbook.md)
Recurso O que você aprende
Carregar documentos de conhecimento Como isto funciona e porque é importante
Criar uma Competência Desenvolva competências processuais que complementem os documentos de conhecimento
Competências Como as competências e o conhecimento trabalham em conjunto
Conhecimento da wiki ADO Conecte conteúdo de wiki em tempo real como fonte de conhecimento
  • Last updated on