Voeg Azure SQL-tabellen toe als kennisbron

Wanneer je Azure SQL-tabellen integreert als kennisbron, baseer je je agent op de gestructureerde data die is opgeslagen in je Azure SQL-database. Je agent kan vragen beantwoorden door te lezen uit de door je geselecteerde tabellen, met behulp van de verbindingsgegevens en rechten die beschikbaar zijn voor de maker.

Note

Om Azure SQL-tabellen als kennisbron toe te voegen, moet je toestemming hebben om toegang te krijgen tot de onderliggende database en tabellen. Ontbrekende of onvoldoende permissies kunnen ervoor zorgen dat servers, databases of tabellen tijdens de installatie zichtbaar of selecteerbaar zijn.

Prerequisites

• Een Azure SQL Database of Azure SQL Managed Instance die uw organisatie kan bereiken via Power Platform.

• Inloggegevens die verbinding kunnen maken met de database en de tabellen kunnen lezen die je wilt toevoegen (bijvoorbeeld Microsoft Entra ID of SQL-authenticatie, afhankelijk van hoe je verbinding is geconfigureerd).

• Toegang tot Copilot Studio en toestemming om de agent te bewerken.

• Netwerktoegang is geconfigureerd zodat Power Platform je Azure SQL-server kan bereiken. Bijvoorbeeld firewallregels die Azure-diensten toestaan, of private connectiviteit zoals vereist door uw organisatie.

Rechten en authenticatie

Azure SQL-kennis gebruikt de Power Platform SQL-verbinding die je tijdens de setup aanmaakt of selecteert. Tijdens runtime vertrouwt de agent op de Microsoft-authenticatie van de agent en de toegang die via dat verbindingspad wordt verleend.

• Gebruikers ontvangen alleen antwoorden op basis van gegevens die de maker kan raadplegen via de door de maker geconfigureerde verbindingen en database-rechten.

• Als tabellen niet verschijnen tijdens de installatie, controleer dan of de verbinding buiten Copilot Studio succesvol is en dat het account die tabellen kan vermelden en lezen.

Prepare your Azure SQL database

Copilot Studio-agenten ondersteunen Azure SQL-databases of SQL Server. Voordat je tabellen toevoegt, zorg ervoor dat je tabellen de volgende configuratie hebben:

• Duidelijke kolomnamen, terwijl cryptische afkortingen ook worden vermeden. Gebruik bijvoorbeeld in plaats CustomerNamevan CustNm .
• Primaire sleutels gedefinieerd voor elke tabel. De agent gebruikt primaire sleutels om rijen te identificeren en resultaten terug te geven.
• Beschrijvende data, die de agent helpt de context van de data te begrijpen en vragen nauwkeuriger te beantwoorden. Gebruik bijvoorbeeld in plaats OrderDatevan Date1 .

Voeg Azure SQL tables toe aan je agent

Om Azure SQL-tabellen als kennisbron toe te voegen, voltooi je de volgende stappen:

1. Open je Copilot Studio-agent.

2. Selecteer het tabblad Bouwen.

3. Selecteer in het componentenpaneel Kennis.

4. Selecteer in het Knowledge Add-dialoogAzure SQL (of SQL Server, afhankelijk van het label dat in je omgeving wordt weergegeven).

5. Maak of selecteer een verbinding met je Azure SQL-database:

   • Als je nog geen verbinding hebt, kies dan voor Nieuwe verbinding aanmaken (of Verbinding toevoegen).

   • Voer de servernaam en databasenaam in voor je Azure SQL-resource.

   • Kies het verificatietype dat je organisatie vereist, log in of geef inloggegevens en maak de verbinding.

   • Als er al een verbinding bestaat, selecteer die dan uit de lijst en ga verder.

6. Zoek een of meer tabellen om toe te voegen. Gebruik het zoekveld om de lijst indien nodig te verfijnen en selecteer vervolgens de tabellen die je wilt dat de agent gebruikt.

   Note

   Voeg alleen tabellen toe die de agent nodig heeft om gebruikersvragen te beantwoorden. Gebruik goed benoemde tabellen met duidelijke kolomnamen zodat de agent de data betrouwbaarder kan interpreteren.

7. Controleer de naam en beschrijving van de kennis. Geef een gedetailleerde beschrijving, aangezien de beschrijving de agent-orkestratie helpt en de agent helpt de context van de kennisbron te begrijpen.

8. Selecteer Toevoegen aan agent om het toevoegen van de kennisbron te voltooien.

Nadat je de kennisbron hebt toegevoegd

Nadat je Azure SQL hebt toegevoegd:

• Bevestig dat de kennisbron verschijnt op de kennispagina van de agent met de link en geselecteerde tabellen die je hebt gekozen.

• Publiceer de agent zodat de kennisbron beschikbaar is in de gepubliceerde ervaring.

• Test je makelaar met vragen die beantwoord moeten worden uit de geselecteerde tabellen. Bijvoorbeeld: "Laat me de top vijf klanten zien qua totale omzet van vorige maand." Als de teruggegeven resultaten leeg of onjuist zijn, zorg er dan voor dat de tabel de verwachte gegevens bevat en dat de query overeenkomt met je schema.

Tip

Maak een diagnostisch overzicht aan in Azure SQL die een kleine, bekende dataset teruggeeft. Gebruik deze dataset om te bevestigen dat de verbinding werkt voordat je productietabellen gebruikt.

Verbeter de antwoordkwaliteit

Duidelijke naamgeving en beschrijvingen helpen de agent te begrijpen wanneer en hoe hij je Azure SQL-data moet gebruiken.

• Gebruik een specifieke kennisbronnaam die het bedrijfsdomein weerspiegelt (bijvoorbeeld "Customer orders – Azure SQL") in plaats van een generiek label.

• Schrijf een gedetailleerde beschrijving waarin wordt uitgelegd welke gegevens de tabellen bevatten, welke zakelijke vragen ze beantwoorden en eventuele belangrijke filters of relaties.

• Selecteer alleen relevante tabellen. Extra tabellen kunnen de gronding verdunnen en het voor de agent moeilijker maken om de juiste data te kiezen.

• Ik geef de voorkeur aan leesbaar schema. Tabellen en kolommen met zakelijke namen geven over het algemeen betere antwoorden dan ondoorzichtige technische namen.

Voorbeeldbeschrijving

Het volgende voorbeeld toont het soort beschrijving dat generatieve orkestratie helpt bij het selecteren van de juiste kennisbron:

Azure SQL kennis voor Contoso orderbeheer. Bevat tabellen Klanten, Bestellingen en OrderLines. Gebruik deze bron voor vragen over orderstatus, ordergeschiedenis, klantaankopen, bestelde producthoeveelheden en omzet per klant of datum. Gebruik het niet voor voorraad op voorraad of tracking van verzenders.