Enviar um evento ou atividade
O Microsoft Copilot Studio fornece dois nós que permitem enviar atividades sem mensagem: Enviar um Evento e Enviar uma Atividade. Esses tipos de nós são discutidos nas seções a seguir.
Enviando eventos
O nó Enviar um Evento foi projetado para enviar atividades de Evento. As atividades do evento são enviadas do copiloto e podem ser interceptadas e usadas pelo canal, que decide se vai usar as atividades e como vai usá-las. Ao enviar um evento, você dá um nome a ele e, em seguida, poderá definir um valor para ele. Esse valor pode estar em qualquer formato: um valor literal primitivo, uma referência de variável ou uma fórmula do Power Fx. O valor será serializado como JSON e adicionado à atividade de saída.
Os usos desse nó incluem:
- Você pode configurar um controle personalizado de chat na Web para lidar com eventos enviados do copiloto. Por exemplo, você pode procurar um evento voltando do copiloto e executar uma ação na página. O
04.api/c.incoming-activity-eventexemplo no repositório de exemplos de Web Chat no GitHub do Microsoft Bot Framework demonstra como a manipulação de eventos pode funcionar. - AudioCodes usa atividades do evento para permitir que você controle o serviço. Por exemplo, iniciar ou interromper a gravação de chamadas. Para obter informações adicionais, consulte Gravação de chamadas.
Enviando outros tipos de atividade
Além das atividades do evento, você pode enviar atividades de outros tipos usando o nó Enviar atividade. Geralmente, o uso desse nó é avançado, portanto, está na subcategoria avançada. Os tipos de atividades que podem ser enviados são um subconjunto daqueles oferecidos no Esquema do Bot Framework – Classes de tipos de atividade. Ao usar esse nó, você escolhe o tipo de atividade e, opcionalmente, define um nome ou valor.
Os tipos comuns são:
- Digitação - Envia uma atividade de digitação, que o canal pode escolher para selecionar e mostrar um indicador de digitação no cliente.
- Atraso - Pode ser usado para fornecer um atraso entre as mensagens. Por exemplo: enviar uma mensagem, depois enviar uma atividade de atraso, seguida de outra mensagem. Para o usuário final, ele vê a primeira mensagem, seguida de uma pausa e, em seguida, a segunda mensagem. Nesse caso, "Valor" é definido como o número de milissegundos de atraso. Para obter detalhes, consulte Campo ActivityTypes.Delay.
- Invocar/Invocar Resposta – Geralmente usado para o Microsoft Teams. Um usuário cria um tópico com um gatilho Invocar para interceptar uma Invocação recebida do Teams e usar uma atividade Invocar Resposta para enviar uma resposta apropriada de volta ao Teams.
- Entrega – permite que um usuário envie uma atividade de Entrega com controle explícito sobre o valor. Um handoff é usado para alguns canais externos, como AudioCodes.
