Add Azure SQL tables as a knowledge source (GitHub Copilot)

Kun integroit Azure SQL-taulukot tietolähteeksi, ankkuroit agenttisi Azure SQL -tietokantaan tallennettuun strukturoituun dataan. Agenttisi voi vastata kysymyksiin lukemalla valitsemistasi taulukoista käyttäen tekijän käytettävissä olevia yhteyden tunnistetietoja ja käyttöoikeuksia.

Vaatimukset

• Azure SQL Database tai Azure SQL Managed Instance, johon organisaatiosi pääsee Power Platformin kautta.

• Tunnistetiedot, jotka voivat yhdistää tietokantaan ja lukea taulukoita, joita aiot lisätä (esimerkiksi Microsoft Entra ID tai SQL-todennus, riippuen siitä, miten yhteys on konfiguroitu).

• Pääsy Copilot Studio -palveluun ja lupa muokata agenttia.

• Verkkoyhteys on konfiguroitu niin, että Power Platform pääsee käsiksi Azure SQL-palvelimellesi. Esimerkiksi palomuurisäännöt, jotka sallivat yhteydet Azure-palveluihin, tai yksityisen yhteyden, kuten organisaatiosi vaatii.

Käyttöoikeudet ja todennus

Azure SQL -tieto käyttää Power Platform SQL -yhteyttä, jonka luot tai valitset asennuksen aikana. Suorituksen aikana agentti luottaa agentin käyttäjän Microsoft-tunnistautumiseen ja kyseisen yhteyspolun kautta annettuun pääsyyn.

• Käyttäjät saavat vastauksia vain niiden tietojen perusteella, joihin maker pääsee käsiksi makerin määritetyn yhteyden ja tietokantaoikeuksien kautta.

• Jos taulukot eivät näy asennuksen aikana, varmista, että yhteyden muodostaminen onnistuu Copilot Studion ulkopuolella ja että tili voi listata ja lukea nuo taulukot.

Valmistele Azure SQL -tietokantasi

Copilot Studio -agentit tukevat Azure SQL -tietokantoja tai SQL Server. Ennen taulukoiden lisäämistä varmista, että taulukot ovat seuraavassa kokoonpanossa:

• Käytä selkeitä sarakenimiä ja vältä myös arvoituksellisia lyhenteitä. Esimerkiksi käytä CustomerName mieluummin kuin CustNm.
• Pääavaimet määritelty jokaiselle taulukolle. Agentti käyttää pääavaimia rivien tunnistamiseen ja tulosten palauttamiseen.
• Kuvaileva data, joka auttaa agenttia ymmärtämään datan kontekstia ja vastaamaan kysymyksiin tarkemmin. Esimerkiksi käytä Date1 mieluummin kuin OrderDate.

Lisää Azure SQL-taulukot agenttiisi

Azure SQL-taulukoiden lisäämiseksi tiedonlähteeksi suorita seuraavat vaiheet:

1. Avaa Copilot Studio -agenttisi.

2. Valitse Koontiversio-välilehti.

3. Komponenttipaneelista valitse Knowledge.

4. Lisää tietoa -valintaikkunasta valitse Azure SQL (tai SQL Server, riippuen ympäristössäsi näkyvästä tunnisteesta).

5. Luo tai valitse yhteys Azure SQL -tietokantaasi:

   • Jos sinulla ei vielä ole yhteyttä, valitse Luo uusi yhteys (tai Lisää yhteys).

   • Syötä palvelimen nimi ja tietokannan nimi Azure SQL-resurssillesi.

   • Valitse organisaatiosi vaatima tunnistautumistyyppi, kirjaudu sisään tai anna tunnukset ja luo yhteys.

   • Jos yhteys on jo olemassa, valitse se listalta ja jatka.

6. Etsi yksi tai useampi taulukko lisättäväksi. Käytä hakukenttää rajataksesi listan tarvittaessa, ja valitse sitten ne taulukot, joita haluat agentin käyttävän.

   Note

   Lisää vain taulukoita, joita agentti tarvitsee vastatakseen käyttäjän kysymyksiin. Käytä hyvin nimettyjä taulukoita, joissa on selkeät sarakkeennimet, jotta agentti voi tulkita dataa luotettavammin.

7. Tarkasta tietämyksen nimi ja kuvaus. Anna yksityiskohtainen kuvaus, sillä kuvaus auttaa agentin orkestroinnissa ja auttaa agenttia ymmärtämään tietolähteen kontekstin.

8. Viimeistele tietolähteen lisääminen valitsemalla Lisää agenttiin .

Kun olet lisännyt tietolähteen

Kun olet lisännyt Azure SQL:n:

• Varmista, että tietolähde näkyy agentin Knowledge-sivulla valitsemiesi yhteyksien ja valittujen taulukoiden kanssa.

• Julkaise agent, jotta tietolähde on saatavilla julkaistussa käytössä.

• Testaa agenttiasi kysymyksillä, joihin tulisi vastata valittujen taulukoiden perusteella. Esimerkiksi: "Näytä minulle viisi parasta asiakasta viime kuun kokonaismyynnin perusteella." Jos tulokset ovat tyhjiä tai virheellisiä, varmista, että taulukossa on odotetut tiedot ja että kysely vastaa skeemaa.

Paranna vastauksen laatua

Selkeät nimet ja kuvaukset auttavat agenttia ymmärtämään, milloin ja miten käyttää Azure SQL -tietojasi.

• Käytä tiettyä tietolähteen nimeä, joka vastaa liiketoiminnan domainia (esim. "Customer orders – Azure SQL") yleisen tunnisteen sijaan.

• Kirjoita yksityiskohtainen kuvaus , joka selittää, mitä dataa taulukot sisältävät, mihin liiketoimintakysymyksiin ne vastaavat sekä mahdolliset tärkeät suodattimet tai suhteet.

• Valitse vain asiaankuuluvat taulukot. Lisätaulukot voivat heikentää ankkurointia ja vaikeuttaa agentin oikean datan valintaa.

• Suosi luettavaa skeemaa. Taulukot ja sarakkeet, joilla on liiketoimintaystävälliset nimet, tuottavat yleensä parempia vastauksia kuin epäselvät tekniset nimet.

Esimerkin kuvaus

Seuraava esimerkki osoittaa, millainen kuvaus auttaa generatiivista orkestrointia valitsemaan oikean tietolähteen:

Azure SQL -tietämys Contoson tilaustenhallintaa varten. Sisältää Customers-, Orders- ja OrderLines-taulut. Käytä tätä lähdettä kysymyksiin, jotka koskevat tilaustilaa, tilaushistoriaa, asiakasostoja, tilausmääriä sekä liikevaihtoa asiakkaan tai päivämäärän mukaan. Älä käytä varastosaldoon tai kuljetusliikkeen seurantaan.