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.
Puoi aggiungere un Fabric data agent come strumento a un agente che costruisci in Microsoft Foundry. Dopo averlo connesso, l'agente Foundry invoca l'agente dati di Fabric per rispondere a domande basate sui dati aziendali archiviati in Fabric OneLake.
Questo articolo riguarda l'osservabilità per quella configurazione. Quando costruisci un agente in Foundry e colleghi un data agent Fabric ad esso, vuoi vedere cosa ha fatto l'agente dati su ogni richiesta, non solo la risposta finale. Foundry Observability ti offre questa visibilità. I log e le tracce del data agent vengono inviati nella stessa destinazione in cui il tuo Foundry agent invia già i dati, così puoi seguire una richiesta dall'inizio alla fine: dal Foundry agent, al Fabric data agent, fino alle fonti dati che ha interrogato.
Il resto di questo articolo spiega dove è memorizzata quella telemetria, come ci arriva, come leggerla, chi può vederla e come controllarla.
Per una panoramica generale, vedi Osservabilità nell'IA generativa . Per collegare un agente dati Fabric a Foundry, vedi Consume a data agent in Microsoft Foundry.
Progetti di fonderia e approfondimenti applicativi
Un progetto Foundry è dove costruisci e gestisci i tuoi agenti. Foundry memorizza le tracce degli agenti in una risorsa Monitoraggio di Azure Application Insights e ogni progetto si collega a una di queste risorse.
In qualità di creatore dell'agente, configuralo una sola volta. Nel tuo progetto Foundry, apri la sezione Agenti , seleziona Tracce e seleziona Connetti. Puoi creare una nuova risorsa Application Insights o collegarne una già esistente. Dopo aver connesso la risorsa, Foundry attiva automaticamente il tracciamento lato server per il progetto. Non è necessario apportare modifiche al codice, e le tracce iniziano a fluire in pochi minuti.
La relazione è semplice: il progetto punta a una risorsa Application Insights e ogni agente in quel progetto invia lì le sue tracce. Il progetto definisce dove viene raccolta la telemetria; Application Insights è dove si trova e dove si può interrogare.
Puoi visualizzare le tracce nella scheda Tracce del tuo agente Foundry, oppure interrogarle direttamente nella risorsa collegata Application Insights. Il portale della Fonderia mostra tracce degli ultimi 90 giorni.
Per la configurazione passo dopo passo, vedi Configura il tracciamento per agenti AI in Microsoft Foundry.
Come i log e le tracce degli agenti dati Fabric raggiungono il tuo progetto
Per collegare un data agent Fabric a Foundry, lavora in un progetto Foundry. Se colleghi una risorsa Application Insights a quel progetto, l'agente dati Fabric invia i suoi log e tracce alla stessa risorsa. La telemetria del tuo agente Foundry e quella dell'agente dati Fabric confluiscono in un unico punto, così puoi leggerla insieme.
Il flusso funziona così:
- Nel tuo progetto Foundry, collega una risorsa Application Insights, come descritto nella sezione precedente.
- Aggiungi un Fabric data agent come strumento a un agente Foundry in quel progetto.
- Quando l'agente Foundry si avvia, chiama l'agente dati di Fabric per ottenere analisi dai dati aziendali in Fabric OneLake.
- Fabric valida la risorsa Application Insights collegata al progetto, poi invia i log e le tracce dell'agente dati ad essa.
- La telemetria dell'agente dati viene visualizzata accanto alle tracce del tuo agente Foundry, sia nella risorsa Application Insights collegata sia nella vista Traces dell'agente.
Il risultato è che il lavoro svolto dall'agente dati di Fabric entra a far parte della traccia della richiesta. Vedi che il tuo agente Foundry ha chiamato l'agente dati e vedi cosa ha fatto l'agente dati per produrre la sua risposta, inclusi quali fonti dati ha interrogato, quanto tempo ha impiegato ogni passaggio e se ogni passaggio ha avuto successo.
Leggi le tracce
Foundry Observability registra ogni richiesta come una traccia. Una traccia è costituita da campate, e ogni campata rappresenta un'unità di lavoro con il proprio orario, durata e stato di inizio. Gli span sono annidati, quindi leggere una traccia dall’alto verso il basso evidenzia il percorso della richiesta e dove è stato speso il tempo.
Un agente dati di Fabric aggiunge due tipi di span alla traccia:
- Agent span: l'esecuzione complessiva dell'agente dati Fabric per una singola richiesta.
- Span dello strumento: una singola fonte di dati o uno strumento che l'agente dati invoca per rispondere alla richiesta. Una richiesta può produrre più di un intervallo di strumenti.
Il seguente esempio mostra un agente Foundry che chiama un agente dati Fabric, che interroga due sorgenti dati per rispondere alla domanda:
Request (trace)
└─ Foundry agent run
└─ Fabric data agent (called as a tool)
└─ Agent span Overall run of the Fabric data agent
├─ Tool span First data source the data agent queried
└─ Tool span Second data source the data agent queried
La tabella seguente descrive ogni livello della traccia e il tipo di metadati ad essa associati.
| livello | Emesso da | Rappresenta | Metadati di esempio |
|---|---|---|---|
| Esecuzione dell'agente Foundry | Fonderia | L'agente Foundry che gestisce la richiesta dell'utente | ID conversazione, stato, durata |
| Fabric data agent (chiamata allo strumento) | Fonderia | Il punto in cui l'agente Foundry chiama l'agente dati di Fabric | Nome visualizzato dell'agente, stato, durata |
| Intervallo dell'agente | Agente dei dati di Fabric | L'esecuzione completa dell'agente dati di Fabric per la richiesta | Nome visualizzato dell'agente, ID della conversazione, stato, durata |
| Intervallo utensile | Agente dei dati di Fabric | Ogni sorgente di dati o strumento che l'agente dati chiama per rispondere | Nome della fonte dati, ID del passaggio di ragionamento, stato, durata |
Con questa struttura, puoi rispondere alle domande che contano quando qualcosa non quadra:
- Quando una risposta è lenta, la durata di ogni campata mostra quale passo ha impiegato più tempo.
- Quando una risposta è sbagliata, lo strumento mostra quali fonti di dati sono state interrogate e in quale ordine.
- Quando una richiesta fallisce, lo stato di ogni span mostra dove si è verificato il guasto.
Chi può vedere i registri e le tracce
La risorsa Application Insights che memorizza i log e le tracce dell'agente dati regola l'accesso. Chiunque abbia accesso a quella risorsa può vedere la telemetria. Collegare una risorsa a un progetto non concede l'accesso ai dati che contiene.
| Dove visualizzi i dati | Accesso obbligatorio |
|---|---|
| Application Insights | Un ruolo con permessi di lettura sulla risorsa connessa Application Insights, come Monitoring Reader o Log Analytics Reader |
| Progetto Microsoft Foundry | Autorizzazioni di lettura sulla risorsa Application Insights connessa, oltre a un ruolo di progetto Foundry pari o superiore a Foundry User |
L'accesso a un progetto Foundry da solo non include l'accesso alla telemetria. È sempre necessario il permesso di lettura sulla risorsa Application Insights.
Impostazione del tenant per i metadati operativi
Un'impostazione del tenant nel portale di amministrazione di Fabric controlla se gli agenti dati di Fabric inviano metadati operativi per l'osservabilità in Foundry. L'impostazione è attivata per impostazione predefinita.
L'impostazione invia solo metadati operativi. Questi metadati includono nomi di visualizzazione degli agenti, nomi delle sorgenti dati, ID dei passaggi di ragionamento e ID delle conversazioni. Fabric non invia alcun contenuto ai clienti. I prompt degli utenti e le risposte degli agenti dati rimangono entro i limiti di conformità di Fabric e non sono inclusi in questa telemetria.
Note
Un amministratore Fabric può disattivarlo per il tenant. Le modifiche alle impostazioni degli inquilini possono richiedere fino a un'ora per entrare in vigore.
L'ambientazione è la seguente.
Gli agenti dati Fabric possono inviare metadati operativi per l'osservabilità in Microsoft Foundry
I creatori di agenti possono utilizzare i metadati operativi per monitorare lo stato degli agenti, rilevare problemi e comprendere come i loro agenti pubblicati vengano utilizzati tra applicazioni e servizi. Queste intuizioni aiutano i creatori di agenti a migliorare l'affidabilità e le prestazioni degli agenti.
Quando attivi questa impostazione, gli agenti dati Fabric inviano metadati operativi a una risorsa Application Insights configurata per l'elaborazione e l'archiviazione. Questi dati includono nomi di visualizzazione degli agenti, nomi delle sorgenti dati, ID dei passaggi di ragionamento e ID delle conversazioni. La risorsa Application Insights che elabora e memorizza questi dati potrebbe trovarsi al di fuori della regione geografica del tuo tenant, del confine di conformità o dell'istanza cloud nazionale.
Per accedere ai metadati operativi, è necessario un ruolo con permessi di lettura (come Monitoring Reader o Log Analytics Reader) sulla risorsa configurata Application Insights. Gli utenti con questo accesso possono visualizzare i dati in Application Insights. Gli utenti possono anche visualizzare i dati tramite un progetto Foundry che si collega alla risorsa configurata Application Insights. L'accesso tramite Foundry richiede l'accesso basato sui ruoli al progetto Foundry (Foundry User o superiore) oltre ai permessi di lettura sulla risorsa Application Insights. L'accesso a un progetto Foundry da solo non include l'accesso ai dati di telemetria.
Importante
La risorsa Application Insights che memorizza questi metadati potrebbe trovarsi al di fuori della regione geografica, del confine di conformità o dell'istanza cloud nazionale del tuo tenant. Rivedi i requisiti di residenza e conformità dei dati prima di lasciare l'impostazione attiva.