Starta automatiskt en Copilotkonversation
Du kan konfigurera din pilot så att du kan starta en konversation med en användare. Du kan även kombinera den anpassade hälsningsfrasen med anpassningar till copilot-utseende och känsla.
Viktigt
Om copilot startar konversationen kommer den att visas i analysen och det ökar antalet sessioner.
Om användaren av copilot inte interagerar med roboten (t.ex. läser in sidan utan att fråga roboten om något annat), markeras sessionen som en session som inte har aktiverats. Detta kan påverka analysen.
Som standard laddas Copilot som har skapats med Microsoft Copilot Studio och publicerats på en webbplats utan en hälsning och väntar på att användaren ska vänta på att användaren startar konversationen.
Du kan emellertid använda anpassad CSS och JavaScript-kod för att Copilot automatiskt ska starta konversationen när Copilot läses in. Du kan till exempel använda copilot för att säga ”Hej, jag är Botty, en virtuell handläggare” så fort den 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 Microsoft 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 copilot-uppgifter.
I navigeringsmenyn, under Inställningar, väljer du Kanaler.
Välj Mobilapp.
Bredvid tokenslutpunkt, välj kopiera.
Anpassa standarddesignytan (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 copilot i den anpassade arbetsytan.
Testa Copilot för att se till att du får svar från den och att den fungerar som det ska.
Om det uppstår problem kontrollerar du att du har publicerat Copilot och att tokenslutpunkten har infogats på rätt plats. Tokenslutpunkten ska vara efter likhetstecknet (=) på raden
var theURL = "<YOUR TOKEN ENDPOINT>"
och omges av dubbla citattecken (”).
Ändra standardhälsningar för Copilot
Koden i filen index.html gör att ett ämne anropas automatiskt när Copilot 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 ämne ska du ange någon form av indikering på att användaren pratar med en Copilot (eller en ”virtuell handläggare”). 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.
Nu kan du testa Copilot genom att gå till den webbsida där du har distribuerat Copilot 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 Copilot och representerar en förbrukningsenhet. Den fakturerade sessionen börjar när ett användarämne utlöses. Mer information finns i Visa fakturerade sessioner (förhandsversion).
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 vidarebefordra Copilot automatiskt till ett användarämne väljer du Lägg till nod (+) för att lägga till en nod och sedan Gå till et 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.
Nu kan du testa Copilot genom att gå till den webbsida där du har distribuerat Copilot egen arbetsyta. Copilot startar konversationen genom att automatiskt visa det nya ämnet.