Automatisch een gesprek starten

  • Artikel

Belangrijk

Power Virtual Agents-mogelijkheden en -functies maken nu deel uit van Microsoft Copilot Studio na aanzienlijke investeringen in generatieve AI en verbeterde integraties binnen Microsoft Copilot.

Sommige artikelen en schermopnamen verwijzen mogelijk naar Power Virtual Agents terwijl we de documentatie en trainingsinhoud bijwerken.

U kunt uw copilot configureren om een gesprek met een gebruiker te starten. U kunt de aangepaste begroeting ook combineren met een aanpassing van het uiterlijk van de bot.

Belangrijk

Als u de copilot het gesprek laat starten, ziet u dit in uw analyse en wordt het aantal sessies verhoogd.

Als de gebruiker van uw copilot geen interactie heeft met de copilot (bijvoorbeeld door wel de pagina te laden, maar de copilot niets te vragen), wordt de sessie gemarkeerd als een niet-actieve sessie. Dit kan van invloed zijn op uw analyse.

Standaard worden copilots gemaakt met Microsoft Copilot Studio en gepubliceerd op een website geladen zonder begroeting en wachten deze passief totdat de gebruiker het gesprek begint.

U kunt echter aangepaste CSS- en JavaScript-code gebruiken om de copilot automatisch het gesprek te laten starten wanneer de copilot wordt geladen. U kunt uw copilot bijvoorbeeld 'Hallo, ik ben Copilotty, een virtuele agent' laten zeggen zodra de copilot wordt geladen.

Eerst moet u een aangepast canvas implementeren met argumenten die de begroeting activeren. Standaard roept het aangepaste canvas de onderwerp met de standaardsysteembegroeting aan. U kunt echter een nieuw onderwerp maken die u als begroeting kunt gebruiken. U moet het onderwerp voor de standaardsysteembegroeting omleiden naar een nieuw onderwerp.

Belangrijk

U mag de voorbeeldcode in deze documentatie alleen installeren en gebruiken voor gebruik met het Microsoft Copilot Studio-product. De voorbeeldcode wordt in de huidige staat in licentie gegeven en valt niet onder enige serviceovereenkomst of ondersteuningsservices. U gebruikt deze op eigen risico.

Microsoft geeft geen expliciete garanties of voorwaarden en wijst uitdrukkelijk alle impliciete garanties af, waaronder garanties van verhandelbaarheid, geschiktheid voor een bepaald doel en niet-schending.

Tokeneindpunt ophalen

Als u uw canvas wilt aanpassen, of het nu het standaardcanvas is of een aangepast canvas waarmee u verbinding maakt, moet u uw copilot-gegevens ophalen.

  1. Selecteer in het navigatiemenu onder Instellingen de optie Kanalen.

  2. Selecteer Mobiele app.

    Schermafbeelding van de kanaaltegel van de mobiele app.

  3. Selecteer naast Tokeneindpunt de optie Kopiëren.

    Schermopname van de token-id van het eindpunt.

Het standaardcanvas aanpassen (eenvoudig)

Configureer hoe het chatcanvas eruitziet met enkele eenvoudige CSS- en JavaScript-opmaakopties.

Eerst moet u configureren waar u uw botcanvas implementeert.

  1. Maak en publiceer een bot.

  2. Kopieer en plak de hier weergegeven HTML-code en sla deze op als index.html.
    U kunt de code ook kopiëren en plakken in de HTML-editor voor uitproberen van w3schools.com. U moet nog wel uw tokeneindpunt toevoegen.

    <!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>

  3. In het bestand index.html dat u hebt gemaakt, voert u uw tokeneindpunt in op de regel var theURL = "<YOUR TOKEN ENDPOINT>";.

  4. Open index.html met een moderne browser (bijvoorbeeld Microsoft Edge) om de copilot in het aangepaste canvas te openen.

  5. Test de copilot om er zeker van te zijn dat u reacties van uw copilot ontvangt en dat de copilot correct werkt.

    Als zich problemen voordoen, zorgt u ervoor dat u uw copilot hebt gepubliceerd en dat uw tokeneindpunt op de juiste plaats wordt ingevoegd. Het tokeneindpunt moet na het gelijkteken (=) op de regel var theURL = "<YOUR TOKEN ENDPOINT>" staan, tussen dubbele aanhalingstekens (").

De standaardbegroeting van de copilot wijzigen

De code in het bestand index.html zorgt ervoor dat een onderwerp automatisch wordt aangeroepen wanneer de copilot wordt geladen. Standaard wordt met de code het onderwerp voor de systeembegroeting aangeroepen. U kunt ook een nieuw onderwerp maken en het onderwerp voor de standaardsysteembegroeting omleiden naar dat nieuwe onderwerp.

In beide gevallen wijzigt u het onderwerp dat u op de normale manier kunt aanroepen.

Als u een nieuw begroetingsonderwerp wijzigt of maakt, moet u een soort van indicatie toevoegen dat de gebruiker met een copilot (of "virtuele agent") praat. Door een dergelijke indicatie begrijpen gebruikers beter dat ze niet met een mens praten.

We raden u aan het onderwerp voor de systeembegroeting te wijzigen, zodat u de code index.html niet hoeft te bewerken.

  1. Selecteer Onderwerpen in het navigatiemenu en selecteer vervolgens de onderwerprij Begroeting.

    Schermopname van de pagina Onderwerpen met het onderwerp Begroeting gemarkeerd.

  2. Bewerk de tekst in de knooppunten Bericht. U kunt ook extra knooppunten toevoegen of verwijderen.

  3. Selecteer Opslaan.

  4. Uw copilot publiceren.

U kunt uw copilot nu testen door naar de webpagina te gaan waar u het aangepaste canvas van uw copilot hebt geïmplementeerd. U ziet dat de copilot het gesprek start door automatisch het begroetingsonderwerp te tonen.

Een nieuwe gebruikersonderwerp maken

Waarschuwing

Wanneer u een gebruikersonderwerp gebruikt om een gesprek te beginnen, leidt dit tot een verhoging van het aantal gefactureerde sessies. Een gefactureerde sessie is een interactie tussen een klant en een copilot en vertegenwoordigt één verbruikseenheid. De gefactureerde sessie begint wanneer een gebruikersonderwerp wordt geactiveerd. Zie voor meer informatie het onderwerp Informatie over gefactureerde sessies analyseren.

  1. Selecteer Onderwerpen in het navigatiemenu.

  2. Selecteer Nieuwe onderwerp en geef een naam op.

  3. Voeg de tekst in het knooppunt Bericht toe.

  4. Selecteer Opslaan wanneer u klaar bent met het bewerken van het bericht.

  5. Selecteer Onderwerpen in het navigatiemenu en selecteer vervolgens de onderwerprij Begroeting.

  6. Verwijder de berichtknooppunten in het onderwerp Begroeting.

  7. Als u de copilot automatisch naar een ander onderwerp wilt omleiden, selecteert u Knooppunt toevoegen (+) en vervolgens Ga naar een ander onderwerp.

  8. Selecteer in het flyoutmenu het gebruikersonderwerp dat u hierboven hebt gemaakt.

  9. Selecteer Opslaan wanneer u klaar bent met het bewerken van het bericht.

  10. Uw copilot publiceren.

U kunt uw copilot nu testen door naar de webpagina te gaan waar u het aangepaste canvas van uw copilot hebt geïmplementeerd. U kunt zien dat de copilot het gesprek start door automatisch het nieuwe onderwerp te tonen.