TurnContext Klasse
Erstellt eine neue TurnContext-instance. :p aram adapter_or_context: :p aram-Anforderung:
- Vererbung
-
builtins.objectTurnContext
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: