Compartir a través de


Enviar un evento o actividad

Microsoft Copilot Studio proporciona dos nodos que le permiten enviar actividades que no son mensajes: Enviar un evento y Enviar una actividad. Estos tipos de nodo 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 evento está diseñado para enviar actividades de eventos. Las actividades de eventos se envían desde el copiloto y pueden ser interceptadas y utilizadas por el canal, que decide si se utilizan 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 manejar eventos enviados desde el copiloto. Por ejemplo, podría buscar un evento que regrese del copiloto y realizar una acción en la página. El ejemplo 04.api/c.incoming-activity-event en el Repositorio de muestras de chat web en GitHub de Microsoft Bot Framework demuestra cómo podría funcionar la gestión de eventos.
  • Los AudioCodes usan actividades de eventos para permitirle controlar el servicio. Por ejemplo, iniciar o detener la grabación de llamadas. Para información adicional, 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:

  • Mecanografía: Envía una actividad de mecanografía, que el canal puede elegir para recoger y mostrar un indicador de mecanografía en el cliente.
  • Retraso: puede usarse para proporcionar un retraso entre 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: generalmente utilizado para Microsoft Teams. Un usuario crea un tema con un desencadenador de invocación para interceptar una invocación entrante de Teams y usa una actividad de respuesta de invocación para enviar una respuesta adecuada a Teams.
  • Transferencia: permite a un usuario enviar una actividad de transferencia con control explícito sobre el valor. Se utiliza una transferencia para algunos canales externos, como AudioCodes.

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