ActivityHandler Classe

Gère les activités et doit être sous-classé.

Constructeur

ActivityHandler()

Remarques

Dérivez de cette classe pour gérer des types d’activité particuliers. Yon peut ajouter des activités avant et post-traitement en appelant la classe de base dans la classe dérivée.

Méthodes

on_adaptive_card_invoke	Appelé lorsque le bot reçoit une action de carte adaptative s’exécute. Lorsque la méthode on_invoke_activity reçoit un invoke avec un Activity.name de adaptiveCard/action, elle appelle cette méthode.
on_conversation_update_activity	Appelé lorsqu’une activité de mise à jour de conversation est reçue du canal lorsque le comportement de base de on_turn est utilisé.
on_end_of_conversation_activity	Appelé lorsqu’une activité de fin de conversation est reçue du canal.
on_event	Appelé lorsqu’un événement autre que jetons/réponse est reçu lorsque le comportement de base de on_event_activity est utilisé.
on_event_activity	Appelé lorsqu’une activité d’événement est reçue du connecteur lorsque le comportement de base de on_turn est utilisé.
on_installation_update	Remplacez cela dans une classe dérivée pour fournir une logique spécifique aux activités ActivityTypes.InstallationUpdate.
on_installation_update_add	Remplacez cela dans une classe dérivée pour fournir une logique spécifique aux activités ActivityTypes.InstallationUpdate avec « action » définie sur « add ».
on_installation_update_remove	Remplacez cela dans une classe dérivée pour fournir une logique spécifique aux activités ActivityTypes.InstallationUpdate avec « action » définie sur « remove ».
on_invoke_activity	Inscrit un gestionnaire d’événements d’activité pour l'appeler événement, émis pour chaque activité d’événement entrante.
on_members_added_activity	Remplacez cette méthode dans une classe dérivée pour fournir une logique lorsque les membres autres que le bot rejoignent la conversation. Vous pouvez ajouter la logique de bienvenue de votre bot. activité de mise à jour de conversation :type members_added : List :p aram turn_context : objet de contexte pour ce tour :type turn_context : TurnContext
on_members_removed_activity	Remplacez cette méthode dans une classe dérivée pour fournir une logique lorsque les membres autres que le bot quittent la conversation. Vous pouvez ajouter la logique d’octet de votre bot. activité de mise à jour de conversation :type members_added : List :p aram turn_context : objet de contexte pour ce tour :type turn_context : TurnContext
on_message_activity	Remplacez cette méthode dans une classe dérivée pour fournir une logique spécifique aux activités, telles que la logique conversationnelle.
on_message_reaction_activity	Appelé lorsqu’une activité d’événement est reçue du connecteur lorsque le comportement de base de on_turn est utilisé.
on_reactions_added	Remplacez cette méthode dans une classe dérivée pour fournir une logique pour les réactions à une activité précédente sont ajoutées à la conversation.
on_reactions_removed	Substituez cette méthode dans une classe dérivée pour fournir une logique pour les réactions à une activité précédente sont supprimées de la conversation.
on_sign_in_invoke	Appelé lorsqu’un événement signin/verifyState ou signin/tokenExchange est reçu lorsque le comportement de base de on_invoke_activity(TurnContext{InvokeActivity}) est utilisé. Si vous utilisez un OAuthPrompt, remplacez cette méthode pour transférer cette activité » vers la boîte de dialogue actuelle. Par défaut, cette méthode ne fait rien.
on_token_response_event	Appelé lorsqu’un jetons/réponse événement est reçu lorsque le comportement de base de on_event_activity est utilisé. Si vous utilisez un oauth_prompt, remplacez cette méthode pour transférer cette activité à la boîte de dialogue actuelle.
on_turn	Appelé par l’adaptateur (par exemple, BotFrameworkAdapter) lors de l’exécution pour traiter un Activityentrant.
on_typing_activity	Remplacez cela dans une classe dérivée pour fournir une logique spécifique aux activités ActivityTypes.typing, telles que la logique conversationnelle.
on_unrecognized_activity_type	Appelé lorsqu’une activité autre qu’un message, une mise à jour de conversation ou un événement est reçue lorsque le comportement de base de on_turn est utilisé. En cas de substitution, cette méthode peut potentiellement répondre à l’un des autres types d’activités.

on_adaptive_card_invoke

Appelé lorsque le bot reçoit une action de carte adaptative s’exécute.

Lorsque la méthode on_invoke_activity reçoit un invoke avec un Activity.name de adaptiveCard/action, elle appelle cette méthode.

async on_adaptive_card_invoke(turn_context: TurnContext, invoke_value: AdaptiveCardInvokeValue) -> AdaptiveCardInvokeResponse

Paramètres

Nom	Description
turn_context Obligatoire	TurnContext Objet de contexte pour ce tour.
invoke_value Obligatoire	<xref:botframework.schema.models.AdaptiveCardInvokeValue> Objet typé chaîne à partir de la valeur de l’activité entrante.

Retours

Type	Description
	Objet HealthCheckResponse

on_conversation_update_activity

Appelé lorsqu’une activité de mise à jour de conversation est reçue du canal lorsque le comportement de base de on_turn est utilisé.

async on_conversation_update_activity(turn_context: TurnContext)

Paramètres

Nom	Description
turn_context Obligatoire	TurnContext Objet de contexte pour ce tour

Retours

Type	Description
	Tâche qui représente le travail mis en file d’attente à exécuter

Remarques

Lorsque la méthode on_turn reçoit une activité de mise à jour de conversation, elle appelle cette méthode. Aussi

• Si l’activité de mise à jour de conversation indique que les membres autres que le bot ont rejoint la conversation, il appelle la méthode on_members_added_activity.
• Si l’activité de mise à jour de conversation indique que les membres autres que le bot ont quitté la conversation, il appelle la méthode on_members_removed_activity.
• Dans une classe dérivée, remplacez cette méthode pour ajouter une logique qui s’applique à toutes les activités de mise à jour de conversation. Ajoutez une logique à appliquer avant l’ajout ou la suppression du membre avant l’appel à cette méthode de classe de base.

on_end_of_conversation_activity

Appelé lorsqu’une activité de fin de conversation est reçue du canal.

async on_end_of_conversation_activity(turn_context: TurnContext)

Paramètres

Nom	Description
turn_context Obligatoire	TurnContext Objet de contexte pour ce tour

Retours

Type	Description
	Tâche qui représente le travail mis en file d’attente à exécuter

on_event

Appelé lorsqu’un événement autre que jetons/réponse est reçu lorsque le comportement de base de on_event_activity est utilisé.

async on_event(turn_context: TurnContext)

Paramètres

Nom	Description
turn_context Obligatoire	TurnContext Objet de contexte pour ce tour

Retours

Type	Description
	Tâche qui représente le travail mis en file d’attente à exécuter

Remarques

Lorsque la méthode on_event_activity est utilisée reçoit un événement avec un nom d’activité autre que jetons/réponse, elle appelle cette méthode. Cette méthode peut éventuellement être remplacée si le bot est destiné à gérer divers événements.

on_event_activity

Appelé lorsqu’une activité d’événement est reçue du connecteur lorsque le comportement de base de on_turn est utilisé.

async on_event_activity(turn_context: TurnContext)

Paramètres

Nom	Description
turn_context Obligatoire	TurnContext Objet de contexte pour ce tour

Retours

Type	Description
	Tâche qui représente le travail mis en file d’attente à exécuter

Remarques

Lorsque la méthode on_turn reçoit une activité d’événement, elle appelle cette méthode. Si le nom de l’activité est jetons/réponse, il appelle on_token_response_event; sinon, il appelle on_event.

Dans une classe dérivée, substituez cette méthode pour ajouter une logique qui s’applique à toutes les activités d’événement. Ajoutez une logique à appliquer avant la logique de gestion des événements spécifique avant l’appel à cette méthode de classe de base. Ajoutez une logique à appliquer après la logique de gestion des événements spécifique après l’appel à cette méthode de classe de base.

Les activités d’événement communiquent des informations programmatiques d’un client ou d’un canal à un bot. La signification d’une activité d’événement est définie par la propriété nom de l’activité d’événement, qui est significative dans l’étendue d’un canal.

on_installation_update

Remplacez cela dans une classe dérivée pour fournir une logique spécifique aux activités ActivityTypes.InstallationUpdate.

async on_installation_update(turn_context: TurnContext)

Paramètres

Nom	Description
turn_context Obligatoire	TurnContext Objet de contexte pour ce tour

Retours

Type	Description
	Tâche qui représente le travail mis en file d’attente à exécuter

on_installation_update_add

Remplacez cela dans une classe dérivée pour fournir une logique spécifique aux activités ActivityTypes.InstallationUpdate avec « action » définie sur « add ».

async on_installation_update_add(turn_context: TurnContext)

Paramètres

Nom	Description
turn_context Obligatoire	TurnContext Objet de contexte pour ce tour

Retours

Type	Description
	Tâche qui représente le travail mis en file d’attente à exécuter

on_installation_update_remove

Remplacez cela dans une classe dérivée pour fournir une logique spécifique aux activités ActivityTypes.InstallationUpdate avec « action » définie sur « remove ».

async on_installation_update_remove(turn_context: TurnContext)

Paramètres

Nom	Description
turn_context Obligatoire	TurnContext Objet de contexte pour ce tour

Retours

Type	Description
	Tâche qui représente le travail mis en file d’attente à exécuter

on_invoke_activity

Inscrit un gestionnaire d’événements d’activité pour l'appeler événement, émis pour chaque activité d’événement entrante.

async on_invoke_activity(turn_context: TurnContext) -> InvokeResponse | None

Paramètres

Nom	Description
turn_context Obligatoire	TurnContext Objet de contexte pour ce tour

Retours

Type	Description
	Tâche qui représente le travail mis en file d’attente à exécuter

on_members_added_activity

Remplacez cette méthode dans une classe dérivée pour fournir une logique lorsque les membres autres que le bot rejoignent la conversation. Vous pouvez ajouter la logique de bienvenue de votre bot.

activité de mise à jour de conversation :type members_added : List :p aram turn_context : objet de contexte pour ce tour :type turn_context : TurnContext

async on_members_added_activity(members_added: List[ChannelAccount], turn_context: TurnContext)

Paramètres

Nom	Description
members_added Obligatoire
turn_context Obligatoire

Retours

Type	Description
	Tâche qui représente le travail mis en file d’attente à exécuter

Remarques

Lorsque la méthode on_conversation_update_activity reçoit une activité de mise à jour de conversation qui indique qu’un ou plusieurs utilisateurs autres que le bot rejoignent la conversation, elle appelle cette méthode.

on_members_removed_activity

Remplacez cette méthode dans une classe dérivée pour fournir une logique lorsque les membres autres que le bot quittent la conversation. Vous pouvez ajouter la logique d’octet de votre bot.

activité de mise à jour de conversation :type members_added : List :p aram turn_context : objet de contexte pour ce tour :type turn_context : TurnContext

async on_members_removed_activity(members_removed: List[ChannelAccount], turn_context: TurnContext)

Paramètres

Nom	Description
members_removed Obligatoire
turn_context Obligatoire

Retours

Type	Description
	Tâche qui représente le travail mis en file d’attente à exécuter

Remarques

Lorsque la méthode on_conversation_update_activity reçoit une activité de mise à jour de conversation qui indique qu’un ou plusieurs utilisateurs autres que le bot quittent la conversation, elle appelle cette méthode.

on_message_activity

Remplacez cette méthode dans une classe dérivée pour fournir une logique spécifique aux activités, telles que la logique conversationnelle.

async on_message_activity(turn_context: TurnContext)

Paramètres

Nom	Description
turn_context Obligatoire	TurnContext Objet de contexte pour ce tour

Retours

Type	Description
	Tâche qui représente le travail mis en file d’attente à exécuter

on_message_reaction_activity

Appelé lorsqu’une activité d’événement est reçue du connecteur lorsque le comportement de base de on_turn est utilisé.

async on_message_reaction_activity(turn_context: TurnContext)

Paramètres

Nom	Description
turn_context Obligatoire	TurnContext Objet de contexte pour ce tour

Retours

Type	Description
	Tâche qui représente le travail mis en file d’attente à exécuter

Remarques

Les réactions de message correspondent à l’utilisateur en ajoutant un « like » ou « sad », etc. (souvent un emoji) à une activité précédemment envoyée.

Les réactions aux messages ne sont prises en charge que par quelques canaux. L’activité à laquelle correspond la réaction du message est indiquée dans la propriété Id de réponse. La valeur de cette propriété est l’ID d’activité d’une activité précédemment envoyée remise au bot en tant que réponse d’un appel d’envoi. Lorsque la méthode on_turn reçoit une activité de réaction de message, elle appelle cette méthode.

• Si la réaction du message indique que les réactions ont été ajoutées à un message, elle appelle

<xref:botbuilder.core.ActivityHandler.on_reaction_added>.

• Si la réaction du message indique que les réactions ont été supprimées d’un message, elle appelle <xref:botbuilder.core.ActivityHandler.on_reaction_removed>.

Dans une classe dérivée, substituez cette méthode pour ajouter une logique qui s’applique à toutes les activités de réaction de message. Ajoutez une logique à appliquer avant les réactions ajoutées ou supprimées avant l’appel à cette méthode de classe de base. Ajoutez une logique à appliquer après les réactions ajoutées ou supprimées après l’appel à cette méthode de classe de base.

on_reactions_added

Remplacez cette méthode dans une classe dérivée pour fournir une logique pour les réactions à une activité précédente sont ajoutées à la conversation.

async on_reactions_added(message_reactions: List[MessageReaction], turn_context: TurnContext)

Paramètres

Nom	Description
message_reactions Obligatoire	List Liste des réactions ajoutées
turn_context Obligatoire	TurnContext Objet de contexte pour ce tour

Retours

Type	Description
	Tâche qui représente le travail mis en file d’attente à exécuter

Remarques

Les réactions aux messages correspondent à l’utilisateur en ajoutant un message « like » ou « sad », etc. (souvent un emoji) à un message précédemment envoyé sur la conversation. Les réactions aux messages ne sont prises en charge que par quelques canaux. L’activité à laquelle le message est en réaction est identifiée par la propriété d’ID de réponse de l’activité. La valeur de cette propriété est l’ID d’activité d’une activité précédemment envoyée. Lorsque le bot envoie une activité, le canal lui affecte un ID, qui est disponible dans l’ID de réponse de ressource du résultat.

on_reactions_removed

Substituez cette méthode dans une classe dérivée pour fournir une logique pour les réactions à une activité précédente sont supprimées de la conversation.

async on_reactions_removed(message_reactions: List[MessageReaction], turn_context: TurnContext)

Paramètres

Nom	Description
message_reactions Obligatoire	List Liste des réactions supprimées
turn_context Obligatoire	TurnContext Objet de contexte pour ce tour

Retours

Type	Description
	Tâche qui représente le travail mis en file d’attente à exécuter

Remarques

Les réactions aux messages correspondent à l’utilisateur en ajoutant un message « like » ou « sad », etc. (souvent un emoji) à un message précédemment envoyé sur la conversation. Les réactions aux messages ne sont prises en charge que par quelques canaux. L’activité à laquelle le message est en réaction est identifiée par la propriété Id de réponse de l’activité. La valeur de cette propriété est l’ID d’activité d’une activité précédemment envoyée. Lorsque le bot envoie une activité, le canal lui affecte un ID, qui est disponible dans l’ID de réponse de ressource du résultat.

on_sign_in_invoke

Appelé lorsqu’un événement signin/verifyState ou signin/tokenExchange est reçu lorsque le comportement de base de on_invoke_activity(TurnContext{InvokeActivity}) est utilisé. Si vous utilisez un OAuthPrompt, remplacez cette méthode pour transférer cette activité » vers la boîte de dialogue actuelle. Par défaut, cette méthode ne fait rien.

async on_sign_in_invoke(turn_context: TurnContext)

Paramètres

Nom	Description
turn_context Obligatoire	TurnContext Objet de contexte pour ce tour

Retours

Type	Description
	Tâche qui représente le travail mis en file d’attente à exécuter

on_token_response_event

Appelé lorsqu’un jetons/réponse événement est reçu lorsque le comportement de base de on_event_activity est utilisé. Si vous utilisez un oauth_prompt, remplacez cette méthode pour transférer cette activité à la boîte de dialogue actuelle.

async on_token_response_event(turn_context: TurnContext)

Paramètres

Nom	Description
turn_context Obligatoire	TurnContext Objet de contexte pour ce tour

Retours

Type	Description
	Tâche qui représente le travail mis en file d’attente à exécuter

Remarques

Lorsque la méthode on_event reçoit un événement avec un nom d’activité de jetons/réponse, elle appelle cette méthode. Si votre bot utilise un oauth_prompt, transférez l’activité entrante à la boîte de dialogue actuelle.

on_turn

Appelé par l’adaptateur (par exemple, BotFrameworkAdapter) lors de l’exécution pour traiter un Activityentrant.

async on_turn(turn_context: TurnContext)

Paramètres

Nom	Description
turn_context Obligatoire	TurnContext Objet de contexte pour ce tour

Retours

Type	Description
	Tâche qui représente le travail mis en file d’attente à exécuter

Remarques

Il appelle d’autres méthodes de cette classe en fonction du type de l’activité à traiter, ce qui permet à une classe dérivée de fournir une logique spécifique au type d’une manière contrôlée. Dans une classe dérivée, remplacez cette méthode pour ajouter une logique qui s’applique à tous les types d’activité. Aussi

• Ajoutez une logique à appliquer avant la logique spécifique au type et avant d’appeler on_turn.
• Ajoutez une logique à appliquer après la logique spécifique au type après l’appel de on_turn.

on_typing_activity

Remplacez cela dans une classe dérivée pour fournir une logique spécifique aux activités ActivityTypes.typing, telles que la logique conversationnelle.

async on_typing_activity(turn_context: TurnContext)

Paramètres

Nom	Description
turn_context Obligatoire	TurnContext Objet de contexte pour ce tour

Retours

Type	Description
	Tâche qui représente le travail mis en file d’attente à exécuter

on_unrecognized_activity_type

Appelé lorsqu’une activité autre qu’un message, une mise à jour de conversation ou un événement est reçue lorsque le comportement de base de on_turn est utilisé. En cas de substitution, cette méthode peut potentiellement répondre à l’un des autres types d’activités.

async on_unrecognized_activity_type(turn_context: TurnContext)

Paramètres

Nom	Description
turn_context Obligatoire	TurnContext Objet de contexte pour ce tour

Retours

Type	Description
	Tâche qui représente le travail mis en file d’attente à exécuter

Remarques

Lorsque la méthode on_turn reçoit une activité qui n’est pas un message, une mise à jour de conversation, une réaction de message ou une activité d’événement, elle appelle cette méthode.