Carregar documentos de conhecimento no agente SRE do Azure

Dica

  • Seu agente cria e carrega runbooks durante conversas sem gerenciamento manual de arquivos.
  • Anexe 31 tipos de arquivo no chat, incluindo .kql, .bicep, .tf, .har, , .pye .xlsx, para contexto de análise imediata.
  • Fazer upload de 28 tipos de arquivo nas configurações do Knowledge para armazenamento persistente e indexado em todas as conversas futuras
  • As resoluções de incidentes tornam-se conhecimentos institucionais automaticamente

O problema: o conhecimento morre com a conversa

Cada incidente que sua equipe resolve gera conhecimento valioso: o que deu errado, quais comandos o corrigiram e o que verificar primeiro na próxima vez. Mas esse conhecimento reside em threads de chat, na memória dos engenheiros e em retrospectivas que ninguém lê às 3 da manhã.

Sua equipe tem runbooks, mas eles se tornam obsoletos. A correção descoberta durante o incidente de ontem à noite? Está na cabeça de alguém, ou enterrada em uma conversa que some da vista antes da próxima semana. Na próxima vez que o mesmo problema ocorrer, um engenheiro diferente começará do zero.

Como seu agente resolve esse problema

Seu agente pode carregar documentos nas configurações de conhecimento durante as conversas usando a ferramenta Carregar Documento de Conhecimento . Quando seu agente descobre uma correção, cria um guia de solução de problemas ou sintetiza as descobertas de investigação, ele armazena esse conhecimento diretamente e o torna pesquisável para cada conversa futura.

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

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

Antes e depois

Antes Após
Captura de conhecimento Pós-incidente: engenheiro escreve o runbook (talvez) Seu agente captura a correção em tempo real
Hora de documentar Leva 30 a 60 minutos para escrever um runbook Segundos. Seu agente gera e carrega em linha.
Atualização de conhecimento Runbooks ficam obsoletos em questão de semanas As configurações de conhecimento se expandem com cada solução
Acessibilidade Conhecimento preso na cabeça do engenheiro ou na conversa de chat Pesquisável pelo seu agente em todas as conversas futuras
Consistência de formato Varia de acordo com o autor Documentação estruturada e consistente sempre

O que torna isso diferente

Ao contrário dos uploads manuais, seu agente cria conhecimento proativamente. Você não precisa se lembrar de documentar o que aprendeu porque seu 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 um problema semelhante ocorre meses depois, seu agente localiza o runbook relevante automaticamente por meio da recuperação inteligente, sem a necessidade de percorrer threads antigos.

Ao contrário dos conectores wiki, os documentos carregados não exigem serviços externos. O conhecimento reside diretamente nas configurações de conhecimento do agente, disponíveis instantaneamente sem atrasos de sincronização.

Como funciona

A ferramenta Carregar Documento de Conhecimento aceita três parâmetros:

Parâmetro Obrigatório Descrição
Nome do arquivo Sim Nome com .md ou .txt extensão (por exemplo, database-pool-runbook.md)
Conteúdo Sim Texto completo do documento no formato markdown ou texto sem formatação
Acionamento de indexação Opcional (padrão: true) Se o documento será pesquisável imediatamente

Quando o agente carrega um documento:

  1. Valida o nome do arquivo e o conteúdo (até 16 MB por arquivo).
  2. Armazena o documento nas configurações de Conhecimento do agente.
  3. Indexa o conteúdo da pesquisa semântica.
  4. Confirma o upload com uma mensagem de êxito.

Observação

Se já existir um documento com o mesmo nome de arquivo, o novo conteúdo o substituirá. Esse processo facilita a atualização do conhecimento do agente. Carregue com o mesmo nome para atualizar o conteúdo.

Formatos de arquivo com suporte

Seu agente manipula arquivos por meio de três métodos, cada um com suporte a formatos diferentes.

Anexos de chat

Arraste arquivos para qualquer chat para fornecer contexto imediato para análise ao seu agente – scripts de solução de problemas, arquivos de configuração, traços de rede e muito mais.

Categoria Extensões
Images .png, .jpg, .jpeg, .gif, .webp, , .svg
Documentos .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
Infraestrutura .bicep, .tf

Limites: 10 MB por arquivo · Total de 50 MB por mensagem · 5 arquivos por mensagem

Uploads de configurações de conhecimento

Para manter documentos para que seu agente faça referência em conversas futuras, carregue arquivos por meio das configurações do Builder → Knowledge → Adicionar arquivo. O sistema indexa arquivos carregados para pesquisa semântica.

Categoria Extensões
Images .png, .jpg, .jpeg, .gif, .webp, .bmp, , .tiff, , .tif
Documentos .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 arquivo · 100 MB por upload

Uploads de pastas

Para carregar todos os arquivos com suporte de uma só vez, arraste uma pasta inteira para a zona de carregamento. Esse processo inclui arquivos de dados em subpastas aninhadas. O portal extrai automaticamente cada arquivo da hierarquia de pastas e filtra tipos de arquivo sem suporte.

Como os uploads de pasta funcionam:

  1. O sistema extrai todos os arquivos das subpastas aninhadas em uma lista simples.
  2. O sistema inclui apenas arquivos com extensões com suporte e filtra silenciosamente tipos sem suporte.
  3. O sistema deduplica arquivos com nomes duplicados de subpastas diferentes e mantém apenas o primeiro arquivo.
  4. O sistema carrega e indexa cada arquivo individualmente para pesquisa.

Observação

Arquivos carregados aparecem como documentos individuais em fontes de conhecimento. A hierarquia de pasta original não é mantida. Um arquivo em runbooks/networking/dns-troubleshooting.md aparece como dns-troubleshooting.md.

As configurações de conhecimento aceitam formatos herdados do Office (.doc, .ppt, .xls) e formatos de imagem adicionais (.bmp, .tiff, .tif) que os anexos de chat não aceitam. Os anexos de chat dão suporte a códigos, scripts, infraestrutura e formatos de web que as configurações de conhecimento não suportam.

Documentos gerados pelo agente

Quando o seu agente cria documentos durante conversas (usando a ferramenta Carregar Documento de Conhecimento), ele gera arquivos .md ou .txt, e os salva diretamente nas configurações de conhecimento. Esse processo acontece quando você pede ao agente para "salvar isso como um runbook".

Exemplo: captura de conhecimento de incidentes

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.

Seu agente gera um guia de solução de problemas estruturado com:

  • Etapas de definição de escopo: como identificar o problema.
  • Mitigações rápidas: ações imediatas para reduzir o impacto.
  • Análise de causa raiz: o que investigar.
  • Etapas de resolução: a correção que funcionou.
  • Prevenção: como evitar a recorrência.

Na próxima vez que ocorrer um problema de CPU semelhante, seu agente referencia automaticamente este documento durante a investigação, transformando a experiência de um engenheiro em conhecimento compartilhado da equipe.

O que você precisa

Requisito Detalhes
Versão do agente 26.1.57.0 ou posterior
Configurações de conhecimento Habilitado em seu agente
Permissões de gravação Seu agente precisa de permissão de escrita nas configurações de conhecimento
Modo de execução Revisão ou Autônomo. As ações de escrita exigem aprovação no modo de revisão.

Limits

Attribute Anexos de chat Uploads de configurações de conhecimento Ferramenta de agente
Tamanho máximo de arquivo 10 MB 16 MB 16 MB
Total máximo 50 MB por mensagem 100 MB por upload N/A
Máximo de arquivos 5 por mensagem Sem limite (tamanho total limitado a 100 MB) 1 por ação
Upload de pasta Sem suporte ✓ Arrastar pastas para carregar todos os arquivos ao mesmo tempo Sem suporte
Extensões com suporte 31 28 2 (.md, .txt)
Caracteres de nome de arquivo N/A Letras, números, hifens, sublinhados, pontos Idêntico
Comprimento máximo do nome do arquivo N/A 1\.024 caracteres Idêntico

Quando usar outra coisa

Scenario Melhor abordagem
Conectando conteúdo wiki ao vivo que permanece em sincronia Conhecimento wiki do ADO
Carregando arquivos binários (PDF, Word, imagens) Carregar por meio das configurações de conhecimento do Construtor → Adicionar arquivo
Importação em massa de muitos documentos ao mesmo tempo Carregar vários arquivos por meio de Construtor → Configurações de Conhecimento → Adicionar arquivo
Manter os repositórios de código atualizados automaticamente Conectar um conector GitHub ou ADO
Capacidade O que ele adiciona
Conhecimento wiki do ADO Conectar conteúdo wiki ao vivo que é atualizado automaticamente
Análise de causa raiz Investigar problemas e capturar as descobertas