Partilhar via


Iniciar automaticamente uma conversa com o agente

Você pode configurar seu agente para iniciar uma conversa com um usuário. Também pode combinar a saudação personalizada com a personalização ao aspeto do agente.

Importante

Fazer com que o agente inicie a conversa aparece em suas análises e aumenta sua contagem de sessões.

Se o usuário do seu agente não se envolver com o agente (por exemplo, ele carrega a página, mas não pergunta nada ao agente), a sessão é marcada como uma sessão não engajada. Esse comportamento pode afetar suas análises.

Por padrão, os agentes criados com o Copilot Studio e publicados em um site carregam sem uma saudação e aguardam passivamente que o usuário inicie a conversa.

No entanto, pode utilizar código CSS e JavaScript personalizado para fazer com que o agente inicie a conversa automaticamente quando o agente é carregado. Por exemplo, você pode fazer com que seu assistente virtual diga: "Olá, eu sou Botty, um agente virtual" assim que o assistente for inicializado.

Primeiro, você precisa implantar uma tela personalizada que inclua argumentos que acionam a saudação. Por predefinição, a tela personalizada chama o tópico de Saudação predefinido. No entanto, você pode criar um novo tópico para ser usado como saudação. Você desvia o tópico de saudação padrão para este novo tópico.

Importante

Você pode instalar e usar o código de exemplo incluído neste artigo apenas para uso com o Copilot Studio. O código de exemplo é licenciado "no estado em que se encontra" e é excluído de quaisquer contratos de nível de serviço ou serviços de suporte. Você assume o risco de usá-lo.

A Microsoft não dá garantias expressas, garantias ou condições e exclui todas as garantias implícitas, incluindo comercialização, adequação a uma finalidade específica e não violação.

Personalizar a tela padrão

Configure a aparência da tela de bate-papo com algumas opções simples de estilo CSS e JavaScript.

Primeiro, precisa configurar onde está implantando a plataforma do seu bot.

  1. Crie e publique um agente.

  2. Copie o seguinte código HTML e salve-o em um arquivo chamado index.html. Como alternativa, copie e cole o código no editor HTML "tente você mesmo" do 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>
    
  3. Obtenha o ponto final de token para o seu agente.

  4. Em index.html, na linha var theURL = "<YOUR TOKEN ENDPOINT>", substitua o marcador de posição pelo ponto final de token para o seu agente.

  5. Abra index.html usando um navegador moderno (por exemplo, Microsoft Edge) para abrir o agente na tela personalizada.

  6. Teste o agente para garantir que você está recebendo respostas dele e se ele está funcionando corretamente.

    Se encontrar problemas, certifique-se de que publicou o seu agente e que o ponto final de token está no lugar correto. O ponto final de token deve ser depois do sinal de igual (=) na linha var theURL = "<YOUR TOKEN ENDPOINT>" e entre aspas (").

Obter o ponto final de token para o seu agente

Para personalizar a sua tela, seja a tela predefinida ou uma tela personalizada a que se liga, precisa do ponto final de token para o seu agente.

  1. No menu de navegação em Configurações, selecione Canais.

  2. Selecione E-mail. O painel de configuração para este canal é exibido.

  3. Ao lado de Ponto Final de Token, selecione Copiar.

Alterar a saudação padrão do agente

O código no index.html arquivo faz com que um tópico seja chamado automaticamente quando o agente é carregado. Por padrão, o código chama o tópico Saudação . Você também pode criar um novo tópico e desviar o tópico de saudação padrão para esse novo tópico.

Em ambos os casos, você faz alterações no tópico que deseja chamar como faria normalmente.

Se você modificar o tópico Saudação ou criar um novo, deverá indicar que o usuário está falando com um agente (ou "agente virtual"). Essa indicação ajuda o usuário a entender que não está falando com um ser humano.

Recomendamos que modifique o tópico de saudação predefinido para não ter de editar o index.html código.

  1. Vá para a página Tópicos do seu agente e selecione o tópico Saudação .

  2. Edite o texto dentro do nó Mensagem. Você também pode adicionar ou excluir nós.

  3. Selecione Guardar.

  4. Publique o seu agente.

Agora você pode testar seu agente acessando a página da Web onde implantou a tela personalizada do agente. Você pode ver o bot iniciar a conversa mostrando automaticamente o tópico de saudação.

Criar um novo tópico personalizado

Advertência

Usar um tópico personalizado para iniciar uma conversa aumenta suas sessões faturadas. Uma sessão faturada é uma interação entre um cliente e um agente e representa uma unidade de consumo. A sessão faturada começa quando um tópico personalizado é acionado. Para obter mais informações, consulte Gerenciar a capacidade de mensagens.

  1. Vá para a página Tópicos do seu agente.

  2. Selecione Adicionar um tópico>a partir do zero.

  3. Insira um nome para o novo tópico.

  4. Adicione um nó Mensagem e configure-o com a mensagem desejada.

  5. Selecione Salvar quando terminar de editar a mensagem.

  6. Vá para a página Tópicos novamente e selecione o tópico Saudação .

  7. Exclua todos os nós de mensagem do tópico Saudação .

  8. Para desviar automaticamente o agente para o novo tópico, adicione um nó Redirecionamento, com o novo tópico para o destino.

  9. Selecione Salvar e publique seu agente.

Agora você pode testar seu agente acessando a página da Web onde implantou a tela personalizada do agente. Você pode ver o agente iniciar a conversa mostrando automaticamente o novo tópico.