Configurar variáveis de contexto para bots

Este artigo lista as variáveis de contexto para bots de Azure e Copilot Studio e como os pode configurar no Omnicanal para Customer Service. Para compreender como criar variáveis de contexto, consulte Gerir variáveis de contexto.

Variáveis de contexto para bots do Azure

A tabela que se segue contém a lista de variáveis de contexto no Omnicanal para Customer Service que pode utilizar para configurar bots do Azure.

Variáveis de contexto para bots do Copilot Studio

A tabela que se segue contém a lista de variáveis de contexto disponíveis no Omnicanal para Customer Service que pode utilizar para configurar bots do Copilot Studio.

Configurar variáveis de contexto para bot Copilot Studio

Para o seu bot do Copilot Studio ler variáveis de contexto a partir do Omnicanal, efetue os seguintes passos:

1. Na página Tópicos, selecione Adicionar um tópico e a partir de em branco.

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

3. Adicione um novo nó ao tópico e selecione Gestão 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 ao clicar no nome da nova variável. No painel, defina o Nome da variável para corresponder exatamente ao nome da variável de contexto do Omnicanal (é sensível a maiúsculas e minúsculas).

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

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

8. No nó, introduza um valor em Para valor que corresponda ao tipo de dados que o seu bot espera. Por exemplo, se o seu bot espera uma cadeia, defina Text(""). O Copilot Studio reverte para o valor definido aqui se os dados não chegarem à conversa.

   

9. Guardar e publicar 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 utilizados 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 a partir da sua lógica do Copilot Studio, certifique-se de que o seu bot está a utilizar o nome de variável correto e defina o valor na propriedade "Para valor" no seu nó de gestão de variáveis. O Copilot Studio entrega a variável para o Omnicanal durante a transferência para o agente. Isto é frequentemente utilizado para associar a conversa a um caso quando o bot escala a conversa para um agente. Mais informações sobre como associar registos no Omnicanal a partir destes dados: Associar cliente e caso a uma conversa

As variáveis globais criadas no Copilot Studio podem ser passadas para o Omnicanal para Customer Service quando uma conversa é escalada. Para a lista completa, consulte Variáveis contextuais disponíveis após a mudança.

Analisar objeto JSON para extrair o ID do registo

Certifique-se de que tem os seguintes detalhes:

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

Uma cópia dos detalhes do esquema da exemplo é a seguinte:

        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:

• Incidentes: Título do incidente
• Contactos: Nome completo
• Contas: Nome

Eis um registo de contexto de amostra.

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

Consulte também

Integrar um bot do Copilot Studio
Integrar um bot do Azure
Configurar bots para escalar e terminar conversas
Referência SDK do chat em direto