Inviare un evento o un'attività
Microsoft Copilot Studio fornisce due nodi che consentono di inviare attività diverse dai messaggi: Invia un evento e Invia un'attività. Queste tipi di nodo vengono trattati nelle sezioni che seguono.
Invio di eventi
Il nodo Invia un Evento è progettato per l'invio di attività Evento. Le attività Evento vengono inviate dal copilota e possono essere intercettate e utilizzate dal canale, che decide se e come utilizzare le attività. Quando invii un evento, gli dai un nome e poi puoi impostare un valore sull'evento. Questo valore può avere qualsiasi formato: un valore letterale primitivo, un riferimento a una variabile o una formula Power Fx. Il valore viene serializzato come JSON e aggiunto all'attività in uscita.
Gli usi di questo nodo includono:
- È possibile configurare un controllo chat Web personalizzato per gestire gli eventi inviati dal copilota. Ad esempio, potresti cercare un evento proveniente dal copilota ed eseguire un'azione sulla pagina. Il
04.api/c.incoming-activity-eventcampione nel Repository di campioni chat Web di Microsoft Bot Framework su GitHub dimostra come potrebbe funzionare la gestione degli eventi. - Gli AudioCodes utilizzano le attività degli eventi per consentirti di controllare il servizio. Ad esempio, avviare o interrompere la registrazione delle chiamate. Per ulteriori informazioni, vedi Registrare le chiamate.
Invio di altri tipi di attività
Oltre alle attività evento, puoi inviare attività di altro tipo utilizzando il nodo Invia attività. Generalmente, l'utilizzo di questo nodo è avanzato, quindi si trova nella sottocategoria Avanzate. I tipi di attività che puoi inviare sono un sottoinsieme di quelli offerti nello Bot Framework Schema - Classe ActivityTypes. Quando si utilizza questo nodo, si sceglie il tipo di attività e quindi si imposta facoltativamente un nome o un valore.
I tipi comuni sono:
- Digitazione: invia un'attività di digitazione, che il canale può scegliere di raccogliere per mostrare un indicatore di digitazione sul client.
- Ritardo: può essere utilizzato per fornire un ritardo tra i messaggi. Ad esempio: invio di un messaggio, quindi invio di un'attività di ritardo, seguita da un altro messaggio. Per l'utente finale, viene visualizzato il primo messaggio, seguito da una pausa, quindi dal secondo messaggio. In questo caso il "Valore" è impostato sul numero di millisecondi di ritardo. Per i dettagli, vedi Campo ActivityTypes.Delay.
- Richiama/Richiama risposta: generalmente utilizzato per Microsoft Teams. Un utente crea un argomento con un trigger di richiamo per intercettare una chiamata in arrivo da Teams e utilizzare un'attività di risposta alla chiamata per inviare una risposta appropriata a Teams.
- Passaggio: consente a un utente di inviare un'attività di Passaggio con controllo esplicito sul valore. Un passaggio viene utilizzato per alcuni canali esterni, come gli AudioCodes.
