Käyttäjän todennuksen lisääminen aiheisiin

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

Kohdan Käyttäjän todennuksen määrittäminen Microsoft Entra ID:n avulla ohjeiden noudattaminen.

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

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

1. Avaa agenttisi Copilot Studiossa ja valitse sivun yläreunasta Asetukset ja sitten Suojaus.
2. Valitse Todennus.
3. Valitse ensin Manuaalinen todennus ja sitten Vaadi käyttäjiä kirjautumaan.
4. Kaikkien manuaalisten todennuskenttien määrittäminen tarvittaessa.
5. Valitse Tallenna.

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

Kirjautuminen-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 asiakas syöttää käyttäjänimen ja salasana, heitä pyydetään ehkä syöttämään vahvistuskoodi. Kun hän on kirjautunut sisään, häntä ei pyydetä uudelleen, vaikka hän pääsisi toiseen Todenna-solmuun.

1. Valitse ensin Asetukset sivun yläreunassa ja valitse sitten Suojaus.

2. Valitse Toentaminen-ruutu.

   Muistiinpano

   Käyttäjän todennuksen lisääminen mukautettuun aiheeseen edellyttää, että Manuaalinen todennus valitaan.

3. Valitse Manuaalinen todennus ja poista valinta kohdasta Vaadi käyttäjiä kirjautumaan sisään.

4. Kaikkien manuaalisten todennuskenttien määrittäminen tarvittaessa.

5. Valitse Tallenna.

6. Valitse sivun yläosassa Aiheet.

7. Valitse Lisää solmu ( ) >Lisäasetukset>Todenna.

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

Jos todennusvaihtoehdoksi on määritetty Käytä Microsoft-todennusta, 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 todennusvaihtoehdoksi on määritetty Manuaalinen, Todenna-solmu on lisättävä (myös Teams-kanavalle).

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

Todenna-solmu pyytää käyttäjää kirjautumaan sisään kirjautumiskortilla. Kun käyttäjä kirjautuu sisään, häntä ei pyydetä uudelleen, vaikka hän pääsisi toiseen Todenna-solmuun.

Kun käyttäjä syöttää käyttäjänimen ja salasanan kehotteeseen (jota tunnistetietojen toimittajan isännöi), kanavan mukaan käyttäjää ehkä pyydetään syöttämään vahvistuskoodi. Joillakin kanavilla, kuten Microsoft Teamsissa, käyttäjältä ei vaadita vahvistuskoodia.

Kun agentillasi on SSO-kirjautuminen käytössä, käyttäjää ei pyydetä kirjautumaan sisään.

Todenna-solmun lisääminen aiheeseen:

1. Siirry muokattavan agentin Aiheet-sivulle.

2. Avaa aihe, johon haluat lisätä todennusmallin.

   Muistiinpano

   Jos agenttisi on yhdistetty Dynamics 365 Customer Serviceen, todennussolmu ei voi olla osa keskustelupolkua, jota agentti seuraa käyttäjiä aluksi tervehtiessään; muuten 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 agentti sanoo juuri ennen kirjautumiskokemusta.

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

   

   Muistiinpano

   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 voi lisätä muita solmuja.

   Uudet solmut tulevat näkyviin automaattisesti: päätason Todenna-solmu ja sen jälkeen onnistumis- ja epäonnistumispolun solmut.

User.AccessToken-käyttö ilman Todenna-solmua

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

Muuttujan User.AccessToken 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. Käytä Kutsu toimintoa -merkinnän määrittämää mallia sellaisten tapausten käsittelemisessä, joissa käyttäjä ei kirjaudu sisään.

Onnistumispolku

Onnistumispolku vastaa ehtoa User.IsLoggedIn = True ja määrittää,onko käyttäjä kirjautunut onnistuneesti sisään.

Jos logiikka käyttää muuttujaa User.AccessToken (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 tapauksissa 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ä sekä kirjautumisen onnistumisen että epäonnistumisen polut testataan. Näin varmistat, ettei tule yllätyksiä, jos käyttäjä epäonnistuu kirjautumisessa tai jos tunnistetietojen tarjoajan kirjautumisprosessissa ilmenee virhe.

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

User.DisplayName

Muuttuja User.DisplayName sisältää näyttönimen, joka on tallennettu tunnistetietojen toimittajaan. Käytä tätä muuttujaa tervehtimisessä tai viitatessasi käyttäjään ilman, että käyttäjän tarvitsee kertoa agentille nimensä. Näin kokemuksesta tulee aiempaa henkilökohtaisempi.

Copilot Studio asettaa automaattisesti User.DisplayName-muuttujan arvon tunnistetietojen toimittajan antaman name-väitteen perusteella, kunhan profile-laajuus on määritelty manuaalisen todennuksen asetuksissa. Lisätietoja on kohdassa Käyttäjän todentamisen määrittäminen Microsoft Entra ID:n avulla.

User.Id

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.

Copilot Studio asettaa User.DisplayName-muuttujan arvon automaattisesti tunnistetietojen toimittajan toimittaman sub-vaatimuksen perusteella.

User.IsLoggedIn

User.IsLoggedIn on totuusarvomuuttuja, joka tallentaa käyttäjän kirjautumisen 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

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:

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

• Initializer ilmaisee, että kun käyttäjä ei ole kirjautuneena sisään ja hän saavuttaa keskustelun kohdan, jossa käytetään todennusmuuttujia, häntä pyydetään kirjautumaan sisään.

Jos agentti on määritetty käyttäen todennusvaihtoehtoa Käytä Microsoft-todennusta tai Manuaalinen, aiheissasi on käytettävissä joukko todennusmuuttujia. Lisätietoja on kohdassa Käyttäjän todennuksen määrittäminen Copilot Studiossa.

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

UserDisplayName-muuttuja

Muuttuja User.DisplayName sisältää käyttäjän näyttönimen, joka on tallennettu tunnistetietojen toimittajaan. Voit käyttää tätä muuttujaa tervehtimisessä tai viitatessasi asiakkaaseen ilman, että sitä tarvitsee kertoa agentille erikseen. 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. Copilot Studio purkaa tämän kentän automaattisesti muuttujaan, joten varmista, että profile on osa todentamisen laajuuden asetuksia.

UserID-muuttuja

Muuttuja User.Id 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. Copilot Studio purkaa tämän kentän automaattisesti muuttujaan.

IsLoggedIn-muuttuja

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

User.IsLoggedIn on totuusarvomuuttuja, joka sisältää käyttäjän kirjautumistilan. 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.

User.AccessToken-muuttuja

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.

Todennusmuuttujien testaaminen

Oletusarvoisesti Testaa botti -ruutu käyttää parhaillaan kirjautuneena olevan käyttäjän tiliä täyttäessään muuttujat User.DisplayName ja User.Id. 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ä.

Seuraavassa taulukossa esitellään komennot, jotka täyttävät nämä muuttujat. Nämä komennot pätevät vain Testaa botti -ruutuun; niitä ei voi käyttää julkaistussa kanavassa käyttöönotetussa agentissa.

Kirjoita haluttu komento Testaa botti -ruutuun samalla tavalla kuin agentin kanssa keskustellaan. Saat agentilta vahvistusviestin, jos toiminto onnistuu. Jos agentti 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.