Configurar variáveis de contexto para bots

Este artigo lista as variáveis de contexto para bots do Azure e do Copilot Studio e mostra como configurá-las no Omnicanal para Customer Service. Para entender como criar variáveis de contexto, consulte Gerenciar variáveis de contexto.

Variáveis de contexto para bots do Azure

A tabela a seguir contém uma lista de variáveis de contexto no Omnicanal para Customer Service que você pode usar para configurar bots do Azure.

Variáveis de contexto para bots do Copilot Studio

A tabela a seguir contém a lista de variáveis ​​de contexto disponíveis no Omnicanal para Customer Service que você pode usar para configurar bots do Copilot Studio.

Configurar variáveis de contexto para um bot do Copilot Studio

Para que o bot do Copilot Studio leia variáveis de contexto pelo Omnicanal, siga estas etapas:

1. Na página Tópicos, selecione Adicionar um tópico e A partir de Um em Branco.

2. Insira um nome para o tópico (por exemplo, "Definir variáveis de contexto") e o salve.

3. Adicione um novo nó ao tópico e selecione Gerenciamento de variáveis > Definir um valor de variável

4. No novo nó, em Definir variável, selecione Criar uma nova variável.

5. Abra o painel Propriedades da variável clicando no novo nome da variável. No painel, defina Nome da variável para corresponder exatamente ao nome da variável de contexto do Omnicanal (diferencia maiúsculas de minúsculas).

6. Na seção Referência, selecione as reticências (...) e Obter valor deste nó se estiver vazio. O bot do Copilot Studio recupera o valor da variável desse nó em runtime.

7. Na seção Uso, selecione Global (qualquer tópico pode acessar) e Fontes externas podem definir valores. O Copilot Studio aceita dados do Omnicanal. Feche o painel Propriedades da variável.

8. No nó, insira um valor em Para valor que corresponda ao tipo de dados esperado pelo bot. Por exemplo, se o bot aguarda uma cadeia de caracteres, defina Text(""). O Copilot Studio fará fallback para o valor definido por você aqui se os dados não chegarem à conversa.

   

9. Salve e publique as alterações.

Durante uma conversa, os dados da variável de contexto do Omnicanal são definidos nas variáveis do Copilot Studio e podem ser usados na lógica do bot.

O bot também pode definir variáveis de contexto do Omnicanal durante uma conversa. Para definir uma variável do Omnicanal pela lógica do Copilot Studio, verifique se o bot está usando o nome da variável correto e defina o valor na propriedade "Para valor" no nó do gerenciamento de variáveis. O Copilot Studio entrega a variável para o Omnicanal durante a transferência para o agente. Isso costuma ser usado para vincular a conversa a um caso quando o bot escala a conversa para um agente. Mais informações sobre como vincular registros no Omnicanal a partir desses dados: Vincular cliente e caso a uma conversa

As variáveis globais que são criadas no Copilot Studio podem ser passadas para o Omnicanal para Customer Service quando uma conversa é escalada. Para ver a lista completa, consulte Variáveis contextuais disponíveis mediante transferência.

Analisar o objeto JSON para extrair a ID do registro

Verifique se você tem os seguintes detalhes:

• A variável de contexto do Omnicanal para Customer Service, como msdyn_contact_msdyn_ocliveworkitem_Customer.
• Os detalhes de esquema

Esta é uma cópia do exemplo de detalhes do esquema:

        Schema: 
        {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "RecordId": {
                        "type": "string"
                    },
                    "PrimaryDisplayValue": {
                        "type": "string"
                    }
                },
                "required": [
                    "RecordId",
                    "PrimaryDisplayValue"
                ]
            }
        }

PrimaryDisplayValue contém o valor do atributo nas entidades do Dataverse. O mapeamento dos atributos da entidade é o seguinte:

• Casos: título do caso
• Contatos: nome completo
• Contas: nome

Aqui está um registro de contexto de amostra.

{
    "msdyn_contact_msdyn_ocliveworkitem_Customer": [
        {
            "RecordId": "<GUID>",
            "PrimaryDisplayValue": "<FullName>"
        }
    ],
    "msdyn_liveworkitemid": "<GUID>"
}

Confira também

Integrar um bot do Copilot Studio
Integrar um bot do Azure
Configurar bots para escalar e encerrar conversas
Referência de SDK do chat ao vivo