Partilhar via


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.

Captura de tela da adição de um nó Avançado, incluindo as opções Enviar um evento e Enviar uma atividade.

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.

Captura de tela mostrando o menu de configurações para um nó Atividade do evento.

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-event exemplo 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.

Captura de tela mostrando o nó de atividade Invocar com a lista suspensa Tipo.