Käyttäjän todentamisen lisääminen avustajaan

Tärkeää

Power Virtual Agents -ominaisuudet ja -toiminnot ovat nyt Microsoft Copilot Studion osa generatiiviseen tekoälyyn tehtyjen panostusten ja parannettujen Microsoft Copilot -integrointien jälkeen.

Joissakin artikkeleissa ja näyttökuvissa voidaan viitata Power Virtual Agentsiin, kun ohjeita ja koulutussisältöä päivitetään.

Voit ottaa käyttöön käyttäjän todentamisen suoraan avustajan keskustelussa. Käyttäjän todentaminen tarkoittaa, että saat muuttujissa käyttäjän perusominaisuudet, kuten nimen ja tunnuksen, mutta voit myös pyytää käyttäjää kirjautumaan sisään käyttämällä todennussolmua, hakea käyttäjän tunnuksen kyseiselle käyttäjälle ja käyttää tätä tunnusta noutaessasi käyttäjän tiedot taustajärjestelmästä.

Muistiinpano

Verkkosovelluksessa ja Microsoft Teamsissa luodut avustajat sisältävät esimääritetyn todennuksen, jota voidaan käyttää vain Teams - ja Power Apps -todennuksessa.

Voit myös määrittää kertakirjautumisen, jotta käyttäjien ei tarvitse kirjautua manuaalisesti. Lisätietoja: SSO-kirjautumisen määritys verkkoa varten.

edellytykset

• Muuttujien käyttö
• Loppukäyttäjätodennuksen määritys.

Verkkosovellus

Lisää käyttäjän todentaminen aiheeseen, jotta asiakkaat voivat kirjautua sisään suoraan keskusteluun. Tämän jälkeen voit muokata keskustelua käyttäjämuuttujien avulla ja käyttää taustajärjestelmiä käyttäjän puolesta.

Manuaalisen todennuksen määrittäminen Microsoft Entra ID:n avulla

Käyttäjän todennus on määritettävä Microsoft Entra ID:n avulla, ennen kuin todennusta voidaan käyttää aiheissa.

1. Kohdan Käyttäjän todennuksen määrittäminen Microsoft Entra ID:n avulla ohjeiden noudattaminen.
2. Palaa tähän artikkeliin.

Käyttäjän todennuksen lisääminen Kirjautuminen -järjestelmäaiheeseen

Kun luot avustajan, Microsoft Copilot Studio lisää automaattisesti järjestelmäaiheen nimeltä Kirjautuminen. Käyttäminen edellyttää avustajan todennuksen määrittämistä manuaaliseksi ja käyttäjien sisäänkirjauksen määrittämistä pakolliseksi. Kun asiakas aloittaa keskustelun avustajan kanssa, Kirjautuminen-aihe käynnistyy ja kehottaa käyttäjää kirjautumaan sisään. Voit mukauttaa Kirjautuminen-aiheen avustajan tarpeiden mukaan.

1. Valitse siirtymisvalikon Asetukset-kohdasta Suojaus.

2. Valitse Toentaminen-ruutu.

3. Valitse Manuaalinen (mukautetulle verkkosivustolle) ja valitse sitten Vaadi käyttäjiä kirjautumaan sisään.

   

   

Käyttäjän todentamisen lisääminen mukautetulla aiheella

Sisäänkirjautuminen-aihe todentaa käyttäjän keskustelun alussa. Jos haluat sallia käyttäjän kirjautua sisään myöhemmin, voit lisätä todentaa-solmun mihin tahansa mukautettuun aiheeseen.

Kun käyttäjät syöttävät käyttäjätunnuksen ja salasanan, häntä saatetaan pyytää syöttämään vahvistuskoodi. Kun he ovat kirjautuneet sisään, heitä ei pyydetä enää kirjautumaan, vaikka he saavuttaisivat toisen Todenna-solmun.

1. Valitse siirtymisvalikon Asetukset-kohdasta Suojaus.

2. Valitse Toentaminen-ruutu.

3. Poista Vaadi käyttäjiä kirjautumaan käytöstä.

4. Valitse siirtymisvalikosta Aiheet ja avaa sitten aihe, johon haluat lisätä todentamisen.

5. Valitse Lisää solmu (+), sitten Kutsu toimintoa ja vielä Todenna.

6. Testaa aiheesi tunnistetietojen toimittajan määrittämän käyttäjän avulla.

Vihje

On tärkeää, että luot polkuja sekä kirjautumisen onnistumiselle että sisäänkirjautumisen epäonnistumiselle. Kirjautuminen voi epäonnistua useista syistä, kuten sellaisten virheiden vuoksi, jotka liittyvät tunnistetietojen toimittajan kirjautumiskokemukseen.

Todennusmuuttujat

Kun olet määrittänyt käyttäjän todennuksen avustajalle, voit käyttää aiheissa todennusmuuttujia. Seuraavassa taulukossa vertaillaan näiden muuttujien käytettävyyttä valitsemasi todennusasetuksen perusteella.

Todennusmuuttuja	Ei todennusta	Vain Teamsille ja Power Appsille	Manuaalinen
User.DisplayName	ei käytettävissä	käytettävissä	käytettävissä
User.FirstName	ei käytettävissä	käytettävissä	käytettävissä
User.LastName	ei käytettävissä	käytettävissä	käytettävissä
User.PrincipalName	ei käytettävissä	käytettävissä	käytettävissä
User.Email	ei käytettävissä	käytettävissä	käytettävissä
User.Id	ei käytettävissä	käytettävissä	käytettävissä
User.IsLoggedIn	ei käytettävissä	käytettävissä	käytettävissä
User.AccessToken	ei käytettävissä	ei käytettävissä	käytettävissä
SignInReason	ei käytettävissä	käytettävissä	käytettävissä

User.DisplayName

Varoitus

Tämä muuttuja ei välttämättä sisällä arvoa. Varmista, että aihe toimii oikein testaamalla sen tunnistetietojen toimittajan käyttäjän avulla.

Muuttuja User.DisplayName sisältää sen näyttönimen, joka on tallennettu tunnistetietojen toimittajaan. Käytä tätä muuttujaa tervehtimisessä tai viitatessasi käyttäjään ilman, että avustajalle kerrotaan tämän nimeä. Näin kokemuksesta tulee aiempaa henkilökohtaisempi.

Microsoft Copilot Studio määrittää automaattisesti User.DisplayName-arvon henkilöllisyyden toimittajan toimittaman vaatimuksen name-arvon, jos profile-vaikutusalue määritettiin, kun manuaalinen todennus määritettiin. Lisätietoja vaikutusalueesta on kohdassa Käyttäjän todennuksen määrittäminen Microsoft Entra ID:n avulla.

User.Id

Varoitus

Tämä muuttuja ei välttämättä sisällä arvoa. Varmista, että aihe toimii oikein testaamalla sen tunnistetietojen toimittajan käyttäjän avulla.

Muuttuja User.Id sisältää käyttäjän tunnuksen, joka on tallennettu tunnistetietojen toimittajaan. Käytä tätä muuttujaa Power Automate -työnkuluissa kutsuaksesi ohjelmistorajapintoja, jotka käyttävät UserID-muuttujaa arvona.

Microsoft Copilot Studio määrittää automaattisesti User.DisplayName-muuttujan tunnistetietojen toimittajan sub-väitteen perusteella.

User.IsLoggedIn

User.IsLoggedIn on totuusarvotyyppinen muuttuja, joka tallentaa käyttäjän sisäänkirjauksen tilan. true-arvo ilmaisee, että käyttäjä on kirjautunut sisään. Voit käyttää tätä muuttujaa luodessasi haarautumislogiikan aiheisiin, jotka tarkistavat sisäänkirjautumisen onnistumisen tai käyttäjän tietojen noutaminen mukaan vain, jos käyttäjä on kirjautunut sisään.

User.AccessToken

Varoitus

Varmista, että olet välittämässä muuttujaa User.AccessToken vain luotettuihin lähteisiin. Se sisältää käyttäjän todennustietoja, jotka vaarantuessaan voivat vahingoittaa käyttäjää.

Muuttuja User.AccessToken sisältää käyttäjän tunnuksen, joka on saatu käyttäjän kirjauduttua sisään. Voit välittää tämän muuttujan Power Automate -työnkuluille, jolloin ne voivat muodostaa yhteyden taustalla oleviin ohjelmistorajapintoihin tai suorittaa toimintoja käyttäjän puolesta.

Älä käytä muuttujaa User.AccessTokenViesti-solmujen sisällä tai työnkuluissa, joihin et luota.

SignInReason

SignInReason on valintatyyppinen muuttuja, joka ilmaisee, milloin käyttäjän on kirjauduttava sisään. Sillä on kaksi mahdollista arvoa:

• SignInRequiredilmaisee, että käyttäjän on kirjauduttava sisään keskustelun alussa käyttämällä kirjautumista Kirjautuminen-aihetta. Vaadi käyttäjiä kirjautumaan -valinnan on oltava käytössä.

• Initializer ilmaisee, että jos käyttäjä ei ole vielä kirjautunut sisään ja hän saavuttaa keskustelussa pisteen, jossa käytetään todennusmuuttujia, häntä pyydetään kirjautumaan.

Perinteinen

Todennusmuuttujat

Jos botille on määritetty Vain Teamsille ja Power Appsille - tai Manuaalinen-todennusvaihtoehto, aiheilla on käytettävissä todennusmuuttujien joukko. Lisätietoja botin todennuksen määrittämisestä on todentamisen määritysohjeissa.

Seuraavassa taulukossa verrataan todennusmuuttujan käytettävyyttä todentamisen määritysvaihtoehdon mukaan seuraavasti:

Todennusmuuttuja	Ei todennusta	Vain Teamsille ja Power Appsille	Manuaalinen
UserDisplayName	❌	✔️	✔️
UserID	❌	✔️	✔️
IsLoggedIn	❌	❌	✔️
AuthToken	❌	❌	✔️

UserDisplayName-muuttuja

Muuttuja UserDisplayName sisältää käyttäjän näyttönimen, joka on tallennettu tunnistetietojen toimittajaan. Voit käyttää tätä muuttujaa tervehtimisessä tai viitatessasi käyttäjään ilman, että siitä kerrotaan botille tarkasti. Näin kokemuksesta tulee aiempaa henkilökohtaisempi.

Tämän kentän arvo saadaan Microsoft Entra ID:n väitteestä name. OAuth-palveluntarjoajille tämä on arvo, joka on tallennettu väitteeseen name. Microsoft Copilot Studio purkaa tämän kentän automaattisesti muuttujaan, joten varmista, että profile on osa todentamisen vaikutusalueen asetuksia.

UserID-muuttuja

Muuttuja UserID sisältää käyttäjän tunnuksen, joka on tallennettu tunnistetietojen toimittajaan. Power Automate -työnkulut käyttävät tätä arvoa kutsuessaan ohjelmistorajapintoja, jotka ottavat arvoksi UserID-muuttujan. Tämän kentän arvo saadaan Microsoft Entra ID:n väitteestä sub. OAuth-palveluntarjoajille tämä on arvo, joka on tallennettu väitteeseen sub. Microsoft Copilot Studio purkaa tämän kentän automaattisesti muuttujaan.

Varoitus

Muuttujia UserDisplayName ja UserID ei välttämättä täytetä, vaan ne voivat olla tyhjiä merkkijonoja. Tämä riippuu tunnistetietojen toimittajan käyttäjän määrityksestä. Varmista, että aiheet toimivat oikein myös muuttujien ollessa tyhjiä, testaamalla ne tunnistetietojen toimittajan käyttäjän avulla.

IsLoggedIn-muuttuja

Muuttuja IsLoggedIn osoittaa, onko käyttäjä kirjautunut sisään (sisäänkirjautumisen jälkeen tai ollen jo sisäänkirjautuneena - tätä kutsutaan sisäänkirjautumisen onnistumispoluksi) vai eikö käyttäjä ole kirjautunut sisään (joka aiheuttaa sisäänkirjautumisen epäonnistumispolun käyttämisen).

IsLoggedIn on totuusarvotyyppinen muuttuja, joka sisältää käyttäjän sisäänkirjauksen tilan. Voit käyttää tätä muuttujaa luodessasi haarautumislogiikan aiheisiin, jotka tarkistavat sisäänkirjautumisen onnistumisen (esimerkiksi mallissa, joka on jo määritetty Todenna-solmun osaksi) tai käyttäjän tietojen noutaminen mahdollisuuksien mukaan vain, jos käyttäjä on kirjautunut sisään.

AuthToken-muuttuja

Muuttuja AuthToken sisältää käyttäjän tunnuksen, joka on saatu käyttäjän kirjauduttua sisään. Voit välittää tämän muuttujan Power Automate -työnkuluille, jolloin ne voivat muodostaa yhteyden taustalla oleviin ohjelmistorajapintoihin tai suorittaa toimintoja käyttäjän puolesta.

Varoitus

Varmista, että olet välittämässä muuttujaa AuthToken vain luotettuihin lähteisiin. Se sisältää käyttäjän todennustietoja, jotka vaarantuessaan voivat vahingoittaa käyttäjää.

Älä käytä muuttujaa AuthTokenViesti-solmujen sisällä tai työnkuluissa, joihin et luota.

Todennusmuuttujien testaaminen

Oletusarvoisesti Testaa botti -ruutu käyttää parhaillaan kirjautuneena olevan käyttäjän tiliä täyttäessään muuttujat UserDisplayName ja UserID. Todennusta käyttävissä testausaiheissa halutaan ehkä käyttää muita arvoja näissä muuttujissa (tai jopa tyhjää arvoa).

Voit testata esimerkiksi miten erikoismerkkejä käytetään tai mitä tapahtuu, jos muuttuja on tyhjä.

Tämä koskee vain Testaa botti -ruutua. Et voi käyttää tässä osassa esiteltyjä komentoja kanavan käytössä olevassa julkaistussa botissa.

Seuraavassa taulukossa esitellään komennot, jotka täyttävät nämä muuttujat. Kirjoita komento Testaa botti -ruutuun samalla tavalla kuin botin kanssa keskustellaan. Saat botilta vahvistusviestin, jos toiminto onnistuu. Jos botti ei käytä todentamista, näkyviin tulee virhe.

Jos nollaat Testaa botti -ruudun (tai teet muutoksia aiheeseen, joka aiheuttaaTestaa botti -ruudun automaattisen nollaamisen), komennot on lähetettävä uudelleen.

Muuttuja	Mukautettu arvo -komento	Tyhjä arvo -komento
UserDisplayName	/debug set bot.UserDisplayName "Value"	/debug set bot.UserDisplayName ""
UserID	Ei saatavissa	/debug set bot.UserID ""

Tärkeä

Et voi täyttää muuttujaa UserID mukautetulla arvolla tietoturvasyistä (arvon on oltava tyhjä).

Todentaminen käytettäessä Vain Teamsille ja Power Appsille -määritystä

Jos todentamisen vaihtoehdoksi on määritetty Vain Teamsille ja Power Appsille, todentamista ei tarvitse erikseen lisätä aiheisiin. Tässä määrityksessä kaikki Microsoft Teamsin käyttäjät kirjautuvat sisään automaattisesti Teams-tunnistetiedoilla, eikä heidän tarvitse erikseen kirjautua sisään todentamiskortilla. Jos todentamisen vaihtoehdoksi on määritetty Manuaalinen, todentamissolmu on lisättävä (myös Teams-kanavalle).

Muistiinpano

Jos todentamisen vaihtoehdoksi on määritetty Vain Teamsille ja Power Appsille, todentamista ei voi erikseen lisätä aiheisiin.

Käyttäjän todentamisen lisääminen aiheeseen

Todenna-solmu pyytää käyttäjää kirjautumaan sisään kirjautumiskortilla. Jos käyttäjä on jo kirjautunut sisään, kehotetta ei tule uudelleen näyttöön, vaikka hän tavoittaisi toisen Todennus-solmun.

Kun käyttäjä syöttää käyttäjätunnuksen ja salasanan kehotteeseen (jota tunnistetietojen toimittajan isännöi), heitä ehkä pyydetään syöttämään vahvistuskoodi kanavasta riippuen. Jotkin kanavat, kuten Microsoft Teams, eivät vaadi käyttäjän syöttämää vahvistuskoodia.

Kun botille on määritetty SSO-kirjautuminen, käyttäjää ei kehoteta kirjautumaan sisään.

Todennus-solmun lisääminen aiheeseen:

1. Siirry muokattavan botin Aiheet-sivulle.

2. Avaa sen aiheen sisällön tuotantoalusta, jolle haluat lisätä todentamismallin.

   Huomautus

   Jos botti on yhdistetty Dynamics 365 Customer Serviceen, todennussolmu ei voi olla osa keskustelupolkua, jota botti seuraa käyttäjien tervehdysvaiheessa. Muussa tapauksessa kirjautumiskortti näytetään kahdesti. Lisää sen sijaan Todenna-solmu toiseen aiheeseen, jonka käyttäjän vastaus käynnistää.

3. Lisää viestisolmu valitsemalla Lisää solmu (+). Kirjoita teksti, jonka botti sanoo juuri ennen kirjautumiskokemusta.

   

4. Valitse viestisolmun alla Lisää solmu (+). Valitse Kutsu toimintoa ja valitse sitten Todenna.

   

   Huomautus

   Todenna-solmu on käytettävissä vain toiminnon valitsimessa dialogipuun lopussa (lehtisolmuna). Sitä ei voi lisätä dialogin keskelle. Kun se on lisätty, alapuolelle ei voi lisätä muita solmuja.

5. Kun valinta on tehty, tietty määrä uusia solmuja lisätään automaattisesti. Nämä solmut sisältävät Todenna-pääsolmun, jonka jälkeen ovat onnistumis- ja epäonnistumispolkujen solmut.

   

AuthToken-käyttö ilman Todenna-solmua

Muuttujat IsLoggedIn ja AuthToken ovat käytettävissä, vaikka et käyttäisi Kutsu toimintona -valikkomerkinnän määrittämää mallia. Jos välität muuttujan AuthToken niin, että käyttäjä ei siirry Todenna-solmun kautta, käyttäjää kehotetaan kirjautumaan kyseisessä vaiheessa.

Muuttujan AuthToken välittäminen voi olla hyödyllistä, jos käyttäjän on kirjauduttava sisään aina tai jos käyttäjä siirretään toisesta aiheesta. Suosittelemme Kutsu toimintoa -merkinnän määrittämän mallin käyttämistä sellaisten tapausten käsittelemisessä, joissa käyttäjä ei kirjaudu sisään.

Huomautus

Jos käyttäjä kirjautuu ulos kesken keskustelun, tätä kehotetaan kirjautumaan sisään uudelleen, jos aihe saapuu solmuun, jossa käytetään muuttujaa AuthToken.

Onnistumispolku

Onnistumispolku vastaa muuttujaa IsLoggedIn = True ja määrittää,onko käyttäjä kirjautunut onnistuneesti sisään (tai onko tämä kirjautunut jo aiemmin).

Jos logiikka käyttää muuttujaa AuthToken (esimerkiksi muodostaakseen yhteyden taustajärjestelmään työnkulun avulla käyttäjän tietojen noutamiseksi), sen tulee käyttää tätä polkua.

Epäonnistumispolku

Epäonnistumispolku vastaa jotain muuta ehtoa kuin ehtoa IsLoggedIn = True. Useimmissa tapauksessa epäonnistumispolkua käytetään, koska käyttäjä ei ole kirjautunut sisään, antanut virheellisen salasanan tai peruuttanut sisäänkirjautumiskokemuksen.

Lisää logiikka, jota haluat käyttää tässä tapauksessa. Esimerkkinä on annettu vaihtoehdot, joiden avulla voi yrittää uudelleen tai eskaloida tapauksen live-asiakaspalvelijalle. Mukauta epäonnistumispolun toiminnot tiettyä skenaariota ja käyttöä varten.

Aiheen testaaminen

Varmista, että testaat aiheen käyttämällä tunnistetietojen toimittajan määrittämää todellista käyttäjää. Varmista, että sisäänkirjauksen onnistumis- ja epäonnistumispolkuja on käytetty, jotta vältytään yllätyksiltä, jos käyttäjä ei kirjaudu sisään tai jos tunnistetietojen tarjoajan sisäänkirjauskokemuksessa on virhe.

Asiaan liittyviä aiheita

Voit myös määrittää kertakirjautumisen, jotta käyttäjien ei tarvitse kirjautua manuaalisesti. Lisätietoja: SSO-kirjautumisen määritys verkkoa varten.