Anexos de ficheiros no Azure SRE Agent

Ao usar anexos de ficheiros, pode partilhar capturas de ecrã, ficheiros de registo, ficheiros de configuração e documentos diretamente no chat do seu Agente Azure SRE. O agente aplica automaticamente a análise correta com base no tipo de ficheiro: visão multimodal para imagens, ferramentas de espaço de trabalho para texto e código, e Python para documentos binários.

Sugestão

  • Arraste e largue arquivos, utilize o seletor de arquivos ou cole capturas de ecrã diretamente no chat.
  • O agente aplica automaticamente a análise correta: visão multimodal para imagens, ferramentas de espaço de trabalho para texto e código, e Python para documentos binários.
  • Suporta imagens, texto, ficheiros de dados, documentos e arquivos (37 tipos de ficheiros no total).
  • Até cinco ficheiros por mensagem, 10 MB cada, 50 MB no total por mensagem.

O problema

Durante a triagem de incidentes, os SREs precisam de partilhar o contexto visual com o agente, incluindo um painel Grafana que mostre um pico de latência, uma captura de ecrã de erro do portal Azure ou um ficheiro de registo com o rastreio de pilha relevante. Com o chat apenas de texto, os utilizadores têm de descrever o que veem ou copiar e colar texto bruto, perdendo o contexto visual que muitas vezes contém a perceção diagnóstica.

A revisão de configuração tem as mesmas dificuldades. Quando pedes ao agente para rever um manifesto Kubernetes ou um modelo Bicep, copias e colas o conteúdo do ficheiro no chat, perdendo o contexto da sintaxe e os metadados do ficheiro. Os ficheiros de registo são truncados. Documentos binários, como PDFs de análise de incidentes, não podem ser partilhados de forma alguma.

Como funciona

Podes anexar ficheiros às tuas mensagens de chat usando três métodos: o seletor de ficheiros, arrastar e largar, ou colar na prancheta.

Seletor de arquivos

Selecione o + botão (mais) ao lado da entrada da mensagem e selecione Anexar ficheiro. Abre uma caixa de diálogo de ficheiros do sistema onde pode selecionar um ou mais ficheiros.

Captura de ecrã do menu plus a mostrar a opção Anexar ficheiro com um ícone de clipe de papel no fundo do menu.

Arrastar e soltar

Arraste ficheiros do teu ambiente de trabalho ou gestor de ficheiros para a área de chat. Uma sobreposição semi-transparente com uma seta de upload parece confirmar o alvo do drop.

Cola de prancheta

Copia uma captura de ecrã para a tua área de transferência (Cmd+Shift+4 no macOS, Win+Shift+S no Windows) e, de seguida, cola-a (Cmd+V ou Ctrl+V) na entrada do chat. A imagem colada anexa-se automaticamente. A colagem de texto normal funciona normalmente e não é intercetada.

Pré-visualizações de ficheiros anexos

Os ficheiros anexados aparecem como ícones abaixo do campo de entrada da mensagem, mostrando o nome do ficheiro, o tamanho e uma pré-visualização em miniatura das imagens. Remova ficheiros individuais antes de enviar selecionando o botão X em cada comprimido.

Captura de ecrã de um anexo de ficheiro a mostrar um ícone de documento, nome do ficheiro grubify-runbook.md, tamanho do ficheiro 1,9 KB e botão para remover.

Como o agente processa diferentes tipos de ficheiros

O agente determina automaticamente como processar cada ficheiro com base no seu tipo.

Tipo de ficheiro Como o agente o processa Exemplo de caso de uso
Imagens (.png, .jpg, .jpeg, .gif, .webp, .svg) Enviado diretamente para o LLM para análise de visão multimodal Captura de ecrã de um painel de erros, diagrama de arquitetura
Texto e código (.txt, .md, .json, .csv, .log, .yaml, .yml, .xml) Guardado no espaço de trabalho do agente e lido com ferramentas de ficheiros Análise de ficheiros de registo, revisão de ficheiros de configuração, resultados de consulta
Documentos binários (.pdf, .docx, .pptx) Guardado no workspace e analisado usando ferramentas Python PDF pós-morte do incidente, documento manual de procedimentos
Arquivos (.zip, .gz, .tgz, .7z, .rar, .cab) Validado por extensão, tamanho e assinatura de ficheiro (bytes mágicos), depois guardado no espaço de trabalho do agente Pacote de registos de diagnóstico, conjunto de runbooks em pacote

As mensagens enviadas mostram cartões de ficheiro com o nome do ficheiro, tamanho e um link de download para que possas recuperar os ficheiros carregados mais tarde na conversa.

Captura de ecrã de uma mensagem de chat mostrando um ficheiro de runbook carregado com o agente a ler as 58 linhas e a fornecer uma resolução de problemas estruturada com base no conteúdo do runbook.

O que torna esta abordagem diferente

Os anexos de ficheiros oferecem capacidades que os distinguem das interações apenas de texto.

  • Deteção automática de tipos de ficheiros. Descarte qualquer ficheiro suportado e o agente determina a abordagem de processamento correta: visão para imagens, ferramentas de ficheiros para texto, Python para documentos binários. Não é necessário selecionar manualmente.

  • Integração nativa de prancheta. Durante a resposta a incidentes, a velocidade é importante. Faça uma captura de ecrã de um painel, cole no chat e pergunte "o que vês?" Toda a viagem de ida e volta demora segundos.

  • Persistência no espaço de trabalho. O espaço de trabalho do agente guarda ficheiros carregados durante toda a duração da thread. O agente pode consultá-los através de várias mensagens, executar ferramentas contra eles, e tu podes descarregá-los do histórico do chat. Para guardar um ficheiro permanentemente nas definições de conhecimento (onde é indexado e pesquisável em todos os tópicos), pergunte ao seu agente: "Guarde isto nas definições de conhecimento como [nome do ficheiro].md"

Antes e depois

A tabela seguinte compara fluxos de trabalho comuns com e sem anexos de ficheiros.

Scenario Antes Depois de
Partilhar uma captura de ecrã Descreva o gráfico verbalmente ou cole um URL Deixa a captura de ecrã no chat. O agente analisa-o visualmente.
Rever um ficheiro de registo Copiar e colar texto, perde a formatação Carrega o ficheiro .log. O agente analisa-o com ferramentas.
Revisão do ficheiro de configuração Copiar e colar YAML/JSON no chat Carregar o ficheiro. O agente lê-o com todo o contexto.
Referência do livro de instruções Recordar etapas da memória durante incidentes Carrega o runbook. O agente acompanha e aplica-a à situação.
Documentos binários Não é possível partilhar PDFs ou documentos do Office Carrega diretamente. O agente usa Python para extrair conteúdo.

Introdução

Todos os agentes suportam anexos de ficheiros. Os novos agentes que crias através do assistente de configuração têm esta funcionalidade ativada por defeito.