Tutorial: Carregar documentos de conhecimento no agente SRE do Azure

Neste tutorial, você carrega documentos de conhecimento para seu agente SRE Azure para que ele possa referenciá-los durante investigações futuras. Você aprenderá a salvar os resultados da investigação diretamente nas configurações de conhecimento por meio do chat e como carregar arquivos existentes por meio da interface do usuário do portal.

Neste tutorial, você aprenderá como:

Tempo estimado: 10 minutos

Pré-requisitos

• Um agente SRE do Azure em estado de execução
• Gravar permissões no agente
• Modo de execução do agente definido como Revisão ou Autônomo

Etapa 1: Iniciar de uma investigação

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

1. Vá para sre.azure.com e selecione seu agente.
2. Na barra lateral esquerda, em Chats, localize um thread de investigação anterior - qualquer conversa em que seu agente diagnosticou ou resolveu um problema - e selecione-o.

Se você ainda não tiver um thread de investigação, inicie um novo chat e peça ao agente para investigar algo:

Investigate high memory usage on our container apps

Aguarde a conclusão da investigação e continue com a Etapa 2.

Etapa 2: Peça ao seu agente para criar um runbook

No mesmo tópico de investigação, peça ao agente para transformar as suas descobertas em um runbook e salvá-lo na base de conhecimento. Seja específico sobre o nome do arquivo.

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

Seu agente:

1. Sintetiza o contexto da investigação em um runbook estruturado.
2. Gera seções como Análise de Causa Raiz, Etapas de Diagnóstico, Mitigações e Acionadores de Escalonamento.
3. Salva o documento nas configurações de conhecimento e confirma o upload.

O agente confirma que o documento foi salvo e fornece um link de download. O seu runbook agora está armazenado nas configurações de conhecimento e é indexado para pesquisa.

Checkpoint

• O Agente gerou um runbook estruturado com base na investigação.
• O agente confirmou que o documento foi salvo.

Etapa 3: Verificar nas configurações da base de conhecimento

1. Na barra lateral esquerda, selecione Construtor para expandir a seção.
2. Selecione configurações de conhecimento.

A página configurações de conhecimento exibe seus documentos em uma tabela com colunas para Nome do Arquivo, Status, Tipo e Última modificação. A coluna Status mostra ✓ Indexado quando o documento é indexado e pronto para pesquisa.

Se o status mostrar Pendente, selecione Atualizar. Normalmente, a indexação é concluída em alguns segundos.

Checkpoint

• Navegou até Construtor → Configurações de conhecimento
• Documento é exibido com ✓ Status indexado

Etapa 4: Carregar arquivos por meio do portal

Você pode carregar arquivos individuais ou pastas inteiras diretamente. Esse método é útil para runbooks existentes, documentação ou materiais de referência que a sua equipe já possua.

Carregar arquivos individuais

1. Na página Fontes de conhecimento , selecione Adicionar arquivo.
2. Arraste um arquivo para a zona suspensa ou selecione procurar arquivos para escolher um.
3. Selecione Adicionar arquivo para carregar.

Carregar uma pasta

Você também pode arrastar uma pasta inteira, incluindo as subpastas aninhadas, para a área para arrastar e soltar.

1. Na página Fontes de conhecimento , selecione Adicionar arquivo.
2. Arraste uma pasta do gerenciador de arquivos diretamente para a área para arrastar e soltar.
3. O portal extrai todos os arquivos com suporte da pasta e de suas subpastas e os lista na caixa de diálogo.
4. Examine a lista de arquivos – remova todos os arquivos que você não deseja selecionando o ícone de exclusão ao lado de cada arquivo.
5. Selecione Adicionar arquivo para carregar todos os arquivos listados.

O portal filtra automaticamente arquivos com extensões sem suporte. Para obter a lista completa de extensões com suporte e limites de tamanho, consulte a página de funcionalidade Carregar Documentos de Conhecimento.

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

Checkpoint

• Selecionou Adicionar arquivo e viu a caixa de diálogo de upload.
• Carregou um arquivo ou arrastou uma pasta com êxito.
• Os arquivos aparecem em fontes de conhecimento com ✓ status de indexado.

Etapa 5: Testar a recuperação em uma nova conversa

Inicie um novo thread de chat e faça uma pergunta que seus documentos carregados devem responder:

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

O seu agente pesquisa a configuração de conhecimento, localiza o seu runbook enviado e refere-se a ele na resposta. Esse processo confirma se o conhecimento é indexado e recuperável.

Checkpoint

• Iniciou um novo thread de chat
• Pergunta relacionada ao conteúdo carregado
• O agente fez referência ao documento carregado em sua resposta

Excluir um documento de conhecimento

1. Acesse Construtor → Configuraçõ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. Uma caixa de diálogo de confirmação lista os documentos a serem removidos. Selecione Excluir para confirmar.

Ao excluir documentos, você os remove das configurações de Conhecimento do agente e eles não aparecem mais nos resultados da pesquisa.

O que você aprendeu

• Seu agente pode transformar investigações reais em runbooks estruturados e salvá-los nas configurações de Conhecimento.
• Você pode carregar arquivos manualmente por meio da interface do usuário do portal no Construtor → configurações de conhecimento. Ele dá suporte a muitos formatos, incluindo PDF, documentos do Office e imagens.
• O sistema indexa documentos carregados para pesquisas semânticas e eles estão disponíveis em todas as conversas futuras.
• Para atualizar documentos, carregue-os usando o mesmo nome de arquivo.

Solução de problemas

Related