Freigeben über

Eine Copilot-Unterhaltung automatisch starten

  • Artikel

Sie können Ihren Copiloten so konfigurieren, dass er eine Unterhaltung mit Benutzenden beginnt. Sie können die benutzerdefinierte Begrüßung auch mit Das Erscheinungsbild des Copiloten anpassen kombinieren.

Wichtig

Wenn der Copilot die Unterhaltung startet, wird dies in Ihrer Analyse angezeigt und Ihre Sitzungsanzahl wird erhöht.

Wenn der Benutzende nicht auf Ihren Copiloten reagiert (zum Beispiel lädt er die Seite, fragt den Copiloten aber nichts), wird die Sitzung als nicht aktivierte Sitzung markiert. Dies kann sich auf Ihre Analyse auswirken.

Standardmäßig werden mit Microsoft Copilot Studio erstellte und auf einer Website veröffentlichte Copiloten ohne Begrüßung geladen. Sie warten passiv darauf, dass Benutzende eine Unterhaltung beginnen.

Sie können jedoch benutzerdefinierten CSS- und JavaScript-Code verwenden, damit der Copilot die Unterhaltung automatisch startet, wenn er geladen wird. Zum Beispiel könnte Ihr Copilot, sobald er geladen wird, sagen: „Hallo, ich bin Botty, ein virtueller Agent“.

Zunächst müssen Sie einen benutzerdefinierten Canvas bereitstellen, der Argumente enthält, die die Begrüßung auslösen. Standardmäßig ruft der benutzerdefinierte Canvas das Standardsystembegrüßungsthema auf. Sie können jedoch ein neues Thema erstellen, das als Begrüßung verwendet werden soll. Sie müssen das Standardsystembegrüßungsthema auf ein neues Thema umleiten.

Wichtig

Sie dürfen den in dieser Dokumentation enthaltenen Beispielcode nur zur Verwendung mit Microsoft Copilot Studio Produkte verwenden. Der Beispielcode ist „wie besehen“ lizenziert und von Service Level Agreements oder Supportservices ausgeschlossen. Sie tragen das volle Risiko der Verwendung.

Microsoft gibt keine ausdrücklichen Gewährleistungen, Garantien oder Bedingungen und schließt ausdrücklich sämtliche stillschweigenden Gewährleistungen der Handelsüblichkeit, Eignung für einen bestimmten Zweck und Nichtverletzung von Rechten Dritter aus.

Tokenendpunktdetails abrufen

Um Ihren Canvas anzupassen, unabhängig davon, ob es sich um den Standard-Canvas oder einen benutzerdefinierte Canvas handelt, mit dem Sie eine Verbindung herstellen, müssen Sie Ihre Copilot-Details abrufen.

  1. Wählen Sie im Navigationsmenü unter Einstellungen die Option Kanäle.

  2. Wählen Sie mobile App.

    Screenshot der Mobile-App-Kachel.

  3. Wählen Sie neben Token-Endpunkt Kopieren aus.

    Screenshot der Endpunkt-Token-ID.

Anpassen des Standard-Canvas (einfach)

Sie können mit einigen einfachen CSS und JavaScript-Styling-Optionen konfigurieren, wie der Chat-Canvas aussieht.

Zunächst müssen Sie konfigurieren, wo Sie Ihren Bot-Canvas bereitstellen.

  1. Erstellen und veröffentlichen Sie einen Copiloten.

  2. Kopieren Sie den hier angezeigten HTML-Code, fügen Sie ihn ein und speichern Sie ihn unter index.html.
    Sie können den Code auch kopieren und in den w3schools.com-HTML-try it-Editor einfügen. Sie müssen Ihren Token-Endpunkt trotzdem einfügen.

    <!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. Geben Sie in der von Ihnen erstellten Datei index.html Ihren Tokenendpunkt in die Zeile var theURL = "<YOUR TOKEN ENDPOINT>"; ein.

  4. Öffnen Sie index.html mit einem modernen (zum Beispiel Microsoft Edge), um den Copiloten im benutzerdefinierten Canvas zu öffnen.

  5. Testen Sie den Copilot, um sicherzustellen, dass Sie Antworten von Ihrem Copiloten erhalten und dass er ordnungsgemäß funktioniert.

    Wenn Sie auf Probleme stoßen, stellen Sie sicher, dass Sie Ihren Copiloten veröffentlicht haben und Ihr Token-Endpunkt an der richtigen Stelle eingefügt ist. Der Token-Endpunkt sollte nach dem Gleichheitszeichen (=) in der Zeile var theURL = "<YOUR TOKEN ENDPOINT>" stehen und von doppelten Anführungszeichen (") umgeben sein.

Die Standardbegrüßung des Copiloten ändern

Der Code in der Index.html-Datei bewirkt, dass ein Thema automatisch aufgerufen wird, wenn der Copilot geladen wird. Der Code ruft standardmäßig das Systembegrüßungsthema auf. Sie können auch ein neues Thema erstellen und das Standardsystembegrüßungsthema auf dieses neue Thema umleiten.

In beiden Fällen nehmen Sie Änderungen an dem Thema vor, das Sie wie gewohnt aufrufen möchten.

Wenn Sie ein Begrüßungsthema ändern oder ein neues erstellen, sollten Sie einen Hinweis einfügen, der Benutzenden sagt, dass sie mit einem Copiloten (oder „virtuellen Agenten“) sprechen. Ein solcher Hinweis hilft Benutzenden zu erkennen, dass sie nicht mit einem Menschen sprechen

Wir empfehlen, dass Sie das Systembegrüßungsthema so ändern, dass Sie den Index.html-Code nicht bearbeiten müssen.

  1. Wählen Sie Themen im Navigationsmenü aus, und wählen Sie dann die Themenzeile Gruß aus.

    Screenshot der Themenseite mit hervorgehobenem Begrüßungsthema.

  2. Bearbeiten Sie den Text in den Knoten Nachricht. Sie können auch zusätzliche Knoten hinzufügen oder löschen.

  3. Wählen Sie Speichern.

  4. Veröffentlichen Sie Ihren Copilot.

Sie können Ihren Copiloten jetzt testen, indem Sie auf die Webseite gehen, auf der Sie den benutzerdefinierten Canvas Ihres Copiloten bereitgestellt haben. Sie sehen, wie der Bot die Unterhaltung beginnt, indem er automatisch das Begrüßungsthema anzeigt.

Erstellen eines neuen Benutzerthemas

Warnung

Die Verwendung eines Benutzerthemas zum Starten einer Konversation erhöht Ihre in Rechnung gestellte Sitzungen. Eine in Rechnung gestellte Sitzung ist eine Interaktion zwischen einer Kundschaft und einem Copiloten und repräsentiert eine Verbrauchseinheit. Die in Rechnung gestellte Sitzung beginnt, wenn ein Benutzerthema ausgelöst wird. Weitere Informationen finden Sie unter Abgerechnete Sitzungen anzeigen (Vorschauversion).

  1. Wählen Sie im Navigationsmenü Themen.

  2. Wählen Sie Neues Thema aus und benennen Sie es.

  3. Fügen Sie Text im Knoten Nachricht hinzu.

  4. Wählen Sie Speichern aus, wenn Sie mit der Bearbeitung der Nachricht fertig sind.

  5. Wählen Sie Themen im Navigationsmenü aus, und wählen Sie dann die Themenzeile Gruß aus.

  6. Löschen Sie die Nachrichtenknoten im Thema Begrüßung.

  7. Damit der Copilot automatisch zu einem Benutzerthema umgeleitet wird, wählen Sie Knoten hinzufügen (+), um einen Knoten hinzuzufügen, und dann Zu einem anderen Thema wechseln aus.

  8. Wählen Sie im Flyout-Menü das Benutzerthema aus, das Sie oben erstellt haben.

  9. Wählen Sie Speichern aus, wenn Sie mit der Bearbeitung der Nachricht fertig sind.

  10. Veröffentlichen Sie Ihren Copilot.

Sie können Ihren Copiloten jetzt testen, indem Sie auf die Webseite gehen, auf der Sie den benutzerdefinierten Canvas Ihres Copiloten bereitgestellt haben. Sie können sehen, wie der Copilot die Unterhaltung beginnt, indem er automatisch das neue Thema anzeigt.