Starta en agent konversation automatiskt
Du kan konfigurera din agent till att starta en konversation med en användare. Du kan även kombinera den anpassade hälsningsfrasen med anpassningar till agentens utseende och känsla.
Viktigt
Om agenten startar konversationen visas den i analysen, vilket ökar antalet sessioner.
Om användaren av agenten inte interagerar med agenten (t.ex. läser in sidan, men utan att fråga agenten om något), markeras sessionen som en session som inte har aktiverats. Detta kan påverka analysen.
Som standard laddas agenter som har skapats med Copilot Studio och publicerats på en webbplats utan en hälsning och väntar passivt på att användaren ska starta konversationen.
Du kan emellertid använda anpassad CSS- och JavaScript-kod för att låta agenten starta konversationen automatiskt när agenten läses in. Du kan till exempel använda din agent för att säga: ”Hej, jag heter Botty och är en virtuell handläggare” så fort agenten läses in.
Först måste du distribuera en anpassad arbetsyta som innehåller argument som utlöser hälsningen. Som standard anropar den anpassade arbetsytan standardhälsningsämne för system. Du kan emellertid skapa en ny ämne ska användas som hälsning. Du måste också ändra standardhälsningsämnet för system till det nya ämnet.
Viktigt!
Du kan installera och använda exempelkoden som finns i den här dokumentationen endast för användning med Copilot Studio-produkten. Exempelkoden är licensierad och ingår inte i några servicenivåavtal eller supporttjänster. Användande sker på egen risk.
Microsoft lämnar inga uttryckliga garantier, eller villkor och exkluderar alla underförstådda garantier, inklusive säljbarhet, lämplighet för ett särskilt ändamål och ansvarsfrihet mot inskränkning av immaterielrätt.
Hämta tokenslutpunkt
Om du vill anpassa arbetsytan, oavsett om det är standardarbetsytan eller en som du ansluter till, måste du hämta dina agentuppgifter.
I navigeringsmenyn, under Inställningar, väljer du Kanaler.
Välj Mobilapp.
Bredvid tokenslutpunkt, välj kopiera.
Anpassa standarddesignarbetsytan (enkel)
Konfigurera hur chattarbetsytan ska se ut med några enkla CSS och JavaScript-alternativ.
Först måste du konfigurera vart du distribuerar din robotarbetsyta.
Kopiera och klistra in HTML-koden som visas här och spara den som index.html.
Du kan också kopiera och klistra in koden i w3schools.com HTML prova den i redigeraren. Du måste fortfarande lägga till din tokenslutpunkt.<!DOCTYPE html> <html> <head> <title>Contoso Sample Web Chat</title> <!-- This styling is for the Web Chat demonstration purposes. It is recommended that style is moved to a separate file for organization in larger projects --> <style> html, body { height: 100%; } body { margin: 0; } h1 { font-size: 16px; font-family: Segoe UI; line-height: 20px; color: whitesmoke; display: table-cell; padding: 13px 0px 0px 20px; } #heading { background-color: black; height: 50px; } .main { margin: 18px; border-radius: 4px; } div[role="form"]{ background-color: black; } #webchat { position: fixed; height: calc(100% - 50px); width: 100%; top: 50px; overflow: hidden; } </style> </head> <body> <div> <div id="heading"> <!-- Change the h1 text to change the bot name --> <h1>Contoso Bot Name</h1> </div> <div id="webchat" role="main"></div> </div> <script src="https://cdn.botframework.com/botframework-webchat/latest/webchat.js"></script> <script> const styleOptions = { // Add styleOptions to customize Web Chat canvas hideUploadButton: true }; // Add your BOT token endpoint below var theURL = "<BOT TOKEN ENDPOINT>"; var environmentEndPoint = theURL.slice(0,theURL.indexOf('/powervirtualagents')); var apiVersion = theURL.slice(theURL.indexOf('api-version')).split('=')[1]; var regionalChannelSettingsURL = `${environmentEndPoint}/powervirtualagents/regionalchannelsettings?api-version=${apiVersion}`; var directline; fetch(regionalChannelSettingsURL) .then((response) => { return response.json(); }) .then((data) => { directline = data.channelUrlsById.directline; }) .catch(err => console.error("An error occurred: " + err)); fetch(theURL) .then(response => response.json()) .then(conversationInfo => { window.WebChat.renderWebChat( { directLine: window.WebChat.createDirectLine({ domain: `${directline}v3/directline`, token: conversationInfo.token, }), styleOptions }, document.getElementById('webchat') ); }) .catch(err => console.error("An error occurred: " + err)); </script> </body> </html>I filen index.html du skapade, ange tokenslutpunkt på raden
var theURL = "<YOUR TOKEN ENDPOINT>";.Öppna index.html med en modern webbläsare (t.ex. Microsoft Edge) för att öppna agenten i den anpassade arbetsytan.
Testa agenten för att se till att du får svar från din agent och att agenten fungerar som den ska.
Om det uppstår problem kontrollerar du att du har publicerat agenten och att din tokenslutpunkt infogas på rätt plats. Tokenslutpunkten ska vara efter likhetstecknet (=) på raden
var theURL = "<YOUR TOKEN ENDPOINT>"och omges av dubbla citattecken (”).
Ändra standardhälsning för agent
Koden i filen index.html gör att ett ämne anropas automatiskt när agenten läses in. Som standard anropar koden systemhälsningsämnet. Du kan också skapa en ny ämne och avsätta standardhälsningsämne för system till det nya ämnet.
I båda fallen gör du ändringar i den ämne du vill ringa som vanligt.
Om du ändrar eller skapar ett nytt hälsningsämne bör du inkludera någon form av indikation på att användaren pratar med en agent (eller ”virtuell agent”). En sådan indikering hjälper användaren att förstå att de inte pratar med någon annan.
Vi rekommenderar att du ändrar systemets hälsningsämne så att du inte behöver redigera index.html-kod.
Ändra systemets hälsningsämne (rekommenderas)
Markera avsnitt i navigeringsmeny och markera raden Hälsning ämne.
Redigera texten i de noder som är meddelande. Du kan även lägga till eller ta bort ytterligare noder.
Välj Spara.
Du kan nu testa agenten genom att gå till den webbsida där du har distribuerat agenten egen arbetsyta. Du lär dig att använda roboten för att starta konversationen genom att automatiskt visa hälsningsämne.
Skapa ett nytt användarämne
Varning
Om du använder en användarämne för att starta en konversation görs en ökning av dina fakturerade sessioner. En fakturerad session är en interaktion mellan en kund och en agent, och representerar en förbrukningsenhet. Den fakturerade sessionen börjar när ett användarämne utlöses. Mer information finns i Hantera meddelandekapacitet.
I navigeringsmeny väljer du Ämnen.
Välj nytt ämne och ge den ett namn.
Lägg till texten i de noder som är meddelande.
Välj Spara när du är klar med att redigera meddelandet.
Markera avsnitt i navigeringsmeny och markera raden Hälsning ämne.
Ta bort de meddelandenoder som visas i ämnet hälsning.
Om du vill avleda agenten till ett användarämne automatiskt väljer du Lägg till nod (+) för att lägga till en nod, och sedan Gå till ett annat ämne.
Markera det användarämne du skapat ovan på den utfällbara menyn.
Välj Spara när du är klar med att redigera meddelandet.
Du kan nu testa agenten genom att gå till den webbsida där du har distribuerat agenten egen arbetsyta. Du kan se agenten starta konversationen genom att automatiskt visa det nya ämnet.
