Allegati di file nell'agente SRE di Azure

Usando gli allegati di file, è possibile condividere screenshot, file di log, file di configurazione e documenti direttamente nella chat dell'agente SRE di Azure. L'agente applica automaticamente l'analisi corretta in base al tipo di file: visione multimodale per le immagini, strumenti dell'area di lavoro per testo e codice e Python per i documenti binari.

Suggerimento

  • Trascina e rilascia i file, usa il selettore di file o incolla gli screenshot dal clipboard direttamente nella chat.
  • L'agente applica automaticamente l'analisi corretta: visione multifunzionale per immagini, strumenti dell'area di lavoro per testo e codice e Python per documenti binari.
  • Supporta immagini, testo, file dati, documenti e archivi (37 tipi di file in totale).
  • Fino a cinque file per messaggio, 10 MB ciascuno, 50 MB totali per messaggio.

Problema

Durante il triage degli incidenti, gli SRE devono condividere il contesto visivo con l'agente, inclusa una dashboard Grafana che mostra un picco di latenza, uno screenshot di errore dal portale di Azure o un file di log con il relativo stack trace. Con la chat di solo testo, gli utenti devono descrivere ciò che vedono o copiano e incollano testo non elaborato, perdendo il contesto visivo che spesso contiene le informazioni di diagnostica.

La verifica della configurazione presenta la stessa difficoltà. Quando si chiede all'agente di esaminare un manifesto Kubernetes o un modello Bicep, si copiano e incollano i contenuti del file nella chat, perdendo così il contesto di sintassi e i metadati dei file. I file di log vengono ridotti. I documenti binari come i PDF postmortem degli incidenti non possono essere condivisi affatto.

Come funziona

È possibile allegare file ai messaggi chat usando tre metodi: selettore file, trascinamento della selezione o incollare dagli Appunti.

Selezione file

Selezionare il + pulsante (più) accanto all'input del messaggio e selezionare Allega file. Viene visualizzata una finestra di dialogo file di sistema in cui è possibile selezionare uno o più file.

Screenshot del menu plus che mostra l'opzione Allega file con un'icona di graffetta nella parte inferiore del menu.

Trascinamento della selezione

Trascinare i file dal desktop o dal file manager nell'area di chat. Viene visualizzata un overlay semitrasparente con una freccia di caricamento per confermare l'area di destinazione del rilascio.

Incollare dagli Appunti

Copia uno screenshot negli Appunti (Cmd+Shift+4 su macOS, Win+Shift+S su Windows) e quindi incollalo nel campo di testo della chat (Cmd+V o Ctrl+V). L'immagine incollata viene collegata automaticamente. L'incollaggio del testo normale avviene normalmente e non viene intercettato.

Anteprime di file allegati

I file allegati vengono visualizzati come pillole sotto l'input del messaggio, mostrando il nome file, le dimensioni e un'anteprima delle immagini. Rimuovere singoli file prima dell'invio selezionando il pulsante X in ogni pillola.

Screenshot di un allegato file che mostra un'icona del documento, il nome del file grubify-runbook.md, la dimensione del file di 1,9 KB e il pulsante di rimozione.

Modalità di elaborazione dei diversi tipi di file da parte dell'agente

L'agente determina automaticamente come elaborare ogni file in base al tipo.

Tipo di file Come l'agente lo elabora Esempio di caso d'uso
Immagini (.png, .jpg, .jpeg, .gif, .webp, .svg) Inviato direttamente all'LLM per l'analisi della visione multimodale Schermata di un dashbaord degli errori, diagramma architettura
Testo e codice (.txt, .md, .json, .csv, .log, yaml, .yml, .xml) Salvato nell'area di lavoro dell'agente e letto con gli strumenti per la gestione dei file Analisi dei file di log, revisione dei file di configurazione, risultati delle query
Documenti binari (.pdf, .docx, .pptx) Salvato nell'area di lavoro e analizzato con gli strumenti Python PDF postmortem incidente, documento del runbook
Archivi (.zip, .gz, .tgz, .7z, .rar, .cab) Validato tramite estensione, dimensione e firma del file (magic bytes), poi salvato nello spazio di lavoro dell'agente Pacchetto di log diagnostico, set di runbook confezionato

I messaggi inviati visualizzano schede di file con il nome del file, le dimensioni e un collegamento di download in modo da poter recuperare i file caricati in un secondo momento nel thread.

Screenshot di un messaggio chat che mostra un file runbook caricato con l'agente che legge tutte le 58 righe e fornisce una risoluzione dei problemi strutturata in base al contenuto del runbook.

Cosa rende questo approccio diverso

Gli allegati offrono funzionalità che le distinguono dalle interazioni solo testo.

  • Rilevamento automatico dei tipi di file. Lascia cadere qualsiasi file supportato e l'agente determina il giusto approccio di elaborazione: visione per le immagini, strumenti per file per il testo, Python per i documenti binari. Non è necessaria alcuna selezione manuale.

  • Integrazione nativa del clipboard. Durante la risposta agli eventi imprevisti, la velocità è importante. Acquisire uno screenshot di un dashboard, incollarlo nella chat e chiedere "cosa vedi?" L'intero ciclo richiede solo pochi secondi.

  • Persistenza dell'area di lavoro. L'area di lavoro agente salva i file caricati per la durata del thread. L'agente può farvi riferimento tra più messaggi, eseguire strumenti su di essi ed è possibile scaricarli dalla cronologia delle chat. Per salvare un file in modo permanente nelle impostazioni di knowledge base (in cui è indicizzato e ricercabile in tutti i thread) chiedere all'agente: "Salva in impostazioni della knowledge base come [nomefile].md"

Prima e dopo

La tabella seguente confronta i flussi di lavoro comuni con e senza allegati di file.

Scenario Prima Dopo
Condivisione di uno screenshot Descrivere il grafico verbalmente o incollare un URL Trascina lo screenshot nella chat. L'agente lo analizza visivamente.
Revisione di un file di log Copiare e incollare il testo, perdere la formattazione Carica il file .log. L'agente lo analizza con gli strumenti.
Revisione del file di configurazione Copiare e incollare YAML/JSON nella chat Carica il file. L'agente lo legge con tutto il contesto.
Informazioni di riferimento sul runbook Richiamare passaggi dalla memoria durante gli incidenti Carica il runbook. L'agente lo segue e lo applica alla situazione.
Documenti binari Non è possibile condividere pdf o documenti di Office Carica direttamente. L'agente utilizza Python per estrarre i contenuti.

Inizia subito

Tutti gli agenti supportano gli allegati ai file. I nuovi agenti creati tramite l'installazione guidata hanno questa funzionalità abilitata per impostazione predefinita.