TurnContext Clase
Crea una nueva instancia de TurnContext. :p aram adapter_or_context: solicitud :p aram:
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 |
Actualiza 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. actividad :p aram: :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. contexto de :p aram: :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, después, se usa 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 "Ninguno". :p aram key: :return: |
on_delete_activity |
Registra un controlador para que se notifique e 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. actividad :p aram: :return: |
apply_conversation_reference
Actualiza 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. actividad :p aram: :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
Requerido
|
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. contexto de :p aram: :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, después, se usa 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 "Ninguno". :p aram key: :return:
has(key: str) -> bool
Parámetros
Nombre | Description |
---|---|
key
Requerido
|
|
on_delete_activity
Registra un controlador para que se notifique e 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
Requerido
|
Valor predeterminado: None
|
input_hint
Requerido
|
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
Requerido
|
Valor predeterminado: None
|
value_type
Requerido
|
Valor predeterminado: None
|
label
Requerido
|
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. actividad :p aram: :return:
async update_activity(activity: Activity)
Parámetros
Nombre | Description |
---|---|
activity
Requerido
|
|
Atributos
activity
Actividad recibida. :devolución:
responded
Si verdadero se ha enviado al menos una respuesta para el turno actual de conversación. :devolución:
services
Asignación de servicios y otros valores almacenados en caché durante la vigencia del turno. :devolución: