Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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.
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>
Em
index.html
, na linhavar theURL = "<YOUR TOKEN ENDPOINT>"
, substitua o marcador de posição pelo ponto final de token para o seu agente.Abra
index.html
usando um navegador moderno (por exemplo, Microsoft Edge) para abrir o agente na tela personalizada.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.
No menu de navegação em Configurações, selecione Canais.
Selecione E-mail. O painel de configuração para este canal é exibido.
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.
Modificar o tópico de saudação predefinido (recomendado)
Vá para a página Tópicos do seu agente e selecione o tópico Saudação .
Edite o texto dentro do nó Mensagem. Você também pode adicionar ou excluir nós.
Selecione Guardar.
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.
Vá para a página Tópicos do seu agente.
Selecione Adicionar um tópico>a partir do zero.
Insira um nome para o novo tópico.
Adicione um nó Mensagem e configure-o com a mensagem desejada.
Selecione Salvar quando terminar de editar a mensagem.
Vá para a página Tópicos novamente e selecione o tópico Saudação .
Exclua todos os nós de mensagem do tópico Saudação .
Para desviar automaticamente o agente para o novo tópico, adicione um nó Redirecionamento, com o novo tópico para o destino.
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.