Freigeben über


TurnContext Klasse

Erstellt eine neue TurnContext-instance. :p aram adapter_or_context: :p aram-Anforderung:

Vererbung
builtins.object
TurnContext

Konstruktor

TurnContext(adapter_or_context, request: Activity = None)

Parameter

Name Beschreibung
adapter_or_context
Erforderlich
request
Standardwert: None

Methoden

apply_conversation_reference

Updates eine Aktivität mit den Übermittlungsinformationen aus einem Unterhaltungsverweis. Wenn Sie dies nach get_conversation_reference einer eingehenden Aktivität aufrufen, wird die Antwort auf eine empfangene Aktivität ordnungsgemäß adressieren. :p aram-Aktivität: :p aram-Referenz: :p aram is_incoming: :return:

copy_to

Wird aufgerufen, wenn diese TurnContext-instance an den Konstruktor einer neuen TurnContext-instance übergeben wird. Kann in abgeleiteten Klassen überschrieben werden. :p aram-Kontext: :return:

delete_activity

Löscht eine vorhandene Aktivität. :p aram id_or_reference: :return:

get
get_conversation_reference

Gibt den Konversationsverweis für eine Aktivität zurück. Dies kann als einfaches altes JSON-Objekt gespeichert und später verwendet werden, um dem Benutzer proaktiv eine Nachricht zu senden.

Verwendungsbeispiel: reference = TurnContext.get_conversation_reference(context.request) :p aram-Aktivität: :return:

get_mentions
get_reply_conversation_reference
has

Gibt True zurück, wenn set() für einen Schlüssel aufgerufen wurde. Der zwischengespeicherte Wert kann vom Typ "None" sein. :p aram-Schlüssel: :return:

on_delete_activity

Registriert einen Handler, der benachrichtigt werden soll, und fängt möglicherweise eine Aktivität ab, die gelöscht wird. :p aram-Handler: :return:

on_send_activities

Registriert einen Handler, der benachrichtigt werden soll, und fängt möglicherweise das Senden von Aktivitäten ab. :p aram-Handler: :return:

on_update_activity

Registriert einen Handler, der benachrichtigt werden soll, und fängt möglicherweise eine Aktivität ab, die aktualisiert wird. :p aram-Handler: :return:

remove_mention_text
remove_recipient_mention
send_activities
send_activity

Sendet eine einzelne Aktivität oder Nachricht an den Benutzer. :p aram activity_or_text: :return:

send_trace_activity
set

Speichert einen Wert für die Lebensdauer des aktuellen Turns zwischen. :p aram-Schlüssel: :p aram-Wert: :return:

update_activity

Ersetzt eine vorhandene Aktivität. :p aram-Aktivität: :return:

apply_conversation_reference

Updates eine Aktivität mit den Übermittlungsinformationen aus einem Unterhaltungsverweis. Wenn Sie dies nach get_conversation_reference einer eingehenden Aktivität aufrufen, wird die Antwort auf eine empfangene Aktivität ordnungsgemäß adressieren. :p aram-Aktivität: :p aram-Referenz: :p aram is_incoming: :return:

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

Parameter

Name Beschreibung
activity
Erforderlich
reference
Erforderlich
is_incoming
Standardwert: False

copy_to

Wird aufgerufen, wenn diese TurnContext-instance an den Konstruktor einer neuen TurnContext-instance übergeben wird. Kann in abgeleiteten Klassen überschrieben werden. :p aram-Kontext: :return:

copy_to(context: TurnContext) -> None

Parameter

Name Beschreibung
context
Erforderlich

delete_activity

Löscht eine vorhandene Aktivität. :p aram id_or_reference: :return:

async delete_activity(id_or_reference: str | ConversationReference)

Parameter

Name Beschreibung
id_or_reference
Erforderlich

get

get(key: str) -> object

Parameter

Name Beschreibung
key
Erforderlich

get_conversation_reference

Gibt den Konversationsverweis für eine Aktivität zurück. Dies kann als einfaches altes JSON-Objekt gespeichert und später verwendet werden, um dem Benutzer proaktiv eine Nachricht zu senden.

Verwendungsbeispiel: reference = TurnContext.get_conversation_reference(context.request) :p aram-Aktivität: :return:

static get_conversation_reference(activity: Activity) -> ConversationReference

Parameter

Name Beschreibung
activity
Erforderlich

get_mentions

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

Parameter

Name Beschreibung
activity
Erforderlich

get_reply_conversation_reference

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

Parameter

Name Beschreibung
activity
Erforderlich
reply
Erforderlich

has

Gibt True zurück, wenn set() für einen Schlüssel aufgerufen wurde. Der zwischengespeicherte Wert kann vom Typ "None" sein. :p aram-Schlüssel: :return:

has(key: str) -> bool

Parameter

Name Beschreibung
key
Erforderlich

on_delete_activity

Registriert einen Handler, der benachrichtigt werden soll, und fängt möglicherweise eine Aktivität ab, die gelöscht wird. :p aram-Handler: :return:

on_delete_activity(handler) -> TurnContext

Parameter

Name Beschreibung
handler
Erforderlich

on_send_activities

Registriert einen Handler, der benachrichtigt werden soll, und fängt möglicherweise das Senden von Aktivitäten ab. :p aram-Handler: :return:

on_send_activities(handler) -> TurnContext

Parameter

Name Beschreibung
handler
Erforderlich

on_update_activity

Registriert einen Handler, der benachrichtigt werden soll, und fängt möglicherweise eine Aktivität ab, die aktualisiert wird. :p aram-Handler: :return:

on_update_activity(handler) -> TurnContext

Parameter

Name Beschreibung
handler
Erforderlich

remove_mention_text

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

Parameter

Name Beschreibung
activity
Erforderlich
identifier
Erforderlich

remove_recipient_mention

static remove_recipient_mention(activity: Activity) -> str

Parameter

Name Beschreibung
activity
Erforderlich

send_activities

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

Parameter

Name Beschreibung
activities
Erforderlich

send_activity

Sendet eine einzelne Aktivität oder Nachricht an den Benutzer. :p aram activity_or_text: :return:

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

Parameter

Name Beschreibung
activity_or_text
Erforderlich
speak
Standardwert: None
input_hint
Standardwert: None

send_trace_activity

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

Parameter

Name Beschreibung
name
Erforderlich
value
Standardwert: None
value_type
Standardwert: None
label
Standardwert: None

set

Speichert einen Wert für die Lebensdauer des aktuellen Turns zwischen. :p aram-Schlüssel: :p aram-Wert: :return:

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

Parameter

Name Beschreibung
key
Erforderlich
value
Erforderlich

update_activity

Ersetzt eine vorhandene Aktivität. :p aram-Aktivität: :return:

async update_activity(activity: Activity)

Parameter

Name Beschreibung
activity
Erforderlich

Attribute

activity

Die empfangene Aktivität. :return:

responded

Wenn true , wurde mindestens eine Antwort für den aktuellen Gesprächswechsel gesendet. :return:

services

Zuordnung von Diensten und anderen Werten, die für die Lebensdauer des Turn zwischengespeichert werden. :return:

turn_state