Brug SharePoint indhold til generative svar

Generative svarnoder, der bruger SharePoint som videnskilde på emneniveau, fungerer ved at parre agenten med en SharePoint URL-adresse, f.eks. contoso.sharepoint. com/sites/policies. Når en bruger stiller et spørgsmål, og agenten ikke har et emne, der kan bruges til et svar, søger agenten i webadressen og alle understier. For eksempel indeholder en URL som contoso.sharepoint.com/sites også understier som contoso.sharepoint.com/sites/policies. Generative svar opsummerer dette indhold i et målrettet svar.

Når du publicerer din agent, foretages de opkald, der bruger generative svar, på vegne af den bruger, der chatter med agenten, ved hjælp af de godkendelsesindstillinger, der er konfigureret i agenten. Agenter, der er oprettet i Copilot Studio og i Microsoft Teams, er som standard konfigureret med godkendelsesindstillingen Authenticate med Microsoft godkendelse, som fungerer i miljøer som f.eks. Microsoft Teams, Power Apps og Microsoft 365 Copilot.

Brug SharePoint i en generativ svarnode

1. I et emne kan du tilføje en generative svar-node.

2. I det relevante emnes generative svar-node, åbn konfigurationspanelet for datakilde fra et af to steder:

   1. Vælg Rediger under Datakilder i noden Opret generative svar.

      

   2. Alternativt kan du i Noden Opret generative svar vælge de tre prikker (...), derefter vælge Egenskaber og vælge Datakilde.

3. Under Videnkilder skal du vælge Tilføj viden. Sørg for, at Søg kun for de valgte kilder er slået til.

4. I afsnittet Udvalgt skal du vælge SharePoint.

   

5. Angiv URL-adressen til SharePoint. Adskil flere URL-adresser med manuelle linjeskift (brug Skift + Enter).

   Notat

   Du kan finde en liste over grænser og understøttet SharePoint-funktionalitet under Grænser for SharePoint-webapps.

6. Tilføj et navn og en beskrivelse. Beskrivelsen skal være så detaljeret som mulig, især hvis generativ AI er aktiveret, da beskrivelsen hjælper med generativ orkestrering.

7. Vælg Gem foroven for at gemme dine ændringer af emnet.

8. Test din agent med udtryk, som du forventer vil returnere indhold.

   Notat

   Hvis den brugerkonto, du brugte til at logge på copilotstudio.microsoft.com ikke har adgang til det SharePoint websted, får du ikke vist indhold, eller du får muligvis vist en systemfejl.

Brug variabler som URL-adresser

Brug variabler på et offentligt websted eller SharePoint URL-adresser til videnkilder til dynamisk at styre omfanget af det indhold, som din agent bruger.

I stedet for at oprette flere videnkilder til forskellige scenarier skal du definere en enkelt videnkilde og indsætte en variabel i URL-adressen. På kørselstidspunktet fortolker Copilot Studio variablen og bruger den resulterende URL-adresse til jordforbindelse.

Variabel understøttelse

Når du tilføjer eller redigerer et offentligt websted eller SharePoint URL-adresse til videnkilden, kan du indsætte en variabel i feltet URL-adresse.

Brug en variabel til at:

• Føj en sti til en grundlæggende URL-adresse

  https://www.contoso.com/{variable}

• Erstat hele URL-adressen

  {variable}

På kørselstidspunktet oversættes variablen til en strengværdi. Videnkilden er begrænset til den løste URL-adresse.

Opret og angiv en variabel

Sådan bruger du en variabel på et offentligt websted eller SharePoint videnkilde:

1. Opret en strengvariabel med globalt omfang.

2. Angiv variabelværdien ved hjælp af en af følgende indstillinger:

   • Emneinput
   • Brugerprofilegenskaber, f.eks. sprog
   • Miljøvariabler
   • Agent flows eller agentconnectorer

3. Indsæt variablen i feltet URL-adresse ved at vælge {x} (Indsæt variabel).

4. Test agenten for at bekræfte, at variablen oversættes til den forventede URL-adresse.

Eksempel: Omfang efter produkt

Du kan bruge viden til forskellige produktområder baseret på brugerens forespørgsel.

1. Brug et emneinput til at registrere produktnavnet som en variabel med navnet Product.

2. Tilføj noden Angiv variabelværdi efter udløsernoden , og opret en ny variabel med navnet ProductTable.

3. Brug en Power Fx-formel til at definere og knytte produktnavnene til URL-stier.

    Table(
        { Product: "Copilot", Path: "microsoft-365-copilot" },
        { Product: "Teams", Path: "microsoft-teams" },
        { Product: "Surface", Path: "surface" }
    )
   

4. Tilføj en anden node for angiv variabelværdi , og brug den til at oprette en ny global strengtypevariabel med navnet GlobalProductURL.

5. I indstillingen Til-værdi skal du vælge Formel og bruge en Power Fx-funktion til at udføre et opslag i tabellen baseret på værdien af Product inputvariablen , Topic.Productsom følger:

   LookUp(Topic.ProductTable, Product = Topic.Product, Path)

6. Brug variablen i URL-adressen til videnskilden:

   https://www.microsoft.com/en-us/{GlobalProductURL}

Agenten forespørger kun den områdebelagte del af webstedet på kørselstidspunktet.

Almindelige scenarier

Brug variabler i kilder til viden om offentlige websteder til:

• Produktbaseret routing: Omfangsforespørgsler til specifik produktdokumentation.

• Filtrering af område eller sprog: Knyt User.Language til lokaliserede URL-adresser (f.eks. en-us, it-it).

• Miljøspecifikke URL-adresser: Skift mellem udviklings-, test- og produktionswebsteder.

Overvejelser

• Kilder til viden om offentlige websteder bruger Bing-søgning og er afhængige af indekseret indhold.
• Grænser for URL-dybde gælder stadig, når du bruger variabler.
• Variabler ændrer kun DESTINATIONS-URL-adressen. De påvirker ikke, hvordan indhold indekseres eller hentes.

Avancerede godkendelsesscenarier

Copilot Studio forudkonfigurerer som standard agenter til godkendelse af brugere ved hjælp af Microsoft-godkendelse for at få adgang til SharePoint kilder, når de opretter forbindelse til en agent via Microsoft Teams, Power Apps eller Microsoft 365 Copilot. Men hvis du har brug for at konfigurere godkendelse manuelt, kræves følgende trin, for at generative svar kan fungere med SharePoint datakilder.

• Generative svar fra SharePoint kilder er ikke tilgængelige for brugere af guest brugere i SSO-aktiverede apps.

• Hvis du vil godkende din agent, kan du se Godkendelse.

• Du kan finde oplysninger om, hvordan du opretter den nødvendige Microsoft Entra ID programregistrering, under Konfigurer brugergodkendelse med Microsoft Entra ID. Når du opretter denne registrering, skal du eller din administrator angive områderne Sites.Read.All og Files.Read.All i Microsoft Entra ID appregistrering.

• Hvis du vælger No godkendelse angiver, at agenten ikke henter oplysninger fra SharePoint.

• Når du konfigurerer godkendelse, styrer områder brugeradgang. Angiv Sites.Read.All og Files.Read.All i området nær det eksisterende profile og openid værdier i Copilot Studio. Disse områder giver ikke brugerne øgede tilladelser, når de bruger agenten, men tillader deres tilladte indhold fra det SharePoint websted som konfigureret til generative svar.

• SharePoint understøtter indstillingen Authenticate manuelt med følgende godkendelsestjenesteudbydere:

  • Microsoft Entra ID
  • Microsoft Entra ID V2 med legitimationsoplysninger i organisationsnetværket
  • Microsoft Entra ID V2 med certifikater
  • Microsoft Entra ID V2 med klienthemmeligheder

• SharePoint understøtter ikke manuel godkendelse ved hjælp af Generisk OAuth.

• Denne konfiguration gælder kun for generative svar og gælder ikke for Power Platform-connectorer.