Aggiungi Fabric data agent a un agente Foundry con Fabric IQ (anteprima)

Un data agent Fabric risponde a domande sui dati memorizzati in Microsoft Fabric OneLake. Un agente integrato in Microsoft Foundry può chiamare un data agent Fabric quando ha bisogno di risposte basate su dati aziendali in OneLake.

Questo articolo ti mostra come aggiungere un agente dati Fabric a un agente Foundry utilizzando lo strumento Fabric IQ (OneLake Catalog). Ogni passaggio avviene nel portale Microsoft Foundry. Puoi fare lo stesso anche nel codice, come descritto in Add a data agent usando il codice più avanti in questo articolo.

Cosa ti dà questa integrazione

Fabric IQ è la parte di Microsoft Fabric che rende i tuoi dati disponibili ad agenti e applicazioni. Un agente dati di Fabric pubblicato è uno degli elementi che Fabric IQ rende disponibili e che puoi aggiungere a un agente Foundry attraverso il catalogo OneLake.

Questo metodo si differenzia dal precedente in tre modi:

• Scegli gli agenti di dati da un elenco. Nel portale Foundry, il Catalogo OneLake mostra gli agenti dati pubblicati a cui hai accesso, per nome. Non è necessario prima cercare un ID di spazio di lavoro o un ID di artefatto.
• Puoi aggiungere più di un data agent. Un singolo agente Foundry può chiamare diversi data agent, così da poter attingere a più di un'area dei dati aziendali. Il metodo precedente ne permetteva solo uno.
• Ogni data agent è esposto come endpoint del Model Context Protocol. Il Model Context Protocol è uno standard aperto su come un agente chiama uno strumento. I tuoi Fabric data agent appaiono all'agente Foundry come strumenti che può chiamare, nello stesso modo in cui chiama qualsiasi altro strumento.

Per il metodo descritto in precedenza, che connette un singolo data agent tramite l'ID dell'area di lavoro e l'ID dell'artefatto, consulta Consume a data agent in Microsoft Foundry.

Prerequisites

• Una capacità Fabric a pagamento di livello F2 o superiore, oppure una capacità Power BI Premium per capacità di livello P1 o superiore con Microsoft Fabric abilitato.
• Uno spazio di lavoro in una regione che supporta l'intero stack Fabric. Fabric IQ non è disponibile nelle aree in cui Power BI è l'unico carico di lavoro Fabric. Per altre informazioni, si veda Disponibilità di Fabric a livello di area.
• Elaborazione cross-geo e archiviazione cross-geo abilitate per l'IA, in base ai requisiti descritti in Impostazioni del tenant di Fabric Data Agent.
• Almeno una di queste fonti di dati, con dati: un magazzino, una casa al lago, un modello semantico Power BI, un database KQL o un database speculare. È necessario disporre dell'accesso in lettura all'origine dati.
• Un progetto Foundry con un modello già implementato. Per crearne uno, vedere Creare un progetto.

Prima di iniziare

Controlla i seguenti elementi prima di aggiungere un agente dati Fabric a un agente Foundry:

• L'agente dati funziona. Conferma che l'agente di dati risponda alle domande come previsto in Fabric.
• L'agente dati è stato pubblicato. Solo gli agenti dati Fabric pubblicati compaiono nel catalogo OneLake. Per crearne e pubblicare uno, vedi Crea un agente dati Fabric.
• Entrambi gli agenti sono nello stesso inquilino. L'agente dati di Fabric e l'agente Foundry devono trovarsi nello stesso tenant.
• Usi lo stesso account. Accedi a Microsoft Fabric e Microsoft Foundry con lo stesso account.
• Hai i permessi giusti. È necessario disporre almeno dell'accesso in lettura al data agent di Fabric, dell'accesso in lettura alle relative origini dati sottostanti e dell'autorizzazione a creare e modificare agenti nel tuo progetto di Foundry. Per maggiori informazioni sui permessi degli agenti dati, vedi Fabric data agent sharing and permission management.

Ruoli in Microsoft Foundry

Microsoft Foundry utilizza il controllo degli accessi basato sui ruoli. La tabella seguente mostra il ruolo che ti serve per ogni compito. Per altre informazioni, vedere Controllo degli accessi in base al ruolo per Microsoft Foundry.

Come funziona

1. Un utente fa una domanda al tuo agente Foundry.
2. L'agente di Foundry decide se uno dei suoi agenti dati di Fabric può rispondere a questa domanda. Le istruzioni che scrivi guidano questa decisione.
3. L'agente Foundry chiama l'agente di dati Fabric.
4. L'agente dati interroga le sue fonti dati in Fabric OneLake e restituisce una risposta.
5. L'agente Foundry usa quella risposta per rispondere all'utente.

Le richieste vengono eseguite con l'identità configurata per la connessione. Per un agente dati Fabric, quella connessione utilizza l'autenticazione delegata dell'utente, quindi la richiesta viene eseguita come utente connesso e Fabric applica i permessi a quell'utente. Un utente riceve i risultati solo dai dati a cui ha accesso.

Passo 1: Crea un agente Foundry

Se hai già un agente, aprilo e vai al passo 2.

1. Accedere al portale di Microsoft Foundry e selezionare il progetto. Si arriva alla home page.

   

2. Nella navigazione in alto, seleziona Build, che elenca tutti gli agenti nel tuo progetto.

   

3. Seleziona la freccia accanto a Nuovo agente, poi seleziona Crea un agente.

   

4. Nella finestra di dialogo Crea un agente , inserisci un nome Agente che descriva ciò che fa l'agente, poi seleziona Create.

   

Il tuo nuovo agente si apre nella scheda Playground . Il pannello a sinistra è dove configuri l'agente, con sezioni per Modello, Istruzioni, Strumenti, Conoscenza e altro ancora. Il pannello a destra è la chat in cui puoi provarla. Il resto dei passaggi di questo articolo si svolge su questa scheda.

Passo 2: Aggiungi lo strumento Fabric IQ (OneLake Catalog)

1. Nella sezione Strumenti , seleziona Aggiungi e poi seleziona Sfoglia tutti gli strumenti.
2. Nella finestra di dialogo Seleziona uno strumento, nella scheda Configurato, seleziona Fabric IQ (OneLake Catalog).
3. Selezionare Aggiungi strumento.

Si apre il catalogo OneLake .

Passo 3: Filtra il catalogo per i data agent

Il catalogo OneLake elenca diversi tipi di articoli Fabric, quindi restringi prima la scelta.

1. Selezionare Filtro.
2. Sotto Tipo, seleziona Data agent.

L'elenco ora mostra solo gli agenti dati Fabric pubblicati. Per ognuno di essi vedi il suo Nome, la sua Posizione (lo spazio di lavoro che lo ospita), la sua Approvazione e l'etichetta di Sensibilità . Per restringere ulteriormente la lista, inserisci una parte di un nome in Filtra per parola chiave.

Due regole determinano cosa si vede in questa lista:

• L'agente dati deve essere pubblicato. Gli agenti di dati ancora in bozza non compaiono.
• Devi avere accesso all'agente dei dati. Se un collega ne ha costruita una e non te l'ha condivisa, non è nella tua lista.

Passo 4: Aggiungi un data agent

1. Nell'elenco filtrato, seleziona l'agente dati Fabric che vuoi che il tuo agente Foundry utilizzi.
2. Seleziona Aggiungi.

L'agente dati ora appare nella sezione Strumenti del tuo agente Foundry, elencato come Fabric IQ con il nome dell'agente dati tra parentesi.

Passo 5: Aggiungi più data agent

Aggiungi gli agenti dati uno alla volta. Per aggiungerne un'altra, ripeti dal Passo 2 al Passo 4. Apri di nuovo il Catalogo OneLake dalla sezione Strumenti e seleziona il prossimo data agent. Ciascuno compare come voce separata nell'elenco degli strumenti.

Aggiungi un agente dati per ogni area della tua azienda che deve essere coperta dall'agente Foundry. Ad esempio, un agente può detenere dati sulle vendite, un altro può detenere dati della catena di fornitura e un terzo può detenere dati di supporto clienti. Il tuo agente Foundry sceglie quindi quello giusto per ogni domanda.

Passo 6: Scrivi le istruzioni per il tuo agente

Il tuo agente Foundry deve sapere quando utilizzare ciascun agente di dati. Scrivi quella guida nella sezione Istruzioni .

Essere specifici. Nomina ogni data agent e indica quali tipi di domande dovrebbe gestire. Per esempio:

Usa l'agente dati di Contoso Sales per domande su ricavi, ordini e prodotti. Usa l'agente dati di supporto Contoso per domande su ticket di supporto e reclami dei clienti. Se una domanda richiede entrambi, chiama entrambi e combina i risultati.

Senza istruzioni chiare, l'agente potrebbe non chiamare affatto un data agent, o potrebbe chiamare quello sbagliato.

Passo 7: Aggiungi altri strumenti e fonti di conoscenza

Questo passaggio è facoltativo. Oltre ai tuoi Fabric data agent, puoi aggiungere altri strumenti nella sezione Strumenti e fonti di conoscenza nella sezione Conoscenza dello stesso agente. Aggiungi tutto ciò di cui l'agente ha bisogno per fare il suo lavoro.

Passo 8: Salva il tuo agente

Selezionare Salva nell'angolo in alto a destra.

Passo 9: Testa il tuo agente

Usa il pannello chat sul lato destro della scheda Playground per testare l'agente.

1. Invia una domanda a cui uno dei tuoi data agent dovrebbe rispondere, come ad esempio: Qual è stato il nostro prodotto più venduto il mese scorso?
2. Controlla la risposta. Conferma che utilizzi i dati che ti aspetti e che provengano dall'agente dati che intendevi.

Testa ogni data agent che hai aggiunto con almeno una domanda, e testa una domanda che richiede più di una. Se l'agente non chiama un data agent, rivedi le istruzioni che hai scritto nel Passo 6, salva e prova di nuovo.

Per vedere cosa ha fatto l'agente dati su ogni richiesta, inclusi quali fonti di dati ha interrogato e quanto tempo ha impiegato ogni passaggio, vedi Osservabilità per gli agenti dati Fabric in Microsoft Foundry.

Domande di lunga data

Alcune domande richiedono più tempo da un data agent per rispondere rispetto a una chiamata standard di strumento. Per consentire a quelle chiamate di terminare:

1. Nell'elenco Modello selezionare un modello che supporta la modalità in background, ad esempio gpt-5.4 o gpt-5.5.
2. Selezionare l'icona dei parametri accanto al modello e attivare la modalità Sfondo.

L'agente mostra quindi lo stato di avanzamento mentre l'agente dei dati lavora e restituisce la risposta al termine dell'esecuzione.

Aggiungi un data agent usando codice

I passaggi di questo articolo utilizzano il portale Foundry. Puoi fare la stessa cosa in codice con l'SDK di Python, C# o JavaScript, oppure con l'API REST. L'SDK Java non supporta Fabric IQ.

Due cose funzionano in modo diverso nel codice:

• Fornisci tu stesso l'endpoint. Non c'è alcun catalogo da consultare, quindi devi passare l'endpoint del Model Context Protocol dell'agente dati come server_url, nel formato seguente:

  https://{host}/v1/mcp/workspaces/{workspaceId}/dataagents/{dataAgentId}/agent

  Qui, {host} è l'host API di Fabric, di solito api.fabric.microsoft.com. Trova {workspaceId} e {dataAgentId} nel portale Microsoft Fabric: apri lo spazio di lavoro, seleziona l'agente dati e copia i due ID dalla barra degli indirizzi del browser.

• Fai riferimento a un collegamento con un progetto. Si passa l'ID risorsa della connessione del progetto Fabric IQ come project_connection_id. Crea prima quella connessione nel portale Foundry.

Per esempi di codice in ciascun linguaggio, vedi Connect agents to Microsoft Fabric with Fabric IQ.

Contenuti correlati

• Cos'è un Fabric data agent?
• Creare un agente dei dati di Fabric
• Condividi un agente dati Fabric
• Usare un agente dati in Microsoft Foundry
• Osservabilità per gli agenti dati di Fabric in Microsoft Foundry
• Collega gli agenti a Microsoft Fabric con Fabric IQ