Tilføj Azure SQL-tabeller som videnskabskilde (GitHub Copilot)

Når du integrerer Azure SQL-tabeller som videnskilde, forankrer du din agent i de strukturerede data, der er gemt i din Azure SQL-database. Din agent kan besvare spørgsmål ved at læse fra de tabeller, du vælger, ved hjælp af de forbindelsesoplysninger og tilladelser, som opretteren har adgang til.

Bemærkning

Hvis du vil tilføje Azure SQL-tabeller som videnskilde, skal du have tilladelse til at få adgang til den underliggende database og tabellerne. Manglende eller utilstrækkelige tilladelser kan forhindre servere, databaser eller tabeller i at være synlige eller valgbare under opsætningen.

Forudsætninger

  • En Azure SQL Database eller Azure SQL Managed Instance, som din organisation kan få adgang til via Power Platform.

  • Legitimationsoplysninger, som giver adgang til at oprette forbindelse til databasen og læse de tabeller, du planlægger at tilføje (for eksempel Microsoft Entra ID eller SQL-autentificering, afhængigt af hvordan din forbindelse er konfigureret).

  • Adgang til Copilot Studio og tilladelse til at redigere agenten.

  • Netværksadgang konfigureret, så Power Platform kan nå din Azure SQL-server. For eksempel firewall-regler, der tillader Azure-tjenester, eller privat forbindelse, som krævet af din organisation.

Tilladelser og autentificering

Azure SQL-viden bruger den Power Platform SQL-forbindelse, du opretter eller vælger under opsætningen. Under kørsel er agenten afhængig af agentbrugerens Microsoft-autentificering og den adgang, der gives gennem denne forbindelsessti.

  • Brugere modtager kun svar baseret på data, som opretteren kan få adgang til via opretterens konfigurerede forbindelses- og databasetilladelser.

  • Hvis tabeller ikke vises under opsætningen, så verificér at forbindelsen lykkes uden for Copilot Studio, og at kontoen kan liste og læse disse tabeller.

Forbered din Azure SQL-database

Copilot Studio-agenter understøtter Azure SQL-databaser eller SQL Server. Før du tilføjer tabeller, skal du sikre dig, at dine tabeller har følgende konfiguration:

  • Klare kolonnenavne, samtidig med at man undgår kryptiske forkortelser. For eksempel brug CustomerName i stedet for CustNm.
  • Primærnøgler defineret for hver tabel. Agenten bruger primærnøgler til at identificere rækker og returnere resultater.
  • Beskrivende data, som hjælper agenten med at forstå konteksten af dataene og besvare spørgsmål mere præcist. For eksempel brug OrderDate i stedet for Date1.

Tilføj Azure SQL-tabeller til din agent

Hvis du vil tilføje Azure SQL-tabeller som en videnskilde, skal du gennemføre følgende trin:

  1. Åbn din Copilot Studio-agent.

  2. Vælg fanen Build.

  3. I komponentpanelet skal du vælge Knowledge.

  4. I dialogen Add knowledge vælg Azure SQL (eller SQL Server, afhængigt af etiketten vist i dit miljø).

  5. Opret eller vælg en forbindelse til din Azure SQL-database:

    • Hvis du ikke allerede har en forbindelse, vælg Opret ny forbindelse (eller Tilføj forbindelse).

    • Indtast servernavnet og databasenavnet for din Azure SQL-ressource.

    • Vælg den autentificeringstype, som din organisation kræver, log ind eller giv legitimationsoplysninger, og skab forbindelsen.

    • Hvis der allerede findes en forbindelse, vælg den fra listen og fortsæt.

  6. Find en eller flere tabeller, der kan tilføjes. Brug søgefeltet til at indsnævre listen, hvis det er nødvendigt, og vælg derefter de tabeller, du vil have agenten til at bruge.

    Bemærkning

    Tilføj kun tabeller, som agenten skal bruge for at besvare brugerspørgsmål. Brug velnavngivne tabeller med klare kolonnenavne, så agenten kan fortolke dataene mere pålideligt.

  7. Gennemse navnet på og beskrivelsen af viden. Giv en detaljeret beskrivelse, da beskrivelsen hjælper agentens orkestrering og hjælper agenten med at forstå konteksten for kilden til viden.

  8. Vælg Føj til agent for at afslutte tilføjelsen af videnkilden.

Efter du tilføjer videnskilde

Efter du tilføjer Azure SQL:

  • Bekræft, at videnskilden vises på agentens Knowledge-side med forbindelsen og de valgte tabeller, du har valgt.

  • Publicer agenten, så videnskilden er tilgængelig i den publicerede oplevelse.

  • Test din agent med spørgsmål, der bør besvares fra de udvalgte tabeller. For eksempel: "Vis mig de fem største kunder efter samlet salg sidste måned." Hvis de returnerede resultater er tomme eller forkerte, skal du sikre, at tabellen indeholder de forventede data, og at forespørgslen stemmer overens med dit skema.

Tip

Opret en diagnostisk visning i Azure SQL, der returnerer et lille, kendt datasæt. Brug dette datasæt til at bekræfte, at forbindelsen virker, før du bruger produktionstabeller.

Forbedr svarkvaliteten

Klar navngivning og beskrivelser hjælper agenten med at forstå, hvornår og hvordan agenten skal bruge dine Azure SQL-data.

  • Brug navnet på en specifik videnskilde, der afspejler forretningsdomænet (for eksempel "Customer orders – Azure SQL") i stedet for en generisk label.

  • Skriv en detaljeret beskrivelse , der forklarer, hvilke data tabellerne indeholder, hvilke forretningsspørgsmål de besvarer, og eventuelle vigtige filtre eller relationer.

  • Vælg kun relevante tabeller. Ekstra tabeller kan udvande kontekstforankringen og gøre det sværere for agenten at vælge de rigtige data.

  • Foretræk et læsbart schema. Tabeller og kolonner med erhvervsvenlige navne giver generelt bedre svar end uigennemsigtige tekniske navne.

Beskrivelse af eksempel

Følgende eksempel viser den slags beskrivelse, der hjælper generativ orkestrering med at vælge den rette videnskilde:

Azure SQL-viden til Contosos ordrehåndtering. Inkluderer tabellerne Customers, Orders og OrderLines. Brug denne kilde til spørgsmål om ordrestatus, ordrehistorik, kundekøb, bestilte produktmængder og omsætning efter kunde eller dato. Brug den ikke til lagerbeholdning eller sporing af fragtforsendelser.

  • Sidst opdateret den