Lägg till slutanvändarautentisering i ämnen

Du måste konfigurera användarautentisering med Microsoft Entra ID innan du kan använda autentisering i dina ämnen.

Följ anvisningarna i Konfigurera användarautentisering med Microsoft Entra ID.

Lägg till användarautentisering med inloggningssystemet ämne

När du skapar en agent lägger Copilot Studio automatiskt till ett systemämne kallat Inloggning. För att använda det måste du ställa in autentisering till manuell för din agent och kräva att användarna loggar in. När en kund startar en konversation med agenten utlöses ämnet Inloggning och uppmanar användaren att logga in. Det går att Anpassa ämnet Inloggning efter behov lämpligt för din agent.

1. Öppna din agent i Copilot Studio och välj Inställningar överst på sidan och välj sedan Säkerhet.
2. Välj Autentisering.
3. Välj Autentisera manuellt och välj sedan Kräv att användare loggar in.
4. Konfigurera alla manuella autentiseringsfält efter behov.
5. Välj Spara.

Lägg till slutanvändarautentisering med Anpassat ämne

Ämnet Inloggning autentiserar användaren i början av konversationen. Om du vill tillåta användaren att logga in senare kan du lägga till en nod för autentisering till ett Anpassat ämne.

När kunderna anger sina användarnamn och lösenord kan de uppmanas att ange en verifieringskod. När de har loggat in tillfrågas de inte igen, även om de når en annan Autentiseringsnod.

1. Välj Inställningar högst upp på sidan och välj sedan Säkerhet.

2. Välj panelen Webbautentisering.

   Kommentar

   Du måste välja Autentisera manuellt om du vill lägga till användarautentisering till ett Anpassat ämne.

3. Välj Autentisera manuellt och rensa sedan kryssrutan Kräv att användare loggar in.

4. Konfigurera alla manuella autentiseringsfält efter behov.

5. Välj Spara.

6. Välj Redigera högst upp på sidan.

7. Välj Lägg till nod ( ) >Avancerat>Autentisera.

8. Testa din logik med hjälp av en användare som konfigurerats med din identitetsprovider.

Om autentiseringsalternativet är inställt på Autentisera med Microsoft behöver du inte uttryckligen lägga till autentisering i dina ämnen. I den här konfigurationen loggas alla användare i Microsoft Teams in automatiskt via sina Teams-autentiseringsuppgifter, och behöver inte uttryckligen logga in med ett autentiseringskort. Om du har angett autentiseringsalternativet Manuellt måste du lägga till autentiseringsnoden (även för Teams-kanalen).

Lägg till slutanvändarautentisering i ett ämne

Autentiseringsnoden uppmanar en användare att logga in med ett inloggningskort. När en användare har loggat in tillfrågas användaren inte igen, även om de når en annan Autentiseringsnod.

När användaren har angett sitt användarnamn och lösenord i prompten (som finns i identitetsprovidern) uppmanas den kanske att ange en valideringskod beroende på kanal. Vissa kanaler, till exempel Microsoft Teams, kräver inte att användaren anger någon valideringskod.

Om din agent har SSO konfigurerat kommer användaren inte att uppmanas att logga in.

För att lägga till en autentiseringsnod i ditt ämne:

1. Gå till sidan Ämnen för den agenten du vill redigera.

2. Öppna ämnet där du vill lägga till autentiseringsmallen.

   Kommentar

   Om din agent är kopplad till Dynamics 365 Customer Service kan autentiseringsnoden inte placeras i den konversationsväg som agenten följer när den först hälsar på användare – annars visas inloggningskortet två gånger. Istället bör du lägga till noden Autentisera i ett annat ämne som utlöses av ett användarsvar.

3. Välj Lägg till nod (+) för att lägga till en meddelandenod. Ange vad agenten ska säga för att indikera att en inloggning kommer att äga rum.

4. Under meddelandenoden väljer du Lägg till nod (+), väljer Anropa en åtgärd och sedan Autentisera.

   

   Kommentar

   Noden Autentisera är endast tillgänglig i åtgärdsväljaren i slutet av ett dialogträd (som en lövnod). Du kan inte lägga till det i mitten av en dialog. När den har lagts till kan andra noder läggas till under den.

   Nya noder visas automatiskt: en överordnad Autentiseringsnod följt av noder både för en lyckad och misslyckad sökväg.

User.AccessToken-användning utan autentiseringsnod

Variablerna User.IsLoggedIn och User.AccessToken är tillgängliga även om du inte använder mallen som visas i menyalternativet Anropa åtgärd. Om du skickar User.AccessToken-variabeln utan att först tvinga användaren att genomgå via noden Autentisera uppmanas användaren att logga in i det steget.

Att skicka variabeln User.AccessToken kan vara praktiskt om du alltid förväntar dig att användaren ska vara inloggad eller om användaren omdirigeras från ett annat ämne. Använd mallen från posten Anropa en åtgärd för att behandla ärenden där användaren inte kan logga in.

Sökväg för Genomfört

Sökvägen motsvarar User.IsLoggedIn = True och konton för när användaren har loggat in.

Logik som använder User.AccessToken-variabeln (t.ex. för att ansluta till ett serversystem med ett flöde i syfte att hämta en användares information) bör användas med den här sökvägen.

Sökväg till misslyckande

Sökvägen till misslyckande är likställt med ett annat villkor än IsLoggedIn = True. I de flesta fall inträffar sökvägen till felet eftersom användaren inte loggade in, använde fel lösenord eller avbröt inloggningen.

Lägg till logik du kanske vill behandla ärendet i. Till exempel finns alternativ för att försöka igen eller eskalera till en live-handläggare. Anpassa åtgärder försökvägen till felet för just din situation och användning.

Testa ditt ämne

Kontrollera att du testar ämnet med hjälp av en riktig användare som konfigurerats i identitetsleverantören. Kontrollera både lyckade inloggningar och misslyckade flöden. På så sätt undviker du överraskningar om användaren inte kan logga in eller om det uppstått ett fel med identitetsleverantörens inloggningsprocess.

När du har konfigurerat användarautentisering för din agent kan du använda autentiseringsvariabler i dina ämnen. I följande tabell jämförs tillgängligheten av dessa variabler baserat på autentiseringsalternativ du väljer.

User.DisplayName

User.DisplayName-variabeln innehåller visningsnamn som lagras i identitetsprovidern. Använd den här variabeln för att hälsa på eller referera till användaren utan att de behöver ange sitt namn explicit till agenten, vilket gör konversationen mer personlig.

Copilot Studio anger automatiskt värdet User.DisplayName från anspråket name som identitetsleverantören uppger, förutsatt att profile omfattningen har definierats när manuell autentisering konfigurerades. Läs mer i Konfigurera användarautentisering med Microsoft Entra ID.

User.Id

User.Id-variabeln innehåller användarens ID som lagras i identitetsprovidern. Använd denna variabel i Power Automate-flöden för anropa API:er som använder UserID som ett värde.

Copilot Studio anger automatiskt värdet User.DisplayName från anspråket sub som ges av identitetsleverantören.

User.IsLoggedIn

User.IsLoggedIn är en boolesk variabel som lagrar användarens inloggningsstatus. Värdet true anger att användaren är inloggad. Du kan använda den här variabeln för att skapa förgreningslogik som söker efter en lyckad inloggning eller för att på hämta användarinformation bara om användaren är inloggad.

User.AccessToken

User.AccessToken-variabeln innehåller användarens token som skapats efter det att användaren har loggat in. Du kan skicka denna variabel till Power Automate-flöden så att de kan ansluta till API:er för serversystem och hämta användarinformation, eller också utföra åtgärder å användarens vägnar.

Använd inte User.AccessToken i Meddelande-noder eller för flöden som du inte litar på.

SignInReason

SignInReason är en alternativtyp variabel som anger när användaren måste logga in. Den har två möjliga värden:

• SignInRequired anger att användaren måste logga in i början av konversationen med hjälp av systemämnet Logga in. Kräv att användare loggar in måste aktiveras.

• Initializer anger att när en användare inte är inloggad och de når en punkt i konversationen som använder autentiseringsvariabler, uppmanas de att logga in.

Om din agent konfigureras med antingen Autentisera med Microsoft eller Manuell autentisering har du en uppsättning autentiseringsvariabler tillgängliga i dina ämnen. Läs mer i Konfigurera användarautentisering i Copilot Studio.

I följande tabell jämförs autentiseringsvariabelns tillgänglighet efter alternativ för autentiseringskonfiguration:

UserDisplayName-variabel

User.DisplayName-variabeln innehåller användarens visningsnamn som lagras i identitetsprovidern. Du kan använda den här variabeln som hälsningsfras eller för att referera till kunden utan att de uttryckligen behöver tala med agenten, vilket gör den mer personAnpassad.

Värdet i det här fältet hämtas från Microsoft Entra ID-anspråket name. För OAuth-leverantörer lagras detta värde i name-anspråket. Copilot Studio extraherar automatiskt detta fält till variabeln, så se till att du har profile som en del av konfigurationen av autentiseringsomfattningen.

UserID-variabel

User.Id-variabeln innehåller användarens ID som lagras i identitetsprovidern. Power Automate-flöden kan använda det här värdet för anropa API:er som tar UserID som ett värde. Värdet i det här fältet hämtas från Microsoft Entra ID-anspråket sub. För OAuth-leverantörer lagras detta värde i sub-anspråket. Copilot Studio extraherar automatiskt fältet till variabeln.

IsLoggedIn-variabel

Variabeln User.IsLoggedIn anger om användaren är inloggad (antingen för att logga in eller redan loggat in, även kalladsökväg för inloggning) eller inte inloggad (vilket skulle resultera i sökvägen till inloggningsfelet).

User.IsLoggedIn är en variabel av boolesk typ som innehåller användarens inloggade status. Du kan använda den här variabeln för att skapa förgreningslogik som söker efter en lyckad inloggning (t.ex. i mallen som redan finns som en del av att noden Autentisering läggs till), eller för att på hämta användarinformation bara om användaren är inloggad.

User.AccessToken-variabel

User.AccessToken-variabeln innehåller användarens token som skapats efter det att användaren har loggat in. Du kan skicka denna variabel till Power Automate-flöden så att de kan ansluta till API:er för serversystem och hämta användarinformation, eller också utföra åtgärder å användarenssökvägnar.

Använd inte User.AccessToken i Meddelande-noder eller för flöden som du inte litar på.

Testa autentiseringsvariabler

Som standard använder fönstret Testrobot kontot för den inloggade användaren för att fylla i User.DisplayName och User.Id variablerna. Men när du testar avsnitt som använder autentisering kanske du vill använda andra värden för dessa variabler (eller till och med ett tomt värde).

Du kan till exempel testa hur specialtecken används eller vad som händer om variabeln är tom.

I följande tabell visas de kommandon som ska fyllas i dessa variabler. Detta gäller endast för rutan Testrobot. Du kan inte använda dem i en publicerad agent som har distribuerats till en kanal.

Skriv in önskat kommandot i fönstret Testrobot på samma sätt som om du normalt chattar med agenten. Om du lyckas får du ett bekräftelsemeddelande från agenten. Om din agent inte använder autentisering får du ett felmeddelande.

Om du återställer fönstret Testrobot (eller utför ändringar i en ämne som gör att Testrobot återställs automatiskt) måste du skicka kommandona igen.