Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
[Questo articolo è una documentazione preliminare ed è soggetto a modifiche.]
Gli utenti possono allegare file a un messaggio così che l'agente possa leggere, riassumere o comunque ragionare su di essi per quel turno. Gli allegati sono un input fornito dall’utente a ogni turno, non una fonte di dati persistente configurata dal creatore.
Note
Le funzionalità di questo articolo sono alimentate dal harness GitHub Copilot, che utilizza Copilot Credits per la fatturazione basata sull'uso. Scopri di più sui Crediti Copilot in Panoramica della fatturazione per agenti alimentati dal GitHub Copilot harness.
La fatturazione basata sull'uso si applica all'utilizzo, alla costruzione, al test e alla valutazione degli agenti. Queste azioni potrebbero consumare crediti Copilot.
Attaccamenti vs. fonti di conoscenza
Attaccamenti e fonti di conoscenza sono concetti diversi. Scegli quello che si adatta al tuo scenario.
| Concetto | Chi lo fornisce | Ambito | Uso tipico |
|---|---|---|---|
| Allegato | L'utente finale, per messaggio | Una conversazione | "Riassumi questo contratto", "Cosa c'è in questa schermata?" |
| Origine delle conoscenze | Il costruttore, al tempo della progettazione | Ogni conversazione con l'agente | Documentazione politica, cataloghi di prodotti, articoli di aiuto |
Aggiungi una fonte di conoscenza quando l'agente dovrebbe sempre avere accesso agli stessi contenuti. Chiedi agli utenti di allegare un file quando il contenuto è unico per la loro richiesta.
Tipi di allegati supportati
| Tipo | Esempi | Note |
|---|---|---|
| Immagini | .png, .jpg, .gif, .webp | L'agente utilizza modelli con capacità di visione per descrivere o rispondere a domande sull'immagine. |
| Il testo viene estratto affinché l'agente possa ragionare. | ||
| Documenti di testo | .txt, .csv, .html, .md | Il contenuto viene passato all'agente come testo. |
| URLs | Qualsiasi URL HTTP o HTTPS pubblicamente raggiungibile | L'agente scarica il file collegato per il turno corrente (vedi il comportamento di download dell'URL più avanti in questo articolo). |
Dove gli utenti allegano file
Gli utenti possono allegare file in qualsiasi interfaccia in cui l'agente è in esecuzione:
- La scheda Anteprima in Copilot Studio, quando si testa l'agente. Scopri di più su Test un agente.
- Qualsiasi canale pubblicato che supporti allegati, come Microsoft Teams, Microsoft 365 Copilot e chat web.
L'utente seleziona l'icona dell'allegato nel compositore del messaggio, sceglie uno o più file, aggiunge un messaggio opzionale e invia il turno. L'agente riceve gli allegati insieme al messaggio.
Come l'agente elabora gli allegamenti
- L'agente legge ogni allegato quando elabora il messaggio. Gli allegati influenzano solo l'interazione con cui vengono inviati, a meno che l'agente non vi faccia nuovamente riferimento più avanti nella stessa conversazione.
- Se un allegato non può essere elaborato (ad esempio, un file non valido o un URL fallito), l'agente salta quell'allegato ed elabora il resto del messaggio. Il messaggio viene comunque inviato.
- Gli allegati non sostituiscono le fonti di conoscenza, la memoria o i risultati degli strumenti . Sono un ulteriore segnale che l'agente prende in considerazione per il turno corrente.
Allegati tramite URL
Quando un utente allega un URL, l'agente scarica il file presente a quell'URL e lo tratta come un allegato caricato dall'utente per quella interazione.
- Il download deve completarsi entro 30 secondi. Le risposte più lente vanno in timeout e l'URL viene ignorato in quel turno.
- L'URL deve essere raggiungibile pubblicamente dal servizio Microsoft. I link che richiedono l'accesso o che si trovano dietro un firewall non funzionano.
- Il messaggio continua a essere inviato anche se il download dell'URL fallisce.
Conservazione e limiti
Gli allegati vengono conservati per tutta la durata della conversazione, non solo per il turno attuale. Se un utente ha allegato un file in precedenza nella conversazione, l'agente può riconsultarlo in un turno successivo (ad esempio, "confronta questo con il file che ho inviato prima").
| Elemento | Limite |
|---|---|
| Dimensione dell'allegato (per file) | 16 MiB |
| Timeout per il download degli allegati URL | 30 secondi |
| Conservazione degli allegati (per conversazione) | 28 giorni dopo l'ultima attività nella conversazione |
| Comportamento di attaccamento in caso di fallimento | L'agente salta l'allegato fallito e continua a elaborare il messaggio |
Dopo la finestra di conservazione, gli allegati memorizzati vengono cancellati dalla conversazione e non sono più disponibili per l'agente da consultare. Questa stessa finestra di conservazione si applica a qualsiasi file creato dall'agente durante la conversazione.