TurnContext Classe

Crée un instance TurnContext. adapter_or_context :p aram : :p aram request :

Héritage

builtins.object

TurnContext

Constructeur

TurnContext(adapter_or_context, request: Activity = None)

Paramètres

Nom	Description
adapter_or_context Obligatoire
request	valeur par défaut: None

Méthodes

apply_conversation_reference	Mises à jour une activité avec les informations de remise d’une référence de conversation. L’appel de cette méthode après get_conversation_reference sur une activité entrante répond correctement à la réponse à une activité reçue. :p aram activity : :p aram reference : :p aram is_incoming : :return :
copy_to	Appelée lorsque cette instance TurnContext est passée dans le constructeur d’une nouvelle instance TurnContext. Peut être substitué dans des classes dérivées. contexte :p aram : :return :
delete_activity	Supprime une activité existante. :p aram id_or_reference : :return :
get
get_conversation_reference	Retourne la référence de conversation pour une activité. Il peut être enregistré en tant qu’ancien objet JSON simple, puis utilisé ultérieurement pour envoyer un message proactif à l’utilisateur. Exemple d’utilisation : reference = TurnContext.get_conversation_reference(context.request) :p aram activity : :return :
get_mentions
get_reply_conversation_reference
has	Retourne true est défini() a été appelé pour une clé. La valeur mise en cache peut être de type « None ». :p aram key : :return :
on_delete_activity	Inscrit un gestionnaire pour être informé d’une activité en cours de suppression et éventuellement intercepter. gestionnaire :p aram : :return :
on_send_activities	Inscrit un gestionnaire pour être averti et intercepter potentiellement l’envoi d’activités. gestionnaire :p aram : :return :
on_update_activity	Inscrit un gestionnaire pour être informé d’une activité en cours de mise à jour et éventuellement intercepter. gestionnaire :p aram : :return :
remove_mention_text
remove_recipient_mention
send_activities
send_activity	Envoie une seule activité ou un seul message à l’utilisateur. :p aram activity_or_text : :return :
send_trace_activity
set	Met en cache une valeur pour la durée de vie du tour actuel. :p aram key : :p aram value : :return :
update_activity	Remplace une activité existante. activité :p aram : :return :

apply_conversation_reference

Mises à jour une activité avec les informations de remise d’une référence de conversation. L’appel de cette méthode après get_conversation_reference sur une activité entrante répond correctement à la réponse à une activité reçue. :p aram activity : :p aram reference : :p aram is_incoming : :return :

static apply_conversation_reference(activity: Activity, reference: ConversationReference, is_incoming: bool = False) -> Activity

Paramètres

Nom	Description
activity Obligatoire
reference Obligatoire
is_incoming	valeur par défaut: False

copy_to

Appelée lorsque cette instance TurnContext est passée dans le constructeur d’une nouvelle instance TurnContext. Peut être substitué dans des classes dérivées. contexte :p aram : :return :

copy_to(context: TurnContext) -> None

Paramètres

Nom	Description
context Obligatoire

delete_activity

Supprime une activité existante. :p aram id_or_reference : :return :

async delete_activity(id_or_reference: str | ConversationReference)

Paramètres

Nom	Description
id_or_reference Obligatoire

get

get(key: str) -> object

Paramètres

Nom	Description
key Obligatoire

get_conversation_reference

Retourne la référence de conversation pour une activité. Il peut être enregistré en tant qu’ancien objet JSON simple, puis utilisé ultérieurement pour envoyer un message proactif à l’utilisateur.

Exemple d’utilisation : reference = TurnContext.get_conversation_reference(context.request) :p aram activity : :return :

static get_conversation_reference(activity: Activity) -> ConversationReference

Paramètres

Nom	Description
activity Obligatoire

get_mentions

static get_mentions(activity: Activity) -> List[Mention]

Paramètres

Nom	Description
activity Obligatoire

get_reply_conversation_reference

static get_reply_conversation_reference(activity: Activity, reply: ResourceResponse) -> ConversationReference

Paramètres

Nom	Description
activity Obligatoire
reply Obligatoire

has

Retourne true est défini() a été appelé pour une clé. La valeur mise en cache peut être de type « None ». :p aram key : :return :

has(key: str) -> bool

Paramètres

Nom	Description
key Obligatoire

on_delete_activity

Inscrit un gestionnaire pour être informé d’une activité en cours de suppression et éventuellement intercepter. gestionnaire :p aram : :return :

on_delete_activity(handler) -> TurnContext

Paramètres

Nom	Description
handler Obligatoire

on_send_activities

Inscrit un gestionnaire pour être averti et intercepter potentiellement l’envoi d’activités. gestionnaire :p aram : :return :

on_send_activities(handler) -> TurnContext

Paramètres

Nom	Description
handler Obligatoire

on_update_activity

Inscrit un gestionnaire pour être informé d’une activité en cours de mise à jour et éventuellement intercepter. gestionnaire :p aram : :return :

on_update_activity(handler) -> TurnContext

Paramètres

Nom	Description
handler Obligatoire

remove_mention_text

static remove_mention_text(activity: Activity, identifier: str) -> str

Paramètres

Nom	Description
activity Obligatoire
identifier Obligatoire

remove_recipient_mention

static remove_recipient_mention(activity: Activity) -> str

Paramètres

Nom	Description
activity Obligatoire

send_activities

async send_activities(activities: List[Activity]) -> List[ResourceResponse]

Paramètres

Nom	Description
activities Obligatoire

send_activity

Envoie une seule activité ou un seul message à l’utilisateur. :p aram activity_or_text : :return :

async send_activity(activity_or_text: Activity | str, speak: str = None, input_hint: str = None) -> ResourceResponse

Paramètres

Nom	Description
activity_or_text Obligatoire
speak	valeur par défaut: None
input_hint	valeur par défaut: None

send_trace_activity

async send_trace_activity(name: str, value: object = None, value_type: str = None, label: str = None) -> ResourceResponse

Paramètres

Nom	Description
name Obligatoire
value	valeur par défaut: None
value_type	valeur par défaut: None
label	valeur par défaut: None

set

Met en cache une valeur pour la durée de vie du tour actuel. :p aram key : :p aram value : :return :

set(key: str, value: object) -> None

Paramètres

Nom	Description
key Obligatoire
value Obligatoire

update_activity

Remplace une activité existante. activité :p aram : :return :

async update_activity(activity: Activity)

Paramètres

Nom	Description
activity Obligatoire

Attributs

activity

Activité reçue. :return :

responded

Si la valeur est true , au moins une réponse a été envoyée pour la tournure actuelle de la conversation. :return :

services

Carte des services et autres valeurs mises en cache pendant la durée de vie du tour. :return :

turn_state