SharePoint lisääminen tietolähteenä

SharePoint toimii tietolähteenä yhdistämällä agenttisi URL-SharePoint tai SharePoint luetteloihin. Tässä artikkelissa käsitellään SharePoint integrointitoimintoja kokonaisuudessaan valitsemalla SharePoint-vaihtoehto Ad knowledge -valintaikkunassa.

Note

• Lisää tiedot -valintaikkunassa on kaksi SharePoint-vaihtoehtoa. Tiedoston lataaminen -osion SharePoint-toiminnolla ladataan yksittäisiä SharePoint-tiedostoja tai -kansioita, ja se mahdollistaa tiedostojen synkronointiominaisuudet. Tässä artikkelissa käsitellään SharePoint-vaihtoehtoa, joka tukee SharePoint täysin Copilot Studiossa.

• Luettelo rajoituksista ja tuetuista SharePoint-toiminnoista on kohdassa SharePoint-verkkosovelluksen rajoitukset.

• Jos haluat lisätä yksittäisiä SharePoint-tiedostoja tai -kansioita, katso SharePoint-tiedostojen ja -kansioiden lisääminen.

• Agenttivastaukset, jotka käyttävät SharePoint tietolähteenä, eivät sisälly sisältötallenteisiin.

• 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, generatiivisia vastauksia käyttävät kutsut suoritetaan agentin kanssa keskustelevan käyttäjän puolesta käyttäen agentissa määritettyjä todennusasetuksia. Copilot Studiossa ja Microsoft Teams luoduille agenteille määritetään oletusarvoisesti Authenticate with Microsoft authentication option, joka toimii esimerkiksi Microsoft Teams, Power Apps ja Microsoft 365 Copilot.

Note

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, toimi seuraavasti:

1. Avaa agentti.

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

3. Valitse Featured -osassa SharePoint.

   

4. Anna SharePoint 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. Kuvauksen olisi oltava mahdollisimman yksityiskohtainen, varsinkin jos generatiivinen tekoäly on käytössä, koska kuvaus auttaa generatiivisessa orkestroinnissa.

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

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-luettelon tietolähteeksi, luot reaaliaikaisen yhteyden lähteeseen, joten uusimpia tietoja käytetään kyselyihin ja päättelemiseen. Käyttäjät todennetaan SharePoint tunnistetiedoillaan, 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 Featured -osassa SharePoint.

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

   

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.

   

   Voit valita enintään 15 luetteloa samalla kertaa. 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.

   Note

   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. Kuvauksen olisi oltava mahdollisimman yksityiskohtainen, varsinkin jos generatiivinen tekoäly on käytössä, koska kuvaus auttaa generatiivisessa orkestroinnissa.

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.

Important

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

Tekijät voivat auttaa agenttinsa SharePoint-tietolähteen suoritustehoa määrittämällä 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. Tällainen suodatin muodostetaan seuraavasti:

Ominaisuus	Operaattori	Arvo
Modified on	on or after	X date

Suodatusehtojen luominen

Kun olet lisännyt SharePoint tietolähteen, voit määrittää 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. Voit perustaa suodattimen johonkin seuraavista valinnoista:

   • Otsikko
   • Tekijä
   • Muokannut
   • Muokattu

5. Voit määrittää ehdon arvoksi jonkin seuraavista arvoista:

   • Staattinen arvo
   • Muuttujasyöte, jonka käyttäjä antaa keskustelun aikana agentin kanssa ja joka tallennetaan sitten mukautettuna yleisenä muuttujana
   • Järjestelmämuuttuja

6. Valitse Tallenna , kun suodattimet on määritetty.

Lisää asetuksia haun parantamiseksi

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) aiheen tasolla luovien vastausten solmussa

Näiden asetusten poistaminen käytöstä varmistaa, että 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.

Note

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:

   • Aiheiden syöttötiedot
   • Käyttäjäprofiilin ominaisuudet, kuten kieli
   • Ympäristömuuttujat
   • Agenttiprosessit tai liitännät

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.

Important

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.