Carregar documentos de conhecimento no Azure SRE Agent

Sugestão

  • O teu agente cria e carrega runbooks durante conversas sem qualquer gestão manual de ficheiros.
  • Anexe 31 tipos de ficheiros no chat, incluindo .kql, .bicep, .tf, .har, .py, e .xlsx, para contexto imediato de análise.
  • Carregar 28 tipos de ficheiros nas definições de Conhecimento para armazenamento persistente e indexado em todas as conversas futuras
  • As resoluções de incidentes tornam-se automaticamente conhecimento institucional

O problema: o conhecimento morre com a conversa

Cada incidente que a sua equipa resolve gera conhecimento valioso: o que correu mal, que comandos corrigiram e o que verificar primeiro da próxima vez. Mas esse conhecimento vive nas conversas, na memória dos engenheiros e nos pós-mortes que ninguém lê às 3 da manhã.

A tua equipa tem procedimentos operacionais, mas eles ficam obsoletos. A solução descoberta durante o incidente de ontem à noite? Está na cabeça de alguém, ou enterrado numa conversa que desaparece de vista na próxima semana. Da próxima vez que o mesmo problema acontecer, um engenheiro diferente começa do zero.

Como o seu agente resolve este problema

O seu agente pode carregar documentos nas definições de Conhecimento durante as conversas usando a ferramenta Upload Knowledge Document . Quando o seu agente descobre uma correção, cria um guia de resolução de problemas ou sintetiza as conclusões da investigação, armazena esse conhecimento diretamente e torna-o pesquisável para todas as conversas futuras.

"Create a runbook from the steps we just followed to fix this database
connection pool exhaustion issue and save it to Knowledge settings."

O seu agente gera um runbook estruturado e faz o upload em segundos. O documento é indexado automaticamente e torna-se pesquisável para futuras investigações.

Antes e depois

Antes Depois
Captura de conhecimento Pós-incidente: engenheiro escreve o livro de instruções (talvez) O seu agente capta a correção à medida que acontece
Hora de documentar 30 a 60 minutos para escrever um manual de operações Segundos. O seu agente gera e carrega diretamente em linha.
Atualização do conhecimento Os guias operacionais tornam-se desatualizados em poucas semanas. As definições de conhecimento crescem a cada resolução
Acessibilidade Conhecimento retido na cabeça do engenheiro ou no thread de chat Pesquisável por seu agente em todas as conversas futuras
Consistência do formato Varia consoante o autor Documentação estruturada e consistente sempre

O que torna isto diferente

Ao contrário dos uploads manuais, o seu agente cria conhecimento de forma proativa. Não precisas de te lembrar de documentar o que aprendeste porque o teu agente faz isso como parte da conversa.

Ao contrário do histórico de chat, os documentos carregados são indexados para pesquisa semântica. Quando ocorre um problema semelhante meses depois, o seu agente encontra automaticamente o manual de operações relevante através de uma recuperação inteligente, em vez de percorrer tópicos antigos.

Ao contrário dos conectores wiki, os documentos carregados não requerem serviços externos. O conhecimento reside diretamente nas configurações de Conhecimento do seu agente, disponível de imediato sem quaisquer atrasos de sincronização.

Como funciona

A ferramenta Upload Knowledge Document aceita três parâmetros:

Parâmetro Obrigatório Descrição
Nome do ficheiro Sim Nome com .md ou .txt extensão (por exemplo, database-pool-runbook.md)
Content Sim Texto integral do documento em formato Markdown ou texto simples
Desencadear indexação Opcional (padrão: true) Se deve tornar o documento pesquisável imediatamente

Quando o seu agente carrega um documento:

  1. Valida o nome do ficheiro e o conteúdo (até 16 MB por ficheiro).
  2. Armazena o documento nas definições de Conhecimento do seu agente.
  3. Indexa o conteúdo para pesquisa semântica.
  4. Confirma o upload com uma mensagem de sucesso.

Observação

Se um documento com o mesmo nome de ficheiro já existir, o novo conteúdo substitui-lo. Este processo facilita a atualização dos conhecimentos do seu agente. Carrega com o mesmo nome para atualizar o conteúdo.

Formatos de ficheiro suportados

O seu agente gere os ficheiros através de três métodos, cada um suportando formatos diferentes.

Anexos de chat

Arrasta ficheiros para qualquer chat para dar ao teu agente contexto imediato para análise – scripts de resolução de problemas, ficheiros de configuração, rastreios de rede e mais.

Categoria Extensões
Images .png, .jpg, .jpeg, .gif, .webp, .svg
Documents .txt, .md, .pdf, .docx, .pptx, .xlsx
Dados e configuração .json, .csv, .log, .yaml, .yml.xml, .ini, .conf, .env
Web e rede .html, .har
Código e scripts .ts, .js, .py, .sh, .sql, .kql
Infraestruturas .bicep, .tf

Limites: 10 MB por ficheiro · 50 MB no total por mensagem · 5 ficheiros por mensagem

Carregamento de Configurações de Conhecimento

Para persistir documentos para o seu agente consultar em futuras conversas, carregue ficheiros através das definições do Builder → Knowledge → Adicionar ficheiro. O sistema indexa ficheiros carregados para pesquisa semântica.

Categoria Extensões
Images .png, .jpg, .jpeg.gif, .webp, .bmp, .tiff, .tif
Documents .txt, .md, .pdf, .docx, .pptx.xlsx, .doc, .ppt, .xls
Dados e configuração .json, .csv, .log, .yaml, .yml, .xml, .ini, .conf, .cfg, .config, .properties

Limites: 16 MB por ficheiro · 100 MB por upload

Carregamentos de pastas

Para carregar todos os ficheiros suportados de uma só vez, arraste uma pasta inteira para a zona de upload. Este processo inclui ficheiros em subpastas aninhadas. O portal extrai automaticamente todos os ficheiros da hierarquia de pastas e filtra os tipos de ficheiros não suportados.

Como funcionam os uploads de pastas:

  1. O sistema extrai todos os ficheiros das subpastas aninhadas para uma lista plana.
  2. O sistema inclui apenas ficheiros com extensões suportadas e filtra silenciosamente tipos não suportados.
  3. O sistema desduplica ficheiros com nomes duplicados de subpastas diferentes e mantém apenas o primeiro ficheiro.
  4. O sistema carrega e indexa cada ficheiro individualmente para pesquisa.

Observação

Os ficheiros carregados aparecem como documentos individuais nas fontes de Conhecimento. A hierarquia original das pastas não é mantida. Um ficheiro em runbooks/networking/dns-troubleshooting.md aparece como dns-troubleshooting.md.

Os carregamentos das definições de conhecimento aceitam formatos antigos do Office (.doc, .ppt, .xls) e formatos de imagem adicionais (.bmp, .tiff, .tif) que os anexos do chat não aceitam. Os anexos de chat suportam código, scripts, infraestrutura e formatos web que as definições de conhecimento não suportam.

Documentos gerados por agentes

Quando o seu agente cria documentos durante as conversas (usando a ferramenta Upload Knowledge Document), gera arquivos .md ou .txt e guarda diretamente nas configurações de Knowledge. Este processo acontece quando pede ao seu agente para "guardar como um manual de operações".

Exemplo: captar o conhecimento do incidente

Durante uma investigação de incidente, pergunte ao seu agente:

We just resolved the high CPU issue on web-app-prod. It was caused by a
memory leak in the connection pool. Create a troubleshooting guide from
what we learned and upload it to Knowledge settings.

O seu agente gera um guia estruturado de resolução de problemas com:

  • Passos de definição: Como identificar o problema.
  • Mitigações rápidas: Ações imediatas para reduzir o impacto.
  • Análise da causa raiz: O que investigar.
  • Passos de resolução: A solução que resultou.
  • Prevenção: Como evitar recorrências.

Da próxima vez que ocorrer um problema semelhante no CPU, o seu agente refere automaticamente este documento durante a investigação, transformando a experiência de um engenheiro em conhecimento partilhado da equipa.

O que precisa

Requisito Detalhes
Versão do agente 26.1.57.0 ou posterior
Definições de conhecimento Ativado no seu agente
Permissões de escrita O seu agente precisa de acesso por escrita às definições de Conhecimento
Modo de execução Revisão ou Autónomo. As ações de escrita requerem aprovação no modo de Revisão.

Limits

Attribute Anexos de chat Carregamento de Configurações de Conhecimento Ferramenta de agente
Tamanho máximo do ficheiro 10 MB 16 MB 16 MB
Total máximo 50 MB por mensagem 100 MB por upload N/A
Ficheiros máximos 5 por mensagem Sem limite (tamanho total limitado a 100 MB) 1 por ação
Upload da pasta Não suportado ✓ Arraste pastas para carregar todos os ficheiros de uma vez Não suportado
Extensões suportadas 31 28 2 (.md, .txt)
Caracteres de nomes de ficheiro N/A Letras, números, hífens, sublinhados, pontos Mesma
Comprimento máximo do nome do ficheiro N/A 1.024 caracteres Mesma

Quando usar outra coisa

Scenario Abordagem melhor
Ligar conteúdo wiki ao vivo que se mantém sincronizado Conhecimento da Wiki ADO
Carregamento de ficheiros binários (PDF, Word, imagens) Carregar através das definições de Conhecimento do Builder → → Adicionar ficheiro
Importação em massa de muitos documentos ao mesmo tempo Carregar vários ficheiros através das definições do Builder → Knowledge → Adicionar ficheiro
Manter os repositórios de código atualizados automaticamente Ligue um conector GitHub ou ADO
Capacidade O que acrescenta
Conhecimento da wiki ADO Liga conteúdo wiki ao vivo que se atualiza automaticamente
Análise de causa raiz Investigue questões e recolha as conclusões