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:
|
| 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:
|
| 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:
|
| 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:
En la página Temas, seleccione Nuevo tema.
En la pestaña Configuración, introduzca un nombre y una descripción, y guarde el archivo tema.
Seleccione el lienzo Ir a autoría.
Seleccione Agregar nodo, elija la acción Hacer una pregunta.
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.
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.
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
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de