Avviare automaticamente una conversazione dell'agente

2025-06-23

È possibile configurare l'agente per avviare una conversazione con un utente. Puoi anche combinare il saluto personalizzato con la personalizzazione dell'aspetto dell'agente.

Importante

L'agente che avvia la conversazione appare nelle tue analisi e aumenta il conteggio delle sessioni.

Se l'utente dell'agente non interagisce con l'agente (ad esempio, carica la pagina ma non chiede nulla all'agente), la sessione è contrassegnata come non impegnata. Questo comportamento potrebbe influire sull'analisi.

Applicazione Web
Teams

Per impostazione predefinita, gli agenti creati con Copilot Studio e pubblicati su un sito Web vengono caricati senza un saluto e attendono passivamente che l'utente inizi la conversazione.

Tuttavia, puoi utilizzare il codice personalizzato CSS e JavaScript per fare in modo che l'agente avvii automaticamente la conversazione quando viene caricato. Ad esempio, potresti chiedere al tuo agente di dire "Ciao, sono Betty un agente virtuale" non appena viene caricato.

Innanzitutto, è necessario distribuire un canvas personalizzato che includa argomenti che attivano il saluto. Per impostazione predefinita, il canvas personalizzato chiama l'argomento predefinito di Saluto. Puoi, tuttavia, creare un nuovo argomento da utilizzare come saluto. Dirottate l'argomento Saluti predefinito su questo nuovo argomento.

Importante

È possibile installare e usare il codice di esempio incluso in questo articolo solo per l'uso con Copilot Studio. Il codice di esempio è concesso in licenza "così com'è" ed è escluso da qualsiasi accordo sul livello di servizio o servizi di supporto. L'utente si assume tutti i rischi derivanti dal suo utilizzo.

Microsoft non riconosce garanzie o condizioni espresse ed esclude le garanzie implicite di commerciabilità, idoneità a uno scopo specifico e non violazione.

Personalizzare l'area di disegno predefinita

Configura l'aspetto della canvas di chat con alcuni semplici opzioni di stile CSS e JavaScript.

Innanzitutto, devi configurare dove stai distribuendo il canvas del bot.

Creare e pubblicare un agente.

Copiare il codice HTML seguente e salvarlo in un file denominato index.html. In alternativa, copia e incolla il codice nell'editor di prova HTML di w3schools.com.

<!DOCTYPE html>
<html>
<head>
    <title>Contoso Sample Web Chat</title> 
    <!-- This styling is for Web Chat demonstration purposes. For larger projects, we recommend you move style to a separate file -->
    <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 the token endpoint for your agent below
        var theURL = "<YOUR 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>

Recupera l'endpoint del token per il tuo agente.
In index.html, alla riga var theURL = "<YOUR TOKEN ENDPOINT>", sostituisci il segnaposto con l'endpoint del token per il tuo agente.
Aprire index.html usando un browser moderno (ad esempio, Microsoft Edge) per aprire l'agente nell'area di disegno personalizzata.
Testare l'agente per assicurarsi di ricevere risposte da esso e che funzioni correttamente.

In caso di problemi, assicurarsi di aver pubblicato l'agente e che l'endpoint del token si trovi nella posizione corretta. L'endpoint del token deve essere inserito dopo il segno di uguale (=) sulla riga var theURL = "<YOUR TOKEN ENDPOINT>" e racchiuso tra virgolette doppie (").

Recuperare l'endpoint del token per l'agente

Per personalizzare il canvas, predefinito o personalizzato al quale ti connetti, hai bisogno dell'endpoint del token per il tuo agente.

Nel menu di navigazione, in Impostazioni seleziona Canali.
Seleziona E-mail. Viene visualizzato il pannello di configurazione per questo canale.
Accanto a Endpoint token, seleziona Copia.

Modifica il saluto predefinito dell'agente

Il codice nel index.html file determina la chiamata automatica di un argomento quando viene caricato l'agente. Per impostazione predefinita, il codice chiama l'argomento Greeting . È anche possibile creare un nuovo argomento e deviare l'argomento di saluto predefinito a tale nuovo argomento.

In entrambi i casi, apporta le modifiche all'argomento che desideri chiamare come faresti normalmente.

Se si modifica l'argomento Greeting o ne viene creato uno nuovo, è necessario indicare che l'utente sta parlando con un agente (o "agente virtuale"). Un'indicazione di questo tipo aiuta l'utente a capire che non parla con un essere umano.

È consigliabile modificare l'argomento Greeting predefinito in modo che non sia necessario modificare il index.html codice.

Modificare l'argomento di saluto predefinito (scelta consigliata)

Passare alla pagina Argomenti per l'agente e selezionare l'argomento Greeting (Saluto ).
Modificare il testo all'interno del nodo Messaggio . È anche possibile aggiungere o eliminare nodi.
Selezionare Salva.
Pubblicare l'agente.

Ora puoi testare il tuo agente accedendo alla pagina Web in cui hai distribuito il canvas personalizzato dell'agente. Lo vedrai iniziare la conversazione mostrando automaticamente l'argomento di saluto.

Creare un nuovo argomento personalizzato

Avviso

L'uso di un argomento personalizzato per avviare una conversazione aumenta le sessioni fatturate. Una sessione fatturata è un'interazione tra un cliente e un agente e rappresenta un'unità di consumo. La sessione fatturata inizia quando viene attivato un argomento personalizzato. Per ulteriori informazioni, vedi Gestisci la capacità dei messaggi.

Vai alla pagina Argomenti dell'agente.
Selezionare Aggiungi un argomento>Da vuoto.
Immettere un nome per il nuovo argomento.
Aggiungere un nodo Messaggio e configurarlo con il messaggio desiderato.
Selezionare Salva al termine della modifica del messaggio.
Passare di nuovo alla pagina Argomenti e selezionare l'argomento Saluto .
Eliminare tutti i nodi del messaggio dall'argomento Greeting .
Per deviare automaticamente l'agente al nuovo argomento, aggiungi un nodo Reindirizzamento con il nuovo argomento per la destinazione.
Selezionare Salva e pubblicare l'agente.

Ora puoi testare il tuo agente accedendo alla pagina Web in cui hai distribuito il canvas personalizzato dell'agente. Vedrai l'agente iniziare la conversazione mostrando automaticamente il nuovo argomento.