Luovia vastauksia SharePoint sisällön avulla

Luotujen vastausten solmut, jotka käyttävät SharePoint tietolähteenä aiheen tasolla, toimivat yhdistämällä agenttisi SharePoint URL-osoitteeseen, kuten contoso.sharepoint. com/sites/policies. 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.

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.

SharePoint käyttäminen luovien vastausten solmussa

1. Aiheeseen lisää generatiivinen vastaussolmu.

2. Aiheen generatiivisessa vastaussolmusta avaa datalähteen konfiguraatiopaneeli kahdesta paikasta:

   1. Valitse Luo generatiivisia vastauksia -solmussa Tietolähteet-kohdassa Muokkaa.

      

   2. Vaihtoehtoisesti Create generative answers -solmusta valitse kolme pistettä (...), valitse Ominaisuudet ja Data source.

3. Valitse Tietolähteet-kohdastaLisää tietoja. Varmista, että Vain valittujen lähteiden haku on käytössä.

4. Valitse Featured -osassa SharePoint.

   

5. Anna SharePoint URL-osoite. Erota useat URL-osoitteet manuaalisilla rivinvaihdoilla (käytä Vaihto + Enter -näppäimiä).

   Note

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

6. Lisää nimi ja kuvaus. Kuvauksen olisi oltava mahdollisimman yksityiskohtainen, varsinkin jos generatiivinen tekoäly on käytössä, koska kuvaus auttaa generatiivisessa orkestroinnissa.

7. Tallenna aiheen muutokset valitsemalla yläosassa Tallenna.

8. Testaa agenttia käyttämällä lauseita, joiden odotat palauttavan sisältöä.

   Note

   Jos käyttäjätilillä, jolla kirjauduit copilotstudio.microsoft.com ei ole pääsyä SharePoint-sivustoon, et saa sisältöä tai saatat saada järjestelmävirheen.

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.

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