Compartir a través de


Configurar variables de contexto para bots

Importante

Las capacidades y características de Power Virtual Agents son ahora parte de Microsoft Copilot Studio tras importantes inversiones en IA generativa e integraciones mejoradas en Microsoft Copilot.

Algunos artículos y capturas de pantalla podrían hacer referencia a Power Virtual Agents, ya que estamos actualizando la documentación y el contenido de la formación.

Este artículo muestra las variables de contexto para bots de Azure y Copilot Studio y cómo puede configurarlas en la Plataforma omnicanal para Customer Service. Para comprender cómo crear variables de contexto, consulte Administrar variables de contexto.

Variables de contexto para bots Azure

La siguiente tabla contiene la lista de variables de contexto en la Plataforma omnicanal para Customer Service que puede usar para configurar bots Azure.

Tipo de variable de contexto Nombre de la variable de contexto Descripción Cómo asignar en Azure
Encuesta previa a la conversación Utilice el tipo de pregunta que creó en la Plataforma omnicanal para Customer Service. Las variables de contexto para las respuestas previas a la conversación almacenan las respuestas del cliente a las preguntas de la encuesta previa a la conversación. Use la siguiente información para asignar la variable de tipo de pregunta en la Plataforma omnicanal para Customer Service con el tipo de variable en Azure:
  • Línea única: cadena
  • Líneas múltiples: cadena
  • Conjunto de opciones: cadena
  • Consentimiento del usuario: booleano
Contexto personalizado Utilice el nombre de la variable que cree en la Plataforma omnicanal para Customer Service o páselo usando la API setContextProvider. Estas son variables de contexto personalizadas que se pueden crear y pasar a través del SDK de chat en vivo. Asignar la respuesta del usuario como JSON para usar una variable de contexto personalizada en la Plataforma omnicanal para Customer Service.
Conversación msdyn_ConversationId Utilice la variable de contexto que contiene el identificador de conversación para la conversación en curso y puede recuperar y realizar operaciones en el registro en Microsoft Dataverse. Cadena: cadena
Contacto msdyn_contact_msdyn_ocliveworkitem_Customer Utilice esta variable de contexto que contiene el ID de registro para el registro del cliente (contacto) que está vinculado a la conversación. Analizar el JSON para extraer identificador del registro
Cuenta msdyn_account_msdyn_ocliveworkitem_Customer Utilice esta variable de contexto que contiene el ID de registro para el registro de cuenta vinculado a la conversación. Analizar el JSON para extraer identificador del registro
Caso msdyn_incident_msdyn_ocliveworkitem Utilice esta variable de contexto que contiene el ID de registro para el registro de caso vinculado a la conversación. Analizar el JSON para extraer identificador del registro

Nota

Use los nombres de variables de contexto tal como se definen y no los cambie al crear flujos en bots de Copilot Studio o Azure. Además, asegúrese de usar la coincidencia exacta para pasar el valor a la variable de contexto porque distingue entre mayúsculas y minúsculas. Si hay una discrepancia, el registro no se identificará automáticamente. Más información: Identificar registros automáticamente

Variables de contexto para bots Copilot Studio

La siguiente tabla contiene la lista de variables de contexto disponibles en Plataforma omnicanal para Customer Service que puede usar para Configurar bots de Copilot Studio.

Importante

Para poder utilizar las variables de mensajería y voz, asegúrese de que primero instala las soluciones de extensión.

Tipo de variable de contexto Nombre de la variable de contexto Descripción Cómo asignar en Copilot Studio
Encuesta previa a la conversación Utilice el tipo de pregunta que creó en la Plataforma omnicanal para Customer Service. Las variables de contexto para las respuestas previas a la conversación almacenan las respuestas del cliente a las preguntas de la encuesta previa a la conversación. Use la siguiente información para asignar la variable de tipo de pregunta en la Plataforma omnicanal para Customer Service con el tipo de variable en Copilot Studio:
  • Línea única: respuesta completa del usuario
  • Líneas múltiples: respuesta completa del usuario
  • Conjunto de opciones: respuesta completa del usuario
  • Consentimiento del usuario: booleano
Contexto personalizado Utilice el nombre de la variable que cree en la Plataforma omnicanal para Customer Service o páselo usando la API setContextProvider. Estas son variables de contexto personalizadas que se pueden crear y pasar a través del SDK de chat en vivo. Use la siguiente información para asignar la variable contexto personalizado en la Plataforma omnicanal para Customer Service con el tipo de variable en Copilot Studio:
  • Cadena: respuesta completa del usuario
  • Booleano: booleano
  • Número, número flotante: número
Conversación msdyn_ConversationId Utilice la variable de contexto que contiene el identificador de conversación para la conversación en curso y puede recuperar y realizar operaciones en el registro en Microsoft Dataverse. Cadena: respuesta completa del usuario.
Variables de mensajería y voz msdyn_CustomerType Utilice esta variable de contexto que contiene el tipo de cliente para el registro de cuenta o contacto que está vinculado a la conversación. Seleccione la variable de solución de extensión de la Plataforma omnicanal para Customer Service.
msdyn_CustomerName Utilice esta variable de contexto que contiene el nombre de cliente para el registro de cuenta o contacto que está vinculado a la conversación. Seleccione la variable de solución de extensión de la Plataforma omnicanal para Customer Service.
msdyn_CustomerId Utilice esta variable de contexto que contiene el id. de cliente para el registro de cuenta o contacto que está vinculado a la conversación. Seleccione la variable de solución de extensión de la Plataforma omnicanal para Customer Service.
msdyn_CaseId Utilice esta variable de contexto que contiene el identificador del caso para el registro de contacto que está vinculado a la conversación. Seleccione la variable de solución de extensión de la Plataforma omnicanal para Customer Service.
msdyn_CaseTitle Utilice esta variable de contexto que contiene el título del caso para el registro de contacto que está vinculado a la conversación. Seleccione la variable de solución de extensión de la Plataforma omnicanal para Customer Service.
Variables de solo voz NúmeroTeléfonoCliente Utilice esta variable de contexto para el número de teléfono del cliente que se proporciona en la actividad de telefonía. Seleccione la variable de solución de extensión de la Plataforma omnicanal para Customer Service.
OrganizationPhoneNumber Utilice esta variable de contexto para el número de teléfono de la organización que se proporciona en la actividad de telefonía. Seleccione la variable de solución de extensión de la Plataforma omnicanal para Customer Service.
Nombre del método de extensión va_SurveyConsent Utilice este cuadro de diálogo para determinar si un cliente ha aceptado participar en encuestas durante la conversación. Utilice este método para escalar los detalles de la conversación a la Plataforma omnicanal para Customer Service.
va_CustomerLocale Utilice este cuadro de diálogo para transferir al usuario que actualmente habla con el bot a otro bot que pueda hablar en un idioma diferente. Establezca el código seleccionando la variable de entrada y utilizando el código local correcto.

Configurar variables de contexto para bots de Copilot Studio

En Copilot Studio, haga lo siguiente:

  1. En la página Temas, seleccione Nuevo tema.

  2. En la pestaña Configuración, introduzca un nombre y una descripción, y guarde el archivo tema.

  3. Seleccione el lienzo Ir a autoría.

  4. Seleccione Agregar nodo, elija la acción Hacer una pregunta.

  5. Edite el campo Identificar y en el cuadro de diálogo Elija información para identificar, seleccione una opción que coincida con el tipo de datos de la variable de contexto. Para obtener información sobre la asignación de tipos de datos, consulte la información en la tabla anterior.

  6. Edite Guardar respuesta como, y en el cuadro de diálogo Propiedades variables, actualice el valor de Nombre con la variable de contexto necesaria de la Plataforma omnicanal para Customer Service. Asegúrese de que Bot (cualquier tema puede acceder) y Las fuentes externas pueden establecer valores están seleccionados. La opción Fuentes externas pueden establecer valores es aplicable solo para obtener la variable de contexto.

    Configurar la variable de contexto en un tema.

  7. Guarde y publique los cambios.

En el tiempo de ejecución, la información requerida se captura en la variable de contexto que luego se puede usar para otras acciones según el flujo de trabajo que configure. El bot puede configurar la información de las variables de contexto para vincular la conversación y el caso cuando el bot escala la conversación a un agente. Más información: Vincular cliente y caso a una conversación

También puede configurar el nodo Transferir a agente en el tema de Copilot Studio para enviar un mensaje privado con variables de contexto relevantes al agente en vivo durante la escalada.

Las variables globales que se crean en Copilot Studio se puede pasar a la Plataforma omnicanal para Customer Service cuando se escala una conversación. Para obtener la lista completa, consulte Variables contextuales disponibles en el momento de la entrega.

Analizar el objeto JSON para extraer el ID de registro

Asegúrese de que tiene los siguientes detalles:

  • La variable de contexto de la Plataforma omnicanal para Customer Service, como msdyn_contact_msdyn_ocliveworkitem_Customer.
  • Los detalles del esquema

Una copia de los detalles del esquema de muestra es la siguiente:

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

PrimaryDisplayValue contendrá el valor del atributo en las entidades Dataverse. La asignación de los atributos de la entidad es el siguiente:

  • Casos: título del caso
  • Contactos: nombre completo
  • Cuentas: nombre

Aquí se muestra un registro de contexto de ejemplo.

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

Consulte también

Integrar un bot de Copilot Studio
Integrar un bot de Azure
Configurar bots para ampliar y terminar las conversaciones
Referencia de las SDK de chat activo