Een gebeurtenis of activiteit verzenden
Microsoft Copilot Studio biedt twee knooppunten waarmee u niet-berichtactiviteiten kunt verzenden: Een gebeurtenis verzenden en Een activiteit verzenden. Deze knooppunttypen worden in de volgende gedeelten beschreven.
Gebeurtenissen verzenden
Het knooppunt Een gebeurtenis verzenden is ontworpen voor het verzenden van gebeurtenisactiviteiten. Gebeurtenisactiviteiten worden verzonden van de copilot en kunnen worden onderschept en gebruikt door het kanaal, dat beslist of en hoe de activiteiten worden gebruikt. Wanneer u een gebeurtenis verzendt, geeft u deze een naam en vervolgens kunt u een waarde voor de gebeurtenis instellen. Deze waarde kan elke indeling hebben: een primitieve letterlijke waarde, een variabeleverwijzing of een Power Fx-formule. De waarde wordt geserialiseerd als JSON en toegevoegd aan de uitgaande activiteit.
Dit knooppunt kan onder meer voor het volgende worden gebruikt:
- U kunt een besturingselement voor een aangepaste webchat configureren om gebeurtenissen af te handelen die via de copilot zijn verzonden. U kunt bijvoorbeeld zoeken naar een gebeurtenis die terugkomt van de copilot en een actie ondernemen op de pagina. Het
04.api/c.incoming-activity-event-voorbeeld in de Microsoft Bot Framework-opslagplaats voor Webchat-voorbeelden op GitHub laat zien hoe gebeurtenisafhandeling kan werken. - Audiocodes gebruiken gebeurtenisactiviteiten om u de service te laten beheren. Denk bijvoorbeeld aan het starten of stoppen van gespreksopnamen. Zie Gesprekken opnemen voor meer informatie.
Andere soorten activiteiten verzenden
Naast gebeurtenisactiviteiten kunt u activiteiten van andere typen verzenden met het knooppunt voor het verzenden van activiteiten. Over het algemeen is het gebruik van dit knooppunt geavanceerd, vandaar dat het zich in de subcategorie Geavanceerd bevindt. De typen activiteiten die u kunt verzenden, zijn een subset van de activiteiten die worden aangeboden in het Bot Framework-schema - klasse ActivityTypes. Wanneer u dit knooppunt gebruikt, kiest u het type activiteit en stelt u vervolgens desgewenst een naam of waarde in.
Veelvoorkomende typen:
- Typen: hiermee wordt een typeactiviteit verzonden die het kanaal kan kiezen om een type-indicator op de client op te halen en weer te geven.
- Vertraging: kan worden gebruikt om een vertraging tussen berichten op te geven. Voorbeeld: een bericht sturen en vervolgens een vertragingsactiviteit verzenden, gevolgd door nog een bericht. De eindgebruiker ziet het eerste bericht, gevolgd door een pauze en vervolgens het tweede bericht. In dit geval wordt "Waarde" ingesteld op het aantal milliseconden aan vertraging. Zie voor details het veld ActivityTypes.Delay.
- Aanroepen/Respons aanroepen: in het algemeen gebruikt voor Microsoft Teams. Een gebruiker maakt een onderwerp met een Aanroepen-trigger om een inkomende aanroep van Teams te onderscheppen, en gebruikt een Response aanroepen-activiteit om een passende respons terug te sturen naar Teams.
- Overdracht: hiermee kan een gebruiker een Overdracht-activiteit verzenden met expliciete controle over de waarde. Voor sommige externe kanalen, zoals AudioCodes, wordt een overdracht gebruikt.
