Automatisches Starten einer Agent-Unterhaltung

Artikel
03/19/2025

Sie können Ihren Agent so konfigurieren, dass er eine Unterhaltung mit einem Benutzer beginnt. Sie können die benutzerdefinierte Begrüßung auch mit Anpassung an das Erscheinungsbild des Agents kombinieren.

Wichtig

Wenn der Agent das Gespräch startet, wird dies in Ihrer Analyse angezeigt und erhöht Ihre Sitzungsanzahl.

Wenn der Benutzer Ihres Agents nicht mit dem Agent in Kontakt tritt (zum Beispiel lädt er die Seite, fragt den Agent aber nichts), wird die Sitzung als nicht aktivierte Sitzung markiert. Dies kann sich auf Ihre Analyse auswirken.

Web-App
Teams

Standardmäßig werden mit Copilot Studio erstellte und auf einer Website veröffentlichte Agents ohne Begrüßung geladen, die passiv darauf warten, dass der Benutzer die Konversation startet.

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

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 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 Agent-Details abrufen.

Wählen Sie im Navigationsmenü unter Einstellungen die Option Kanäle.
Wählen Sie mobile App.
Wählen Sie neben Token-EndpunktKopieren aus.

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.

Einen Agent erstellen und veröffentlichen.

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>

Geben Sie in der von Ihnen erstellten Datei index.html Ihren Tokenendpunkt in die Zeile var theURL = "<YOUR TOKEN ENDPOINT>"; ein.
Öffnen Sie index.html mit einem modernen Browser (zum Beispiel Microsoft Edge), um den Agent im benutzerdefinierten Canvas zu öffnen.
Testen Sie den Agent, um sicherzustellen, dass Sie Antworten von Ihrem Agent erhalten und dass er ordnungsgemäß funktioniert.

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

Ändern der Standardbegrüßung des Agents

Der Code in der Index.html-Datei bewirkt, dass ein Thema automatisch aufgerufen wird, wenn der Agent 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 darauf einfügen, dass der Benutzer mit einem Agenten (oder „virtuellen Agenten”) spricht. 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.

Ändern des Systembegrüßungsthemas (empfohlen)

Wählen Sie Themen im Navigationsmenü aus, und wählen Sie dann die Themenzeile Gruß aus.
Bearbeiten Sie den Text in den Knoten Nachricht. Sie können auch zusätzliche Knoten hinzufügen oder löschen.
Wählen Sie Speichern.
Veröffentlichen Sie Ihren Agent.

Sie können Ihren Agent jetzt testen, indem Sie auf die Webseite gehen, auf der Sie den benutzerdefinierten Canvas Ihres Agents 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 einem Kunden und einem Agent und repräsentiert eine Verbrauchseinheit. Die in Rechnung gestellte Sitzung beginnt, wenn ein Benutzerthema ausgelöst wird. Weitere Informationen finden Sie unter Nachrichtenkapazität verwalten.

Wählen Sie im Navigationsmenü Themen.
Wählen Sie Neues Thema aus und benennen Sie es.
Fügen Sie Text im Knoten Nachricht hinzu.
Wählen Sie Speichern aus, wenn Sie mit der Bearbeitung der Nachricht fertig sind.
Wählen Sie Themen im Navigationsmenü aus, und wählen Sie dann die Themenzeile Gruß aus.
Löschen Sie die Nachrichtenknoten im Thema Begrüßung.
Damit der Agent 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.
Wählen Sie im Flyout-Menü das Benutzerthema aus, das Sie oben erstellt haben.
Wählen Sie Speichern aus, wenn Sie mit der Bearbeitung der Nachricht fertig sind.
Veröffentlichen Sie Ihren Agent.

Sie können Ihren Agent jetzt testen, indem Sie auf die Webseite gehen, auf der Sie den benutzerdefinierten Canvas Ihres Agents bereitgestellt haben. Sie sehen, wie der Agent die Konversation startet, indem er automatisch das neue Thema anzeigt.

Teilen über

Automatisches Starten einer Agent-Unterhaltung

Tokenendpunktdetails abrufen

Anpassen des Standard-Canvas (einfach)

Ändern der Standardbegrüßung des Agents

Ändern des Systembegrüßungsthemas (empfohlen)

Erstellen eines neuen Benutzerthemas

Ändern der Standardbegrüßung des Agents

Feedback

Zusätzliche Ressourcen