Compartir a través de


TurnContext Clase

Crea una nueva instancia de TurnContext. :p aram adapter_or_context: solicitud :p aram:

Herencia
builtins.object
TurnContext

Constructor

TurnContext(adapter_or_context, request: Activity = None)

Parámetros

Nombre Description
adapter_or_context
Requerido
request
Valor predeterminado: None

Métodos

apply_conversation_reference

Novedades una actividad con la información de entrega de una referencia de conversación. Llamar a esto después de get_conversation_reference en una actividad entrante abordará correctamente la respuesta a una actividad recibida. :p aram activity: :p aram reference: :p aram is_incoming: :return:

copy_to

Se llama cuando esta instancia de TurnContext se pasa al constructor de una nueva instancia de TurnContext. Se puede invalidar en clases derivadas. :p aram context: :return:

delete_activity

Elimina una actividad existente. :p aram id_or_reference: :return:

get
get_conversation_reference

Devuelve la referencia de conversación de una actividad. Esto se puede guardar como un objeto JSON antiguo sin formato y, posteriormente, se puede usar para enviar mensajes al usuario de forma proactiva.

Ejemplo de uso: referencia = TurnContext.get_conversation_reference(context.request) :p aram actividad: :return:

get_mentions
get_reply_conversation_reference
has

Devuelve True se ha llamado a set() para una clave. El valor almacenado en caché puede ser de tipo "None". :p aram clave: :return:

on_delete_activity

Registra un controlador para que se notifique y intercepte potencialmente una actividad que se va a eliminar. controlador :p aram: :return:

on_send_activities

Registra un controlador para que se notifique y intercepte potencialmente el envío de actividades. controlador :p aram: :return:

on_update_activity

Registra un controlador para que se notifique y intercepte potencialmente una actividad que se está actualizando. controlador :p aram: :return:

remove_mention_text
remove_recipient_mention
send_activities
send_activity

Envía una sola actividad o mensaje al usuario. :p aram activity_or_text: :return:

send_trace_activity
set

Almacena en caché un valor durante la vigencia del turno actual. :p aram key: :p aram value: :return:

update_activity

Reemplaza una actividad existente. :p aram actividad: :return:

apply_conversation_reference

Novedades una actividad con la información de entrega de una referencia de conversación. Llamar a esto después de get_conversation_reference en una actividad entrante abordará correctamente la respuesta a una actividad recibida. :p aram activity: :p aram reference: :p aram is_incoming: :return:

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

Parámetros

Nombre Description
activity
Requerido
reference
Requerido
is_incoming
Valor predeterminado: False

copy_to

Se llama cuando esta instancia de TurnContext se pasa al constructor de una nueva instancia de TurnContext. Se puede invalidar en clases derivadas. :p aram context: :return:

copy_to(context: TurnContext) -> None

Parámetros

Nombre Description
context
Requerido

delete_activity

Elimina una actividad existente. :p aram id_or_reference: :return:

async delete_activity(id_or_reference: str | ConversationReference)

Parámetros

Nombre Description
id_or_reference
Requerido

get

get(key: str) -> object

Parámetros

Nombre Description
key
Requerido

get_conversation_reference

Devuelve la referencia de conversación de una actividad. Esto se puede guardar como un objeto JSON antiguo sin formato y, posteriormente, se puede usar para enviar mensajes al usuario de forma proactiva.

Ejemplo de uso: referencia = TurnContext.get_conversation_reference(context.request) :p aram actividad: :return:

static get_conversation_reference(activity: Activity) -> ConversationReference

Parámetros

Nombre Description
activity
Requerido

get_mentions

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

Parámetros

Nombre Description
activity
Requerido

get_reply_conversation_reference

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

Parámetros

Nombre Description
activity
Requerido
reply
Requerido

has

Devuelve True se ha llamado a set() para una clave. El valor almacenado en caché puede ser de tipo "None". :p aram clave: :return:

has(key: str) -> bool

Parámetros

Nombre Description
key
Requerido

on_delete_activity

Registra un controlador para que se notifique y intercepte potencialmente una actividad que se va a eliminar. controlador :p aram: :return:

on_delete_activity(handler) -> TurnContext

Parámetros

Nombre Description
handler
Requerido

on_send_activities

Registra un controlador para que se notifique y intercepte potencialmente el envío de actividades. controlador :p aram: :return:

on_send_activities(handler) -> TurnContext

Parámetros

Nombre Description
handler
Requerido

on_update_activity

Registra un controlador para que se notifique y intercepte potencialmente una actividad que se está actualizando. controlador :p aram: :return:

on_update_activity(handler) -> TurnContext

Parámetros

Nombre Description
handler
Requerido

remove_mention_text

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

Parámetros

Nombre Description
activity
Requerido
identifier
Requerido

remove_recipient_mention

static remove_recipient_mention(activity: Activity) -> str

Parámetros

Nombre Description
activity
Requerido

send_activities

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

Parámetros

Nombre Description
activities
Requerido

send_activity

Envía una sola actividad o mensaje al usuario. :p aram activity_or_text: :return:

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

Parámetros

Nombre Description
activity_or_text
Requerido
speak
Valor predeterminado: None
input_hint
Valor predeterminado: None

send_trace_activity

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

Parámetros

Nombre Description
name
Requerido
value
Valor predeterminado: None
value_type
Valor predeterminado: None
label
Valor predeterminado: None

set

Almacena en caché un valor durante la vigencia del turno actual. :p aram key: :p aram value: :return:

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

Parámetros

Nombre Description
key
Requerido
value
Requerido

update_activity

Reemplaza una actividad existente. :p aram actividad: :return:

async update_activity(activity: Activity)

Parámetros

Nombre Description
activity
Requerido

Atributos

activity

Actividad recibida. :return:

responded

Si se ha enviado al menos una respuesta para el turno actual de conversación. :return:

services

Asignación de servicios y otros valores almacenados en caché durante la vigencia del turno. :return:

turn_state