Legge til SharePoint som en kunnskapskilde

SharePoint som kunnskapskilde fungerer ved å pare agenten med en nettadresse SharePoint eller SharePoint lister. Denne artikkelen dekker den fullstendige SharePoint integreringsfunksjonaliteten som leveres ved å velge alternativet SharePoint i dialogboksen Tilleggskunnskap.

Når du publiserer agenten, utføres oppkallene som bruker generative svar, på vegne av brukeren som chatter med agenten, ved hjelp av godkjenningsinnstillingene som er konfigurert i agenten. Som standard konfigureres agenter som er opprettet i Copilot Studio og i Microsoft Teams med Authenticate med microsoft-godkjenningsalternativet, som fungerer i miljøer som Microsoft Teams, Power Apps og Microsoft 365 Copilot.

Legge til SharePoint-områder som en kunnskapskilde

Når en bruker stiller et spørsmål og agent ikke har et emne som skal brukes til svar, søker agent i URL-adressen og alle delbaner. Nettadressen contoso.sharepoint.com/sites omfatter for eksempel også underordnede baner som contoso.sharepoint.com/sites/policies. Generative svar oppsummerer dette innholdet til et målrettet svar.

Hvis du vil legge til et SharePoint nettsted som en kunnskapskilde, gjør du følgende:

1. Åpne agentappen.

2. Velg Legg til kunnskap fra siden Oversikt eller Kunnskap, eller velg Egenskaper for en node for generative svar.

3. Velg SharePoint under Utvalgt.

   

4. Angi url-adressen SharePoint. Skill flere nettadresser med manuelle linjeskift (bruk Skift + Enter). Hvis du vil bruke en variabel i stedet for en statisk URL-adresse, velger du variabelvelgerikonet ved siden av NETTADRESSE-feltet og velger en egendefinert variabel, system eller miljøvariabel .

5. Legg til et navn og en beskrivelse. Beskrivelsen må være så detaljert som mulig, særlig hvis generativ kunstig intelligens er aktivert, siden beskrivelsen støtter generativ iverksetting.

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

Legge til SharePoint-lister som en kunnskapskilde

SharePoint lister er en populær måte å lagre tabelldata på og gi rask og enkel tilgang til informasjon. Agenten din kan bruke disse listene som kunnskapskilde. Ved å legge til en SharePoint-liste som en kunnskapskilde oppretter du en sanntidstilkobling til kilden, slik at de nyeste dataene brukes til spørringer og resonnementer. Brukere godkjennes ved hjelp av SharePoint-legitimasjonen, noe som sikrer at de har tillatelse til å få tilgang til dataene før agenten gir et svar.

1. Åpne agentappen.

2. Velg Legg til kunnskap fra siden Oversikt eller Kunnskap, eller velg Egenskaper for en node for generative svar.

3. Velg SharePoint under Utvalgt.

4. Velg Bla gjennom elementer for å finne den ønskede listen, eller skriv inn nettadressen til et bestemt SharePoint-område.

   

5. Når du velger Bla gjennom elementer, fylles dialogboksen automatisk ut med Mine lister og Nylige lister. My Lists viser bare lister som er opprettet i SharePoint Lists-appen. Alle andre lister vises i nylige lister. Hvis du ikke ser en liste du trenger, åpner du SharePoint og åpner listen, og listen vises deretter i Nylige lister.

   

   Du kan velge opptil 15 lister om gangen. Hver liste legges til agentens kunnskapskilder som individuelle elementer. Hvis du vil legge til flere lister i agenten, kan du bruke disse trinnene på nytt og velge flere lister.

   Merk

   Hvis du vil bruke en SharePoint-liste med delt tilgang, men den ikke vises i Nylige lister, lim inn nettadressen for listen i URL-feltet.

6. Når du har valgt ønskede lister, velger du Bekreft valg.

7. Legg til et navn og en beskrivelse. Beskrivelsen må være så detaljert som mulig, særlig hvis generativ kunstig intelligens er aktivert, siden beskrivelsen støtter generativ iverksetting.

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

Avanserte godkjenningsscenarioer

Som standard konfigurerer Copilot Studio agenter til å godkjenne brukere som bruker Microsoft-godkjenning til å få tilgang til SharePoint kilder når de kobler til en agent via Microsoft Teams, Power Apps eller Microsoft 365 Copilot. Hvis du imidlertid må konfigurere godkjenning manuelt, kreves følgende trinn for at generative svar skal fungere med SharePoint datakilder.

• Generative svar fra SharePoint kilder er ikke tilgjengelige for guest brukere i SSO-aktiverte apper.

• Se Godkjenning for å godkjenne agenten din.

• Hvis du vil ha instruksjoner om hvordan du oppretter den nødvendige Microsoft Entra ID programregistrering, kan du se Konfigurer brukergodkjenning med Microsoft Entra ID. Når du oppretter denne registreringen, må du eller administratoren angi Sites.Read.All og Files.Read.All omfang i Microsoft Entra ID appregistrering.

• Hvis du velger No authentication angir du at agenten ikke henter informasjon fra SharePoint.

• Når du konfigurerer godkjenning, kontrollerer tilgangsområder brukertilgang. Angi Sites.Read.All og Files.Read.All i omfangsfeltet nær eksisterende verdier for profile og openid i Copilot Studio. Disse omfangene gir ikke brukere økte tillatelser når de bruker agenten, men tillater tillatt innhold fra SharePoint-nettstedet som konfigurert for generative svar.

• SharePoint støtter innstillingen Authenticate manuelt med følgende leverandør av godkjenningstjenester:

  • Microsoft Entra ID
  • Microsoft Entra ID V2 med federerte legitimasjoner
  • Microsoft Entra ID V2 med sertifikater
  • Microsoft Entra ID V2 med klienthemmeligheter

• SharePoint støtter ikke manuell godkjenning ved hjelp av Generic OAuth.

• Denne konfigurasjonen gjelder bare generative svar, og ikke Power Platform-koblinger.

Filtrer SharePoint kilde

Beslutningstakere kan bidra til ytelsen til agentens SharePoint kunnskapskilde ved å angi søkespørringsparametere. Disse spørringsparameterne definerer hva som søkes i kunnskapskilden. For eksempel kan du spesifisere at du kun vil ha søk etter elementer som er endret de siste seks månedene. Denne typen filter vil bli konstruert som:

Opprette filterbetingelser

Når du har lagt til en SharePoint kunnskapskilde, kan du angi søkebetingelser.

1. På siden Knowledge, velg din SharePoint-kilde.

2. Velg de tre prikkene (... ) for den SharePoint kilden, og velg Edit.

3. Velg Avanserte innstillinger.

4. Bygg filtrene for å inkludere eller ekskludere informasjon fra kunnskapskilden for SharePoint. Du kan basere filteret på ett av følgende valg:

   • Tittel
   • Forfatter
   • Endret av
   • Endringsdato

5. Du kan angi verdien for betingelsen til én av følgende verdier:

   • En statisk verdi
   • En variabel inndata som brukeren gir under samtalen med agenten, som deretter lagres som en egendefinert global variabel
   • En systemvariabel

6. Velg Lagre når du er ferdig med å konfigurere filtrene.

Flere innstillinger for å forbedre søket

Hvis du vil filtrere SharePoint-kilden, bør du deaktivere følgende innstillinger:

• Websøk
• Bruk generell kunnskapsinnstilling i agentens generative AI-innstillinger på agentnivå
• Tillat AI å bruke sin egen generelle kunnskap (forhåndsversjon) i noden generative svar på emnenivå

Hvis du slår av disse innstillingene, sikrer du at agenten svarer uten svar hvis den ikke finner et resultat i den filtrerte SharePoint-kunnskapskilden.

Bruke variabler som URL-adresser

Bruk variabler på offentlig nettsted eller SharePoint url-adresser for kunnskapskilde til å dynamisk kontrollere omfanget av innhold som agenten din bruker.

I stedet for å opprette flere kunnskapskilder for ulike scenarioer, definerer du én enkelt kunnskapskilde og setter inn en variabel i nettadressen. Ved kjøring løser Copilot Studio variabelen og bruker den resulterende nettadressen for jording.

Variabel støtte

Når du legger til eller redigerer et offentlig nettsted eller SharePoint url-adresse for kunnskapskilde, kan du sette inn en variabel i nettadressefeltet.

Bruk en variabel til å:

• Tilføye en bane til en grunnleggende URL-adresse

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

• Erstatt hele URL-adressen

  {variable}

Ved kjøring løses variabelen til en strengverdi. Kunnskapskilden er begrenset til den løste URL-adressen.

Opprette og angi en variabel

Slik bruker du en variabel på et offentlig nettsted eller SharePoint kunnskapskilde:

1. Opprett en strengvariabel med globalt omfang.

2. Angi variabelverdien ved hjelp av ett av følgende alternativer:

   • Emneinndata
   • Egenskaper for brukerprofil, for eksempel språk
   • Miljøvariabler
   • Agentflyter eller koblinger

3. Sett inn variabelen i NETTADRESSE-feltet ved å velge {x} (Sett inn variabel).

4. Test agenten for å bekrefte at variabelen løses til den forventede URL-adressen.

Eksempel: Omfang etter produkt

Du kan begrense kunnskap til ulike produktområder basert på brukerens spørring.

1. Bruk en emneinndata til å registrere produktnavnet som en variabel med navnet Product.

2. Legg til en angi variabelverdinode etter utløsernoden , og opprett en ny variabel med navnet ProductTable.

3. Bruk en Power Fx-formel til å definere og tilordne produktnavnene til URL-baner.

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

4. Legg til en annen set-variabelverdinode , og bruk den til å opprette en ny global strengtype med navnet GlobalProductURL.

5. Velg Formel i Til-verdi-innstillingen, og bruk en Power Fx-funksjon til å utføre et oppslag i tabellen basert på verdien til Product inndatavariabelen, Topic.Productsom følger:

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

6. Bruk variabelen i url-adressen for kunnskapskilden:

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

Agenten spør bare den avgrensede delen av nettstedet under kjøringstid.

Vanlige scenarier

Bruk variabler i kunnskapskilder for offentlig nettsted for:

• Produktbasert ruting: Begrens spørringer til spesifikk produktdokumentasjon.

• Område- eller språkfiltrering: Tilordne User.Language til lokaliserte URL-adresser (for eksempel en-us, it-it).

• Miljøspesifikke nettadresser: Bytt mellom utviklings-, test- og produksjonsområder.

Vurderinger

• Kunnskapskilder for offentlige nettsteder bruker Bing-søk og er avhengige av indeksert innhold.
• Url-dybdegrenser gjelder fortsatt når du bruker variabler.
• Variabler endrer bare url-adressen for målet. De påvirker ikke hvordan innhold indekseres eller hentes.