Enviar actividades del evento

  • Artículo

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 pueden hacer referencia a Power Virtual Agents mientras actualizamos la documentación y el contenido de capacitación.

Microsoft Copilot Studio proporciona dos nodos que le permiten enviar actividades que no son mensajes: Enviar un evento y Enviar una actividad. Se tratan en las secciones siguientes.

Captura de pantalla de la adición de un nodo Avanzado, incluidas las opciones Enviar un evento y Enviar una actividad.

Enviando eventos

El nodo Enviar un suceso está diseñado específicamente para enviar actividades de eventos. Las actividades de eventos se envían desde el bot y pueden ser interceptadas y utilizadas por el canal, que decide si usar las actividades y cómo. Cuando envía un evento, le da un nombre y luego puede establecer un valor en el evento. Este valor puede tener cualquier formato: un valor literal primitivo, una referencia de variable o una fórmula de Power Fx. El valor se serializa como JSON y se agrega a la actividad saliente.

Captura de pantalla que muestra el menú de configuración para un nodo de actividad de evento.

Los usos de este nodo incluyen:

  • Puede configurar un control de chat web personalizado para gestionar el evento enviado desde el bot. Por ejemplo, podría buscar un evento que regresa del bot y realizar una acción en la página. El ejemplo 04.api/c.incoming-activity-event en el repositorio de ejemplos de Web Chat de Microsoft Bot Framework en GitHub muestra cómo podría funcionar esto.
  • Los AudioCodes usan actividades de eventos para permitirle controlar el servicio. Por ejemplo, iniciar o detener la grabación de llamadas. Para más información, consulte Grabar llamadas.

Envío de otros tipos de actividad

Además de las actividades de eventos, puede enviar actividades de otros tipos utilizando el nodo de actividad de envío. En general, el uso de este nodo es avanzado, por lo que se encuentra en la subcategoría avanzada. Los tipos de actividades que puede enviar son un subconjunto de los que se ofrecen en el Esquema Bot Framework - Clase de tipos de actividad. Al usar este nodo, elige el tipo de actividad y luego, opcionalmente, establece un nombre o valor.

Los tipos comunes son:

  • Escribir : esto enviará una actividad de escritura, que el canal puede elegir para recoger y mostrar un indicador de escritura en el cliente.
  • Retrasar: esto se puede usar para proporcionar un retraso entre los mensajes. Por ejemplo: enviar un mensaje, luego enviar una actividad de retraso, seguida de otro mensaje. Para el usuario final, ven el primer mensaje, seguido de una pausa, luego el segundo mensaje. En este caso, "Valor" se establece en el número de milisegundos de retraso. Para obtener más información, vea el Campo ActivityTypes.Delay.
  • Invocar/Invocar respuesta: por lo general, se utilizan para Microsoft Teams. Un usuario creará un tema con un activador de invocación para interceptar una invocación entrante de Teams. Luego, el C1 usará una actividad de Invocar respuesta para enviar una respuesta adecuada a Teams.
  • Transferir: esto permite que un usuario envíe una actividad de transferencia con control explícito sobre el valor. Esto se usa para algunos canales externos, como AudioCodes.

Captura de pantalla que muestra el nodo Invocar actividad con la lista desplegable Tipo.