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.

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.

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.

   

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 .

Päivitä lähdelinkki, jos SharePoint sivusto tai kansio nimetään uudelleen

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.

   

4. Valitse Selaa kohteita , jotta löydät haluamasi luettelon, tai kirjoita tietyn SharePoint-luettelon 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 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.

• 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:

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:

   • 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 olet määrittänut suodattimet.

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) -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.

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.