Lisää Azure SQL-taulukot ja näkymät tietolähteeksi (GitHub Copilot)

Voit lisätä Azure SQL -taulukoita ja -näkymiä tietolähteeksi Copilot Studio:ssa. Agenttisi voi vastata kysymyksiin lukemalla jäsenneltyä dataa Azure SQL -tietokannastasi käyttäen konfiguroituja yhteys- ja tietokantaoikeuksia.

Näkymät näkyvät samassa valintalistassa kuin taulukot. Et tarvitse erillistä tietolähdetyyppiä näkymän lisäämiseen.

Huomautus

SQL-yhteyden todennukseen käyttämälläsi tunnistetiedolla on oltava oikeus käyttää tietokantaa sekä listata ja lukea valittuja taulukoita ja näkymiä. Puuttuvat tai riittämättömät käyttöoikeudet voivat estää palvelimien, tietokantojen, taulukoiden tai näkymien näkymisen asennuksen aikana.

Edellytykset

• Azure SQL Database tai Azure SQL Managed Instance, johon organisaatiosi pääsee Power Platformin kautta.
• Kirjautumistiedot, jotka voivat yhdistää tietokantaan, listata ja lukea taulukot ja näkymät, jotka aiot lisätä. Esimerkiksi käytä Microsoft Entra ID:tä tai SQL Server -tunnistautumista, riippuen yhteyden asetuksista.
• Pääsy Copilot Studio -palveluun ja lupa muokata agenttia.
• Verkkoyhteys on konfiguroitu niin, että Power Platform pääsee käsiksi Azure SQL-palvelimellesi. Esimerkiksi käytä palomuurisääntöjä, jotka sallivat Azure-palvelut 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. Ajon 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 tekijäkäyttäjä pääsee käsiksi tekijäkäyttäjän määritetyn yhteyden ja tietokantaoikeuksien kautta.
• Jos taulukoita tai näkymiä ei näy asennuksen aikana, varmista, että yhteys toimii Copilot Studio:n ulkopuolella. Käytä samaa tunnistautumistyyppiä ja identiteettiä varmistaaksesi, että voit luetteloida ja lukea vaaditut taulukot ja näkymät.

SQL Server -todennuksessa käyttöoikeudet koskevat SQL-käyttäjää, jonka määrität yhteyden luomisessa. Muiden autentikointityyppien osalta varmista kyseisen yhteyden käyttämän identiteetin oikeudet.

Valmistele Azure SQL -tietokantasi

Copilot Studio -agentit tukevat Azure SQL -tietokantoja tai SQL Server. Ennen kuin lisäät taulukoita tai näkymiä, tarkista seuraavat asetukset:

• Käytä selkeitä, kuvailevia sarakenimiä taulukoissa ja näkymissä auttaaksesi agenttia ymmärtämään dataa. Vältä arvoituksellisia lyhenteitä. Esimerkiksi käytä CustomerName sen sijaan CustNm, ja OrderDate sen sijaan Date1.
• Määrittele pääavain jokaiselle taululle. Agentti käyttää pääavaimia rivien tunnistamiseen ja tulosten palauttamiseen.
• Luo kaikki näkymät, joita aiot käyttää, ennen kuin valitset ne Copilot Studio:ssa. Varmista, että yhteyden identiteetti voi listata ja lukea jokaisen näkymän.

Lisää Azure SQL-taulukot ja näkymät agenttiisi

Azure SQL-taulukoiden ja -näkymien 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 todennustyyppi. Kirjaudu sisään tai anna tunnistetiedot, ja luo sitten yhteys.
   • Varmista, että yhteyden todentamiseen käyttämälläsi henkilöllisyydellä on oikeus listata ja lukea taulukot ja näkymät, jotka aiot lisätä yhteyteen.
   • Jos yhteys on jo olemassa, valitse se listalta ja jatka.

6. Etsi yksi tai useampi taulukko tai näkymä lisättäväksi. Taulukot ja näkymät näkyvät samassa valintalistassa. Käytä hakukenttää kaventaaksesi listaa ja valitse sitten taulukot ja näkymät, joita haluat agentin käyttävän.

   Huomautus

   Valitse vain taulukot ja näkymät, joita tarvitaan käyttäjien kysymyksiin vastaamiseen. Käytä selkeitä taulukko-, näkymä- ja sarakkeiden nimiä. Jos luot näkymän valintalistan avaamisen jälkeen, avaa Azure SQL -tietoasetukset uudelleen ja lataa lista uudelleen.

7. Tarkasta tietämyksen nimi ja kuvaus. Anna yksityiskohtainen kuvaus , joka auttaa agenttia ymmärtämään tiedot ja päättämään, milloin tätä tietolähdettä tulisi käyttää.

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 määritetyn yhteyden sekä valittujen taulukoiden ja näkymien kanssa.
• Julkaise avustaja, jotta tietolähde on saatavilla julkaistussa käyttökokemuksessa.
• Testaa agenttiasi kysymyksillä, joihin valitut taulukot ja näkymät voivat vastata. Esimerkiksi: "Näytä minulle viisi parasta asiakasta viime kuun kokonaismyynnin perusteella." Jos tulokset ovat tyhjiä tai virheellisiä, varmista, että valittu taulukko tai näkymä palauttaa odotetut tiedot ja että kysely vastaa skeemaasi.

Vinkki

Luo Azure SQL:ään vianmääritysnäkymä, joka palauttaa pienen, tunnetun tietoaineiston. Varmista, että yhteysidentiteetti voi listata ja lukea näkymän, ja valitse se tietolähteeksi. Testaa kyseistä aineistoa koskevat kysymykset ennen tuotantodatan käyttöä.

Paranna vastauksen laatua

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

• Tietolähteen nimi: Käytä tiettyä nimeä, joka yksilöi liiketoiminta-alueen. Esimerkiksi käytä "Customer orders - Azure SQL" yleisen nimen sijaan.
• Kuvaus: Selitä, mitä dataa taulukot ja näkymät tarjoavat, mihin liiketoimintakysymyksiin ne vastaavat sekä mitkä ovat mahdolliset tärkeät suodattimet tai suhteet.
• Taulukot ja näkymät: Valitse vain olennaiset taulukot ja näkymät. Tarpeettomat lähteet voivat vaikeuttaa agentin oikeiden tietojen valintaa.
• skeeman nimet: Käytä selkeitä, liiketoimintaystävällisiä nimiä taulukoille, näkymille ja sarakkeille, jotta agentti voi tulkita dataa.

Esimerkin kuvaus

Seuraava esimerkki esittää kuvauksen, joka auttaa generatiivista orkestrointia valitsemaan oikean tietolähteen:

Azure SQL -osaaminen Contoson tilaustenhallintaan. Sisältää Customers-, Orders- ja OrderLines-taulukot. 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ä tätä lähdettä saatavilla olevan varaston tai kuljetusseurantaan.