Lägg till Azure SQL-tabeller och vyer som kunskapskälla (GitHub Copilot)

Du kan lägga till Azure SQL-tabeller och vyer som kunskapskälla i Copilot Studio. Din agent kan svara på frågor genom att läsa strukturerad data från din Azure SQL-databas, med hjälp av konfigurerade anslutnings- och databasbehörigheter.

Vyer visas i samma urvalslista som tabeller. Du behöver inte en separat kunskapskällatyp för att lägga till en vy.

Prerequisites

• En Azure SQL Database eller Azure SQL Managed Instance som din organisation kan nå från Power Platform.
• Autentiseringsuppgifter som kan ansluta till databasen och lista samt läsa de tabeller och vyer du planerar att lägga till. Använd till exempel Microsoft Entra ID eller SQL Server-autentisering, beroende på din anslutningskonfiguration.
• Tillgång till Copilot Studio och tillstånd att redigera agenten.
• Nätverksåtkomst konfigurerad så att Power Platform kan nå din Azure SQL-server. Använd till exempel brandväggsregler som tillåter Azure-tjänster eller privat anslutningstjänst enligt organisationens krav.

Behörigheter och autentisering

Azure SQL-kunskap använder Power Platform SQL-anslutningen du skapar eller väljer under installationen. Vid körning förlitar sig agenten på agentanvändarens Microsoft-autentisering och åtkomsten som ges via den anslutningsvägen.

• Användare får endast svar baserat på data som skaparen kan komma åt via skaparens konfigurerade anslutning och databasbehörigheter.
• Om tabeller eller vyer inte visas under installationen, kontrollera att anslutningen fungerar utanför Copilot Studio. Använd samma autentiseringstyp och identitet för att bekräfta att du kan lista och läsa de nödvändiga tabellerna och vyerna.

För SQL Server-autentisering gäller behörigheter för den SQL-användare du anger när du skapar anslutningen. För andra autentiseringstyper, verifiera behörigheter för identiteten som används av den anslutningen.

Förbered din Azure SQL-databas

Copilot Studio-agenter stödjer Azure SQL-databaser eller SQL Server. Innan du lägger till tabeller eller vyer, kontrollera följande konfiguration:

• Använd tydliga, beskrivande kolumnnamn i tabeller och vyer för att hjälpa agenten att förstå datan. Undvik kryptiska förkortningar. Använd till exempel CustomerName i stället för CustNm, och OrderDate i stället för Date1.
• Definiera en primärnyckel för varje tabell. Agenten använder primärnycklar för att identifiera rader och returnera resultat.
• Skapa vilka vyer du planerar att använda innan du väljer dem i Copilot Studio. Bekräfta att anslutningsidentiteten kan lista och läsa varje vy.

Lägg till Azure SQL-tabeller och vyer i din agent

För att lägga till Azure SQL-tabeller och vyer som kunskapskälla, utför följande steg:

1. Öppna din Copilot Studio-agent.

2. Välj fliken Bygg.

3. I komponentpanelen, välj Knowledge.

4. I dialogrutan Add knowledge väljer du Azure SQL (eller SQL Server, beroende på etiketten som visas i din miljö).

5. Skapa eller välj en anslutning till din Azure SQL-databas:

   • Om du inte redan har en anslutning, välj Skapa ny anslutning (eller Lägg till anslutning).
   • Ange servernamnet och databasnamnet för din Azure SQL-resurs.
   • Välj den autentiseringstyp som krävs av din organisation. Logga in eller ange inloggningsuppgifter, och skapa sedan anslutningen.
   • Bekräfta att identiteten du använder för att autentisera anslutningen har behörighet att lista och läsa de tabeller och vyer du planerar att lägga till.
   • Om en anslutning redan finns, välj den från listan och fortsätt.

6. Hitta en eller flera tabeller eller vyer att lägga till. Tabeller och vyer visas i samma urvalslista. Använd sökfältet för att begränsa listan och välj sedan de tabeller och vyer du vill att agenten ska använda.

   Note

   Välj endast de tabeller och vyer som behövs för att besvara användarfrågor. Använd tydliga tabell-, vy- och kolumnnamn. Om du skapar en vy efter att ha öppnat urvalslistan öppnar du kunskapsinställningarna för Azure SQL igen för att läsa in listan på nytt.

7. Granska kunskapsnamnet och beskrivningen. Ge en detaljerad beskrivning för att hjälpa agenten att förstå datan och avgöra när denna kunskapskälla ska användas.

8. Välj Lägg till i agent för att slutföra tillägg av kunskapskällan.

Efter att du lagt till kunskapskällan

Efter att du lagt till Azure SQL:

• Bekräfta att kunskapskällan visas på agentens Knowledge-sida med konfigurerad anslutning och valda tabeller och vyer.
• Publicera agenten så att kunskapskällan finns tillgänglig i den publicerade upplevelsen.
• Testa din agent med frågor som de valda tabellerna och vyerna kan besvara. Till exempel, "Visa mig de fem största kunderna efter total försäljning förra månaden." Om resultaten är tomma eller felaktiga, se till att den valda tabellen eller vyn returnerar förväntad data och att frågan matchar ditt schema.

Förbättra svarskvaliteten

Tydliga namn och beskrivningar hjälper agenten att avgöra när och hur agenten ska använda din Azure SQL-data.

• Kunskapskällans namn: Använd ett specifikt namn som identifierar affärsområdet. Använd till exempel "Customer orders - Azure SQL" istället för ett generiskt namn.
• Beskrivning: Förklara vilken data tabellerna och vyerna ger, vilka affärsfrågor de besvarar och eventuella viktiga filter eller relationer.
• Tabeller och vyer: Välj endast relevanta tabeller och vyer. Onödiga källor kan göra det svårare för agenten att välja rätt data.
• Schemanamn: Använd tydliga, affärsvänliga namn för tabeller, vyer och kolumner för att hjälpa agenten att tolka datan.

Exempelbeskrivning

Följande exempel visar en beskrivning som hjälper generativ orkestrering att välja rätt kunskapskälla:

Kunskap om Azure SQL för Contosos orderhantering. Inkluderar tabellerna Customers, Orders och OrderLines. Använd denna källa för frågor om orderstatus, orderhistorik, kundköp, beställda produktkvantiteter och intäkter per kund eller datum. Använd inte denna källa för lagersaldo eller spårning av transportör.