Passar variáveis de contexto de uma página da Web para um agente

Quando o agente é implantado em um site personalizado, convém passar variáveis de contexto de uma página da Web para o agente e usar essas variáveis para aprimorar a experiência do usuário. As variáveis de contexto permitem que seu agente forneça interações personalizadas e mais significativas com os visitantes do seu site.

Quando passar variáveis de contexto

Aqui estão exemplos de situações em que pode ser útil passar o contexto para um agente:

  • Transfira um ID de rastreamento de análise da Web de uma página da Web para um agente para avaliar métricas da Web e do agente em conjunto.

  • Passe um ID de pedido de uma página da Web para o agente para que o cliente não precise digitar o ID do pedido para o agente novamente. O agente pode simplesmente obter as informações do identificador do pedido da página da Web.

  • Passe a página atual do site para que o agente possa personalizar sua experiência de acordo com a página que o cliente está visitando.

  • Passe o idioma da página da Web para que o agente possa personalizar sua experiência de acordo com o idioma da página.

Passar variáveis de contexto é um procedimento de duas etapas: primeiro passe o contexto da sua página da Web para o agente e, em seguida, salve o contexto no agente como uma variável.

Passar o contexto da sua página da Web para o agente

No seu código JavaScript, onde você chama o agente, inclua os valores a serem enviados como contexto. Você pode passar qualquer informação do seu site para o seu agente. Por exemplo, o trecho de código a seguir envia três variáveis de contexto: Language, currentURLe OrderId.

{
Language: siteLanguage,
currentURL: window.location.href,
OrderId: '12345'
}

Saiba mais em Adicionar variáveis globais a uma tela personalizada. Para um bloco de código de exemplo para um canvas totalmente personalizado em HTML/JavaScript com Webchat.js, consulte Personalizar a aparência e interação de um agente.

Salvar contexto como uma variável no agente

No tópico do sistema Início da Conversa, adicione um nó de Pergunta. Para configurar corretamente o tópico, proceda da seguinte forma:

  1. Deixe a pergunta em branco. Você só usa o nó Pergunta como um veículo para obter contexto de uma fonte externa.

  2. Para Identificar, substitua as opções padrão de múltipla escolha pela resposta inteira do usuário ou pelo tipo de dados apropriado.

  3. Selecione o nome da variável padrão e, no painel Propriedades da variável , substitua-o por um nome representativo.

  4. Selecione Global (qualquer tópico pode acessar).

  5. Selecione Fontes externas podem definir valores.

    Captura de ecrã do painel 'Propriedades da variável' mostrando a configuração de uma variável global no Copilot Studio.

  6. Opcionalmente, defina o valor de tempo limite desejado para permitir que a variável receba seu valor da fonte externa.

Observação

Embora este exemplo use o tópico do sistema Iniciar Conversa , você pode salvar o contexto recebido de uma página da Web em qualquer tópico. Uma boa prática é dedicar um único tópico onde você configura variáveis globais para armazenar informações que você espera de fontes externas. Saiba mais em Definir variáveis globais de origens externas.

Seu agente pode usar essas variáveis para qualquer finalidade, por exemplo, para obter detalhes do pedido para o ID do pedido ou para personalizar o comportamento do bate-papo para o idioma. Para um exemplo de como usar este conceito para combinar as análises web e de agentes, consulte Combinar análises web e de agentes.

  • Last updated on