Legg til Azure SQL-tabeller som en kunnskapskilde (GitHub Copilot)

Når du integrerer Azure SQL-tabeller som en kunnskapskilde, forankrer du agenten din i de strukturerte dataene lagret i Azure SQL-databasen din. Agenten din kan svare på spørsmål ved å lese fra tabellene du velger, ved å bruke tilkoblingsopplysningene og tillatelsene som skaperen har tilgjengelig.

Forutsetninger

• En Azure SQL Database eller Azure SQL Managed Instance som organisasjonen din kan nå fra Power Platform.

• Påloggingsinformasjon som kan koble seg til databasen og lese tabellene du planlegger å legge til (for eksempel Microsoft Entra ID eller SQL-autentisering, avhengig av hvordan tilkoblingen din er konfigurert).

• Tilgang til Copilot Studio og tillatelse til å redigere agenten.

• Nettverkstilgang er konfigurert slik at Power Platform kan nå din Azure SQL-server. For eksempel brannmurregler som tillater Azure-tjenester, eller privat tilkobling etter behov i organisasjonen din.

Tillatelser og autentisering

Kunnskap om Azure SQL bruker Power Platform SQL-tilkoblingen du oppretter eller velger under oppsettet. Under kjøring er agenten avhengig av agentbrukerens Microsoft-autentisering og tilgangen som gis gjennom denne tilkoblingsveien.

• Brukere mottar kun svar basert på data makeren kan få tilgang til via makerens konfigurerte tilkobling og databasetillatelser.

• Hvis tabeller ikke vises under oppsettet, sjekk at tilkoblingen lykkes utenfor Copilot Studio og at kontoen kan liste og lese disse tabellene.

Klargjør Azure SQL-databasen

Copilot Studio-agenter støtter Azure SQL-databaser eller SQL Server. Før du legger til tabeller, sørg for at tabellene dine har følgende konfigurasjon:

• Tydelige kolonnenavn, samtidig som du unngår kryptiske forkortelser. For eksempel, bruk CustomerName i stedet for CustNm.
• Primær nøkler definert for hver tabell. Agenten bruker primærnøkler for å identifisere rader og returnere resultater.
• Beskrivende data, som hjelper agenten å forstå konteksten i dataene og svare mer nøyaktig på spørsmål. For eksempel, bruk OrderDate i stedet for Date1.

Legg til Azure SQL-tabeller i agenten din

For å legge til Azure SQL-tabeller som en kunnskapskilde, fullfør følgende steg:

1. Åpne din Copilot Studio-agent.

2. Velg kategorien Bygg.

3. I komponentpanelet, velg Kunnskap.

4. I dialogen Legg til kunnskap velger du Azure SQL (eller SQL Server, avhengig av etiketten som vises i miljøet ditt).

5. Opprett eller velg en tilkobling til din Azure SQL-database:

   • Hvis du ikke allerede har en tilkobling, velg Opprett ny tilkobling (eller Legg til tilkobling).

   • Skriv inn servernavnet og databasenavnet for din Azure SQL-ressurs.

   • Velg autentiseringstypen som kreves av organisasjonen din, logg inn eller oppgi legitimasjon, og lag tilkoblingen.

   • Hvis det allerede finnes en tilkobling, velg den fra listen og fortsett.

6. Finn én eller flere tabeller å legge til. Bruk søkefeltet for å snevre inn listen om nødvendig, og velg deretter tabellene du vil at agenten skal bruke.

   Note

   Legg bare til tabeller agenten trenger for å svare på brukerspørsmål. Bruk godt navngitte tabeller med klare kolonnenavn slik at agenten kan tolke dataene mer pålitelig.

7. Se gjennom kunnskapsnavnet og -beskrivelsen. Gi en detaljert beskrivelse, siden beskrivelsen hjelper agentens orkestrering og hjelper agenten å forstå konteksten til kunnskapskilden.

8. Velg Legg til i agent for å fullføre å legge til kunnskapskilden.

Etter at du har lagt til kunnskapskilden

Etter at du har lagt til Azure SQL:

• Bekreft at kunnskapskilden vises på agentens kunnskapsside med tilkoblingen og valgte tabeller du valgte.

• Publiser agenten slik at kunnskapskilden er tilgjengelig i den publiserte opplevelsen.

• Test agenten din med spørsmål som bør besvares fra de valgte tabellene. For eksempel: «Vis meg de fem beste kundene etter totalt salg forrige måned.» Hvis resultatene som returneres er tomme eller feil, sørg for at tabellen inneholder forventede data, og at spørringen samsvarer med databaseskjemaet ditt.

Forbedr svarkvaliteten

Tydelig navngivning og beskrivelser hjelper agenten å forstå når og hvordan den skal bruke Azure SQL-dataene.

• Bruk et spesifikt kunnskapskildenavn som reflekterer forretningsdomenet (for eksempel «Customer orders – Azure SQL») i stedet for en generisk etikett.

• Skriv en detaljert beskrivelse som forklarer hvilke data tabellene inneholder, hvilke forretningsspørsmål de besvarer, og eventuelle viktige filtre eller relasjoner.

• Velg kun relevante tabeller. Ekstra tabeller kan fortynne forankringen og gjøre det vanskeligere for agenten å velge riktige data.

• Foretrekk lesbart skjema. Tabeller og kolonner med forretningsvennlige navn gir vanligvis bedre svar enn ugjennomsiktige tekniske navn.

Eksempelbeskrivelse

Følgende eksempel viser hvilken type beskrivelse som hjelper generativ orkestrering med å velge riktig kunnskapskilde:

Azure SQL-kunnskap for Contosos ordrehåndtering. Inkluderer tabellene Kunder, Ordrer og Ordrelinjer. Bruk denne kilden for spørsmål om ordrestatus, ordrehistorikk, kundekjøp, bestilte produktmengder og inntekt etter kunde eller dato. Ikke bruk for lagerbeholdning på lager eller sporing av transportør.