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.
L'ontologia fornisce un contesto aziendale regolato a un agente dati Fabric. Descrive entità aziendali, le loro proprietà e relazioni, definizioni, sinonimi, mappe e legami con fonti di dati sottostanti.
L'agente dati utilizza questo contesto per interpretare una domanda e identificare una fonte dati sottostante rilevante. Successivamente genera una query SQL, KQL o DAX nativa dell'origine dati, esegue la query su tale origine dati e visualizza il risultato.
L'ontologia è una fonte di contesto in questa integrazione. Fornisce un significato semantico ma non è l'endpoint per l'esecuzione della query.
Importante
Questa funzionalità si trova in Anteprima.
Importante
Per la migliore esperienza nell'uso del contesto Ontology, usa il runtime di anteprima.
Come funziona il contesto ontologico
L'integrazione separa il contesto semantico, l'orchestrazione e l'esecuzione delle query:
- L'ontologia fornisce significato semantico. Definisce le entità aziendali in un dominio, le loro proprietà, come si relazionano, il linguaggio che le persone usano per descriverle e come si mappano ai dati fisici.
- L'agente dati di Fabric interpreta e orchestra. Applica il contesto ontologico pertinente alla domanda dell'utente, seleziona una fonte sottostante e genera una query source-native appropriata.
- La sorgente di dati sottostante esegue la query. Il sorgente esegue la query SQL, KQL o DAX generata con i permessi dell'utente.
Ad esempio, un'ontologia di una compagnia aerea potrebbe definire entità di membro dell'equipaggio, volo, aeroporto e vettore e le relazioni tra di esse. Un utente può porre una domanda utilizzando tali termini aziendali senza conoscere le tabelle, le colonne o le operazioni di join nell’origine dati sottostante.
Aggiungi Ontologia come fonte di contesto
Per aggiungere un contesto di Ontologia a un data agent:
- Apri l'agente dati Fabric.
- Nell'esperienza Fonti, seleziona Aggiungi sorgenti.
- Seleziona Aggiungi un'ontologia.
- Scegli l'Ontologia che vuoi che l'agente dati utilizzi.
- Espandi l'Ontologia per esaminarne i tipi di entità e le fonti di dati dell'ontologia associate.
L'agente dati carica una rappresentazione di sola lettura del contesto dell'Ontologia. Le sorgenti associate sottostanti forniscono gli schemi e i dati che l'agente può interrogare.
Configurazioni supportate per le sorgenti sottostanti
La maggior parte delle configurazioni semantiche, incluse definizioni di entità, sinonimi, relazioni, mappe e legami, risiede nell'Ontologia. Puoi integrare questo contesto governato configurando le sorgenti sottostanti idonee associate all'Ontologia.
Devi montare una sorgente dati sottostante idonea nell'agente dati prima di poter aggiungere configurazioni come istruzioni per la sorgente dati, una descrizione della sorgente dati ed esempi di query. Queste configurazioni specifiche per l'agente dati sono utilizzate solo dall'agente dati. Non vengono né salvati né riscritti nell'Ontologia.
Istruzioni sull'origine dati
Le istruzioni per la sorgente dati forniscono indicazioni che l'agente dati applica quando genera una query per una specifica fonte sottostante. Usa queste istruzioni per identificare tabelle autorevole, spiegare i percorsi di join e la semantica delle date, definire i filtri richiesti o specificare regole di business specifiche per la sorgente.
Mantieni le istruzioni focalizzate su come interrogare la fonte. Per modificare definizioni aziendali condividete, sinonimi, relazioni tra entità, mappe o binding, aggiorna invece l'Ontologia.
Descrizione origine dati
Una descrizione di una sorgente dati riassume i dati contenuti da una fonte sottostante e i tipi di domande a cui può rispondere. L'agente dati utilizza questa descrizione per determinare quando la sorgente è rilevante per la domanda dell'utente.
Interrogazioni di esempio
Le query di esempio abbinano una domanda in linguaggio naturale con la query nativa della sorgente attesa. Usali per dimostrare schemi di query che potrebbero essere difficili da dedurre solo dal contesto dello schema e dell'ontologia, come join complessi, filtri, esclusioni e aggregazioni.
Aggiungi esempi che rappresentino domande che gli utenti probabilmente porranno e verifica che ogni query restituisca il risultato atteso. L'agente dati recupera esempi rilevanti quando genera una query per la sorgente sottostante.
Il supporto per istruzioni di sorgente dati, descrizioni di sorgenti dati e query di esempio dipende dal tipo di sorgente sottostante. Per il supporto alla configurazione per fonte dati, vedi Aggiungi e configura sorgenti dati in un agente dati Fabric. Per indicazioni generali, vedi Configura il tuo data agent.
Eseguire il debug di una risposta
Se una risposta è errata, incompleta o fallisce, si ricontrolla i passaggi di esecuzione e il contesto di Ontology scaricato per identificare dove si è verificato il problema.
Rivedi i passaggi di corsa
I passaggi di esecuzione mostrano come l'agente dati ha elaborato la domanda e interagito con la fonte sottostante.
- Esegui di nuovo la domanda nell’esperienza di test dell’agente dati.
- Apri i passaggi di esecuzione e identifica la sorgente sottostante selezionata per la domanda.
- Rivedi la query SQL, KQL o DAX generata e eventuali errori restituiti dalla sorgente sottostante.
- Esegui o ispeziona la query generata sulla sorgente sottostante per verificare se restituisce i dati attesi.
Esamina il contesto dell'ontologia scaricata
Il contesto dell'Ontologia scaricato è una rappresentazione leggibile e in sola lettura dei metadati semantici disponibili all'agente dati.
- Apri il menu delle altre opzioni dell'Ontologia, poi seleziona Scarica contesto dell'ontologia.
- Esamina il contesto scaricato per confermare che l'agente dati abbia ricevuto le entità, proprietà, relazioni, definizioni, sinonimi, mappe e binding attesi.
- Se il contesto scaricato non riflette le modifiche recenti dell'ontologia, seleziona Aggiorna e poi prova di nuovo la domanda.
Usa questi dettagli per isolare la fonte del problema:
| Cosa si osserva | Controlli da eseguire |
|---|---|
| L'agente dati seleziona la fonte sottostante sbagliata. | Confermare che le mappe e i binding dell'Ontologia associno le entità rilevanti alla fonte prevista. Rivedere le descrizioni e le istruzioni delle fonti di dati supplementari. |
| La query generata utilizza una tabella, una colonna, una proprietà o un filtro inaspettati. | Confronta la query con il contesto dell'Ontologia scaricato. Verifica le definizioni di entità, i sinonimi, le relazioni, le mappature e i binding nell'Ontologia. |
| La query generata è corretta, ma il risultato è sbagliato o vuoto. | Esegui la query sulla fonte sottostante e verifica i dati della sorgente e i tuoi permessi. |
| La risposta non riflette un recente aggiornamento di Ontology. | Aggiorna il contesto dell'Ontologia nell'agente dati e poi ripeti la domanda. |
| L'esecuzione delle query fallisce. | Rivedi l'errore nella fase di esecuzione e convalida la query generata in base all'origine dati selezionata. |
Non puoi modificare il contesto scaricato per cambiare il comportamento dell'agente. Apporta modifiche all'elemento Ontologia, aggiorna il suo contesto nell'agente dati e poi ritesta la risposta.
Permissions
Importante
L'agente dati esegue una query generata utilizzando i permessi dell'utente richiedente sulla sorgente dati sottostante selezionata. Gli utenti hanno bisogno di accedere agli oggetti Ontologici rilevanti e agli oggetti dati sottostanti necessari per rispondere alle loro domande.
La condivisione di un agente dati non comporta l'accesso alle relative origini dati sottostanti. Per indicazioni generali sulla condivisione, vedi Share a Fabric data agent.
Limitations
Considera le seguenti limitazioni durante l'anteprima:
- Solo le fonti sottostanti idonee supportano istruzioni, descrizioni ed esempi di domande supplementari per le fonti di dati.
- I modelli semantici di Power BI non supportano un contesto supplementare specifico per agenti dati. Quando selezioni un modello semantico come sorgente sottostante, il processo di generazione delle query potrebbe non utilizzare un contesto di Ontologia.
- I linguaggi di query nativi dell'origine dati documentati sono SQL, KQL e DAX.
- L'agente dati recupera l'ultimo contesto dell'Ontologia ogni 10 minuti, quindi una modifica come l'aggiunta di un'entità può impiegare fino a 10 minuti ad apparire a meno che tu non aggiorni manualmente il contesto.
- L'esperienza iniziale non supporta la selezione di entità all'interno di un'ontologia.