SharePoint lisääminen tietolähteenä

Voit käyttää SharePoint tietolähteenä yhdistämällä agentin url-SharePoint tai SharePoint luetteloihin. Tässä artikkelissa käsitellään SharePoint integrointitoimintoja kokonaisuudessaan valitsemalla SharePoint-vaihtoehto Ad knowledge -valintaikkunassa.

Muistio

Kun käytät SharePoint tietolähteenä, keskustelutallenteet eivät sisällä vastauksen luomiseen käytettyjen lähdeasiakirjojen sisältöä (search_resultskenttää). Kysymykset ja vastaus ovat edelleen mukana.

  • SharePoint tietolähteisiin perustautuville agenteille Turn on Work IQ tietojen noutamisen ja vastauksen laadun parantaminen. Tämä ominaisuus hyödyntää huipputason sisäisiä hakutyökaluja, joiden avulla agentti voi saada suuremman määrän kontekstia tarkemmin. Kuitenkin järjestelmän monimutkaisuuden kasvaessa tietyt käyttäjät ja kyselyt saattavat kokea pienen viiveen kasvun.

Kun julkaiset agentin, luotavia vastauksia käyttävät kutsut tehdään sen käyttäjän puolesta, joka keskustelee agentin kanssa. Agentti käyttää määrittämiäsi todennusasetuksia . Copilot Studio ja Microsoft Teams luodut agentit määritetään oletusarvoisesti Todentaminen Microsoft avulla -todennusvaihtoehdolla. Tämä vaihtoehto toimii esimerkiksi Microsoft Teams, Power Apps ja Microsoft 365 Copilot.

Muistio

Luovia vastauksia voi käyttää SharePoint tietoihin Microsoft Teams keskusteluissa ilman manuaalista todentamista. Jos haluat käyttää tätä menetelmää aiemmin julkaistussa agentissa, määritä agentti käyttämään Todentaa microsoft ja julkaise se sitten uudelleen Microsoft Teams. Tämän muutoksen voimaantulo voi kestää muutaman tunnin. Jos käyttäjällä on keskustelu käynnissä, eikä muutos tule voimaan, käyttäjä voi kirjoittaa keskustelussa Aloita alusta. Tällöin avustajan keskustelu pakotetaan käynnistymään uudelleen ja käyttämään agentin uusinta versiota. Nämä muutokset ovat nyt käytettävissä käyttäjän ja agentin välisissä Teams 1:1 -keskusteluissa. Ne eivät ole vielä käytettävissä ryhmäkeskusteluissa ja kanavaviesteissä.

Jos haluat käyttää manuaalista todennusta agentissa, katso Todentamisen lisäskenaariot.

SharePoint-sivustojen lisääminen tietolähteeksi

Kun käyttäjä esittää kysymyksen, eikä agentilla ole vastaukseksi sopivaa aihetta käytössään, agentti hakee URL-osoitteen ja kaikkien alipolkujen avulla. Esimerkiksi URL-osoite, kuten contoso.sharepoint.com/sites, sisältää myös alipolut, kuten contoso.sharepoint.com/sites/policies. Generatiiviset vastaukset laativat tästä sisällöstä yhteenvedon kohdistetuksi vastaukseksi.

Jos haluat lisätä SharePoint-sivuston tietolähteeksi, suorita seuraavat vaiheet:

  1. Avaa agentti.

  2. Valitse Lisää tiedotYleiskatsaus- tai Tiedot-sivulta tai generatiivisten vastausten solmunOminaisuudet-kohdasta.

  3. Valitse Featured -osassa SharePoint.

    Näyttökuva Lisää tietoja -valintaikkunasta, jossa korostetaan SharePoint-asetusta.

  4. Kirjoita SharePointin URL-osoite. Erota useat URL-osoitteet manuaalisilla rivinvaihdoilla (käytä Vaihto + Enter -näppäimiä). Jos haluat käyttää muuttujaa staattisen URL-osoitteen sijaan, valitse MUUTTUJAvalitsin-kuvake URL-kentän vierestä ja valitse Mukautettu-, Järjestelmä- tai Ympäristö-muuttuja .

  5. Lisää nimi ja kuvaus. Anna tarkka kuvaus, erityisesti jos luotava tekoäly on käytössä, sillä kuvaus helpottaa sen luomista orkestroinniksi.

  6. Viimeistele tietolähteen lisääminen valitsemalla Lisää agenttiin .

Jos nimeät uudelleen tietolähteen käyttämän SharePoint sivuston tai kansion, olemassa oleva lähdelinkki voi rikkoa ja aiheuttaa käyttöoikeusvajeen. Kun näin tapahtuu, agentti ei ehkä pääse tietokantaan.

Käyttöoikeuden palauttaminen:

  1. Pyydä SharePoint-järjestelmänvalvoja myöntämään asianmukaiset oikeudet uudelleennimettyun sijaintiin ja luomaan uusi lähdelinkki.

  2. Avaa agentti ja päivitä SharePoint tietolähteeseen juuri luodulla linkillä.

SharePoint-luetteloiden lisääminen tietolähteeksi

SharePoint-luettelot ovat suosittu tapa tallentaa taulukkomuotoisia tietoja sekä tarjota nopea ja helppo tietojen käyttö. Agenttisi voi käyttää näitä luetteloita tietolähteenä. Kun lisäät SharePoint list tietolähteeksi, luot reaaliaikaisen yhteyden lähteeseen, joten uusimpia tietoja käytetään kyselyihin ja järkeiluun. Käyttäjät todennetaan käyttämällä SharePoint tunnistetietojaan, mikä varmistaa, että heillä on oikeus käyttää tietoja, ennen kuin agenttisi antaa vastauksen.

  1. Avaa agentti.

  2. Valitse Lisää tiedotYleiskatsaus- tai Tiedot-sivulta tai generatiivisten vastausten solmunOminaisuudet-kohdasta.

  3. Valitse joko Esittelyssä-osassa tai Lataa tiedosto -osassa SharePoint.

    Screen-kuva Lisää tietoja -valintaikkunasta, jossa näkyy SharePoint-vaihtoehto Lataa tiedosto -osassa.

  4. Valitse Selaa kohteita , jotta löydät haluamasi luettelon, tai kirjoita tietyn SharePoint-luettelon URL-osoite.

    Lisää tietoja -valintaikkunan näyttökuva SharePoint-asetuksen valitsemisen jälkeen korostamalla Selaa kohteita ja syötä URL-asetukset.

  5. Kun valitset Selaa kohteita, valintaikkunaan täytetään automaattisesti Omat luettelot ja Viimeaikaiset luettelot. Omat luettelot näyttää vain SharePoint-luettelosovelluksessa luodut luettelot. Kaikki muut luettelot näkyvät Viimeaikaiset luettelot -kohdassa. Jos et näe tarvitsemaasi luetteloa, avaa SharePoint ja käytä luetteloa. Luettelo näkyy viimeaikaiset luettelot -kohdassa.

    Näyttökuva Lisää tietoja -valintaikkunasta, kun SharePoint-asetus on valittu ja tekijä on valinnut Selaa kohteita -vaihtoehdon luetteloiden valitsemiseksi.

    Voit valita enintään 10 luetteloa kerrallaan. Saat parhaat tulokset käyttämällä vain enintään 10 luetteloa agenttia kohden. Yli 35 000 riviä sisältävät luettelot vaikuttavat laatuun ja viivettän.

    Jokainen luettelo lisätään agentin tietolähteisiin yksittäisinä kohteina. Jos haluat määrittää agentille lisää luetteloita, käytä näitä vaiheita ja valitse lisää luetteloita.

    Muistio

    Jos haluat käyttää SharePoint-luetteloa jaetun käyttöoikeuden kanssa, mutta sitä ei näytetä Recent Lists, liitä luettelon URL-osoite URL-valintaan.

  6. Kun olet valinnut haluamasi luettelot, valitse Vahvista valinta.

  7. Lisää nimi ja kuvaus. Anna tarkka kuvaus, erityisesti jos luotava tekoäly on käytössä, sillä kuvaus helpottaa sen luomista orkestroinniksi.

  8. Viimeistele tietolähteen lisääminen valitsemalla Lisää agenttiin .

Todentamisen lisäskenaariot

Copilot Studio määrittää oletusarvoisesti agentit todentamaan käyttäjät Microsoft-todennuksen avulla käyttämään SharePoint lähdettä, kun he muodostavat yhteyttä agenttiin Microsoft Teams, Power Apps tai Microsoft 365 Copilot kautta. Jos sinun on kuitenkin määritettävä todentaminen manuaalisesti, sinun on suoritettava seuraavat vaiheet, jotta luodut vastaukset toimivat SharePoint tietolähteiden kanssa.

Tärkeää

Jos Restricted SharePoint Search on käytössä, SharePoint käyttö on estetty.

  • SharePoint lähteistä peräisin olevat luotuja vastauksia eivät ole guest -käyttäjien käytettävissä kertakirjautumista käyttävissä sovelluksissa.

  • Lisätietoja agentin todentamisesta on kohdassa Todentaminen.

  • Ohjeet tarvittavan sovelluksen rekisteröinnin luomiseen Microsoft Entra ID Käyttäjätodennuksen määrittäminen Microsoft Entra ID:llä. Kun luot tämän rekisteröinnin, sinun tai järjestelmänvalvojasi täytyy määrittää Sites.Read.All- ja Files.Read.All-alueet Microsoft Entra ID sovelluksen rekisteröinnissä.

  • Valitsemalla No-todennuksen määrittää, ettei agenttisi nouda tietoja SharePoint.

  • Kun todennus määritetään, toiminta-alueet hallinnoivat käyttäjäoikeuksia. Määritä Sites.Read.All ja Files.Read.All vaikutusaluekentässä, joka on Copilot Studion nykyisten profile- ja openid-arvojen lähellä. Nämä alueet eivät anna käyttäjille entistä enemmän käyttöoikeuksia agenttia käytettäessä, mutta ne sallivat sallitun sisällön SharePoint sivustosta luoville vastauksille määritetyllä tavalla.

  • SharePoint tukee Authenticate manuaalisesti -asetusta seuraavilla todentamispalvelun tarjoajilla:

    • Microsoft Entra ID
    • Microsoft Entra ID V2 ja yhdistettyjä tunnistetietoja
    • Microsoft Entra ID V2 ja varmenteet
    • Microsoft Entra ID V2 ja asiakassalaisuudet

  • SharePoint ei tue manuaalista todentamista Generic OAuth -todennuksen avulla.

  • Tämä määritys koskee vain generatiivisia vastauksia, ei Power Platform-yhdistimiä.

SharePoint lähteen suodattaminen

Jos haluat parantaa agenttisi SharePoint tietolähteen suorituskykyä, määritä hakukyselyn parametrit. Nämä kyselyparametrit määrittävät, mitä haetaan tiedonlähteestä. Esimerkiksi voit määritellä, että haluat haun vain niistä kohteista, joita on muokattu viimeisen kuuden kuukauden aikana. Muodosta tämä suodatintyyppi seuraavasti:

Määrite Operaattori Arvo
Modified on on or after X date

Näyttökuva SharePointin tietolähteen lisäasetuksista, jotka näyttävät esimerkin määritetyistä asetuksista.

Suodatusehtojen luominen

Kun olet lisännyt SharePoint tietolähteen, määritä hakuehdot.

  1. Valitse Tieto-sivulla SharePoint-lähteesi.

  2. Valitse kolme pistettä (... SharePoint lähteen ) ja valitse Edit.

  3. Valitse Lisäasetukset.

  4. Luo suodattimia, jotka sisältävät tai jättävät pois SharePoint-tietolähteen tietoja. Perusta suodatin johonkin seuraavista valinnoista:

    • Otsikko
    • Tekijä
    • Muokkaaja
    • Muokattu

  5. Määritä ehdon arvoksi jokin seuraavista arvoista:

  6. Valitse Tallenna , kun olet määrittänut suodattimet.

Jos haluat suodattaa SharePoint lähteesi, poista seuraavat asetukset käytöstä:

  • Verkkohaku
  • Agenttitasolla Käytä yleistä tietämystä -asetus agentin luovia tekoälyasetuksia kohtaan
  • Salli tekoälyn käyttää omaa yleistä tietämystään (esikatselu) -asetusta aiheen tasolla luovien vastausten solmussa

Kun poistat nämä asetukset käytöstä, agentti vastaa "ei vastausta", jos se ei löydä tulosta suodatetusta SharePoint tietolähteestä.

Muuttujien käyttäminen URL-osoitteina

Voit hallita agentin käyttämän sisällön laajuutta dynaamisesti käyttämällä muuttujia julkisessa sivustossa tai SharePoint tietolähteen URL-osoitteita.

Sen sijaan, että luot useita tietolähteitä eri skenaarioita varten, määritä yksittäinen tietolähde ja lisää muuttuja URL-osoitteeseen. Suorituksen aikana Copilot Studio ratkaisee muuttujan ja käyttää tuloksena saatavaa URL-osoitetta maadoitukseen.

Muuttujatuki

Kun lisäät tai muokkaat julkista sivustoa tai SharePoint tietolähteen URL-osoitetta, voit lisätä muuttujan URL-kenttään.

Käytä muuttujaa seuraaviin tarkoituksiin:

  • Polun liiottaminen perus-URL-osoitteeseen

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

  • Korvaa koko URL-osoite

    {variable}

Suorituksen aikana muuttujan ratkaisu on merkkijonoarvo. Tietolähde on rajoitettu ratkaistuun URL-osoitteeseen.

Muistio

Muuttujan käyttäminen muuttaa sitä, mitä URL-osoitetta käytetään maadoituksena. Se ei muuta julkisten sivustojen URL-osoitteen rakennevaatimuksia tai syvyysrajoituksia.

Muuttujan luominen ja määrittäminen

Muuttujan käyttäminen julkisessa sivustossa tai SharePoint tietolähteessä:

  1. Luo merkkijonomuuttuja , jolla on yleinen vaikutusalue.

  2. Määritä muuttujan arvo jollakin seuraavista vaihtoehdoista:

  3. Lisää muuttuja URL-kenttään valitsemalla {x} (Lisää muuttuja).

  4. Testaa agentti vahvistaaksesi, että muuttuja korjaa odotetun URL-osoitteen.

Esimerkki: Vaikutusalue tuotteen mukaan

Käyttäjän kyselyn perusteella voit rajata tietoja eri tuotealueille.

  1. Aiheen syötteen avulla voit tallentaa tuotteen nimen muuttujana nimeltä Product.

  2. Lisää Määritä muuttujan arvo -solmu Käynnistin-solmun jälkeen ja luo uusi muuttuja nimeltä .ProductTable

  3. Tuotenimien määrittäminen ja yhdistäminen URL-polkuihin Power Fx -kaavan avulla.

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

  4. Lisää toinen Joukkomuuttujan arvosolmu ja luo sen avulla uusi yleinen muuttuja nimeltä GlobalProductURL.

  5. Valitse To-arvo-asetuksellaKaava ja suorita haku taulukkoon Power Fx -funktion avulla syötemuuttujan ProductTopic.Productarvon perusteella seuraavasti:

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

  6. Käytä -muuttujaa tietolähteen URL-osoitteessa:

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

Agentti tekee kyselyn vain verkkosivuston rajoitettuun osioon ajon aikana.

Yleiset skenaariot

Käytä muuttujia julkisten verkkosivustojen tietolähteissä seuraavissa lähteissä:

  • Tuotepohjainen reititys: Vaikutusaluekyselyt tietyille tuotedokumentaatioille.

  • Alueen tai kielen suodatus: Yhdistä User.Language lokalisoituihin URL-osoitteisiin (esimerkiksi en-us, it-it).

  • Ympäristökohtaiset URL-osoitteet: Siirry kehitys-, testi- ja tuotantosivustojen välillä.

Huomioitavia seikkoja

  • Julkiset verkkosivuston tietolähteet käyttävät Bing-hakua ja ovat riippuvaisia indeksoidusta sisällöstä.
  • URL-syvyysrajoitukset ovat edelleen voimassa muuttujia käytettäessä.
  • Muuttujat muuttavat vain kohde-URL-osoitetta. Ne eivät vaikuta siihen, miten sisältö indeksoidään tai noudetaan.

Tärkeää

Muuttujan on ratkaistava kelvollinen julkinen URL-osoite, joka täyttää julkisten verkkosivustojen tietolähteiden vaatimukset. Virheelliset tai tukemattomat URL-osoitteet eivät välttämättä palauta tuloksia.

  • Last updated on