Aggiungi tabelle Azure SQL come fonte di conoscenza

Quando integri le tabelle Azure SQL come fonte di conoscenza, fondi il tuo agente sui dati strutturati memorizzati nel tuo database Azure SQL. Il tuo agente può rispondere alle domande leggendo dalle tabelle selezionate, utilizzando le credenziali di connessione e i permessi disponibili per il creatore.

Note

Per aggiungere le tabelle Azure SQL come fonte di conoscenza, devi avere il permesso di accedere al database sottostante e alle tabelle. Permessi mancanti o insufficienti potrebbero impedire che server, database o tabelle siano visibili o selezionabili durante l'installazione.

Prerequisiti

• Un database SQL di Azure o Istanza gestita di SQL di Azure che la tua organizzazione può raggiungere da Power Platform.

• Credenziali che possono connettersi al database e leggere le tabelle che intendi aggiungere (ad esempio, Microsoft Entra ID o autenticazione SQL, a seconda di come è configurata la tua connessione).

• Accesso a Copilot Studio e permesso di modificare l'agente.

• L'accesso alla rete configurato in modo che Power Platform possa raggiungere il tuo server Azure SQL. Ad esempio, regole firewall che permettono servizi Azure o connettività privata come richiesto dalla tua organizzazione.

Permessi e autenticazione

La conoscenza Azure SQL utilizza la connessione SQL di Power Platform che crei o selezioni durante la configurazione. In tempo reale, l'agente si basa sull'autenticazione Microsoft dell'utente agente e sull'accesso concesso tramite quel percorso di connessione.

• Gli utenti ricevono risposte solo in base ai dati a cui il creatore può accedere tramite la connessione configurata e i permessi del database.

• Se le tabelle non compaiono durante la configurazione, verifica che la connessione abbia successo al di fuori di Copilot Studio e che l'account possa elencare e leggere quelle tabelle.

Prepara il tuo database Azure SQL

Gli agenti di Copilot Studio supportano database Azure SQL o SQL Server. Prima di aggiungere tabelle, assicurati che le tue tabelle abbiano la seguente configurazione:

• Chiarisce i nomi delle colonne, evitando anche abbreviazioni criptiche. Ad esempio, usare CustomerName anziché CustNm.
• Chiavi primarie definite per ogni tabella. L'agente utilizza le chiavi primarie per identificare le righe e restituire risultati.
• Dati descrittivi, che aiutano l'agente a comprendere il contesto dei dati e a rispondere alle domande in modo più accurato. Ad esempio, usare OrderDate anziché Date1.

Aggiungi tabelle Azure SQL al tuo agente

Per aggiungere tabelle Azure SQL come fonte di conoscenza, completare i seguenti passaggi:

1. Apri il tuo agente di Copilot Studio.

2. Seleziona la scheda Crea.

3. Nel pannello componenti, seleziona Conoscenza.

4. Nella finestra di dialogo Aggiungi conoscenza, seleziona Azure SQL (o SQL Server, a seconda dell'etichetta mostrata nel tuo ambiente).

5. Crea o seleziona una connessione al tuo database Azure SQL:

   • Se non hai già una connessione, seleziona Crea nuova connessione (o Aggiungi connessione).

   • Inserisci il nome del server e il nome del database per la tua risorsa Azure SQL.

   • Scegli il tipo di autenticazione richiesto dalla tua organizzazione, accedi o fornisci le credenziali, e crea la connessione.

   • Se una connessione esiste già, selezionala dalla lista e continua.

6. Trova una o più tabelle da aggiungere. Usa il campo di ricerca per restringere la lista se necessario, poi seleziona le tabelle che vuoi che l'agente utilizzi.

   Note

   Aggiungi solo tabelle che l'agente deve per rispondere alle domande degli utenti. Usa tabelle ben nominate con nomi chiari delle colonne così l'agente può interpretare i dati in modo più affidabile.

7. Esamina il nome e la descrizione della conoscenza. Fornisci una descrizione dettagliata, poiché la descrizione aiuta l'agente nell'orchestrazione e aiuta l'agente a comprendere il contesto della fonte di conoscenza.

8. Selezionare Aggiungi all'agente per completare l'inserimento dell'origine di conoscenza.

Dopo aver aggiunto la fonte di conoscenza

Dopo aver aggiunto Azure SQL:

• Conferma che la fonte delle conoscenze appare nella pagina Conoscenza dell'agente con la connessione e le tabelle selezionate che hai scelto.

• Pubblica l'agente in modo che la fonte di conoscenza sia disponibile nell'esperienza pubblicata.

• Metti alla prova il tuo agente con domande a cui dovrebbero rispondere dalle tabelle selezionate. Per esempio, "Mostrami i primi cinque clienti per vendite totali del mese scorso." Se i risultati restituiti sono vuoti o errendi, assicurati che la tabella contenga i dati attesi e che la query sia allineata al tuo schema.

Tip

Crea una visuale diagnostica in Azure SQL che restituisca un piccolo dataset noto. Usa questo dataset per confermare che la connessione funzioni prima di usare le tabelle di produzione.

Migliora la qualità delle risposte

Nomi e descrizioni chiare aiutano l'agente a capire quando e come utilizzare i tuoi dati Azure SQL.

• Usa un nome di fonte di conoscenza specifico che rifletta il dominio aziendale (ad esempio, "Ordini clienti – Azure SQL") invece di un'etichetta generica.

• Scrivi una descrizione dettagliata che spieghi quali dati contengono le tabelle, a quali domande aziendali rispondono e eventuali filtri o relazioni importanti.

• Seleziona solo le tabelle rilevanti. Tabelle aggiuntive possono diluire la messa a terra e rendere più difficile per l'agente scegliere i dati giusti.

• Preferisco uno schema leggibile. Tabelle e colonne con nomi business friendly generalmente producono risposte migliori rispetto ai nomi tecnici opachi.

Descrizione di esempio

Il seguente esempio mostra il tipo di descrizione che aiuta l'orchestrazione generativa a selezionare la giusta fonte di conoscenza:

Azure SQL knowledge for Contoso order management. Include i tavoli Clienti, Ordini e OrderLines. Usa questa fonte per domande sullo stato degli ordini, la cronologia degli ordini, gli acquisti dei clienti, le quantità di prodotto ordinate e i ricavi per cliente o data. Non usarlo per l'inventario a portata di mano o per il tracciamento tramite spedizioni.