DialogServiceConnector Clase

Objeto que se comunica con un sistema de diálogo habilitado para voz mediante Bot Framework o Comandos personalizados. Este tipo recibe resultados de conversión de voz a texto y también facilita el envío asincrónico y la recepción de datos de actividad de diálogo que no son de voz.

Herencia

builtins.object

DialogServiceConnector

Constructor

DialogServiceConnector(dialog_service_config: DialogServiceConfig, audio_config: AudioConfig | None = None)

Parámetros

Nombre	Description
dialog_service_config Requerido	Configuración del servicio de diálogo, ya sea para Bot Framework o comandos personalizados.
audio_config	Configuración de la entrada de audio. valor predeterminado: None

Métodos

connect	Establece de forma sincrónica una conexión con el servicio. La conexión se realiza automáticamente cuando es necesario, pero esta llamada manual puede ser útil para asegurarse de que la conexión está activa antes de su primer uso para ayudar a reducir la latencia inicial. A cambio, es posible que la conexión aún no esté lista. Suscríbase al evento conectado de la instancia de conexión que se notificará cuando se establezca la conexión al servicio. Use Connection para recuperar la instancia mediante el from_dialog_service_connector método .
connect_async	Establece de forma asincrónica una conexión con el servicio. La conexión se realiza automáticamente cuando es necesario, pero esta llamada manual puede ser útil para asegurarse de que la conexión está activa antes de su primer uso para ayudar a reducir la latencia inicial.
disconnect	Desconecta sincrónicamente del servicio. Las llamadas posteriores que requieren una conexión se volverán a conectar automáticamente después de la desconexión manual.
disconnect_async	Desconecta de forma asincrónica del servicio. Las llamadas posteriores que requieren una conexión se volverán a conectar automáticamente después de la desconexión manual.
listen_once	Inicia sincrónicamente una interacción de conversión de voz a texto con este conector y se bloquea hasta que se reciba un único resultado final de conversión de voz a texto. El resultado de la conversión de voz en texto recibido también se proporciona a la implementación de diálogo configurada y ese sistema de diálogos puede generar cualquier número de cargas de actividad en respuesta a la interacción de voz. Las interacciones de voz se pueden correlacionar con las actividades a través de datos específicos del diálogo en la carga de actividad.
listen_once_async	Inicia de forma asincrónica una interacción de voz a texto con este conector y se bloquea hasta que se reciba un único resultado final de conversión de voz a texto. El resultado de la conversión de voz en texto recibido también se proporciona a la implementación de diálogo configurada y ese sistema de diálogos puede generar cualquier número de cargas de actividad en respuesta a la interacción de voz. Las interacciones de voz se pueden correlacionar con las actividades a través de datos específicos del diálogo en la carga de actividad.
send_activity	Envía de forma sincrónica una carga de datos al servicio back-end de diálogo al que está conectada esta instancia de DialogServiceConnector. Normalmente, se trata de un documento JSON con su esquema determinado por la implementación del diálogo en el servicio y el contenido de una actividad enviada debe rellenarse con conocimientos sobre el formato y las expectativas de contenido del sistema de diálogos. Las actividades enviadas no están asociadas a ninguna otra interacción y generarán su propio identificador de interacción independiente cuando el servicio lo procese. La correlación de conversaciones y otras interacciones debe realizarse a través de la propia carga de actividad mediante las funcionalidades de la implementación del diálogo usadas.
send_activity_async	Envía de forma asincrónica una actividad al cuadro de diálogo de respaldo, consulte los detalles de la descripción en . send_activity
start_keyword_recognition	Inicia de forma sincrónica una interacción de voz a texto con este conector mediante una palabra clave . Esta interacción usará el modelo de palabra clave proporcionado para escuchar una palabra clave indefinidamente, durante el cual el audio no se envía al servicio de voz y todo el procesamiento se realiza localmente. Cuando se reconoce una palabra clave, DialogServiceConnector se conectará automáticamente al servicio de voz y comenzará a enviar datos de audio desde justo antes de la palabra clave como si listen_once_async se invocaran. Cuando se reciben, el controlador de resultados proporcionado puede procesar los resultados de voz a texto o recuperarse a través de una suscripción al evento reconocido. El resultado de la conversión de voz en texto generado por esta operación también se proporciona a la implementación de diálogo configurada y ese sistema de diálogos puede generar cualquier número de cargas de actividad en respuesta a la interacción de voz. Las interacciones de voz se pueden correlacionar con las actividades a través de datos específicos del diálogo en la carga de actividad. Llame stop_keyword_recognition_async a para detener el reconocimiento iniciado por palabras clave.
start_keyword_recognition_async	Configura de forma asincrónica el conector del servicio de diálogo con el modelo de palabras clave especificado. Después de llamar a este método, el conector escucha la palabra clave para iniciar el reconocimiento. Llame stop_keyword_recognition_async a para detener el reconocimiento iniciado por palabras clave. Consulte start_keyword_recognition para obtener una descripción detallada de la funcionalidad.
stop_keyword_recognition	Detiene sincrónicamente el reconocimiento iniciado por palabra clave.
stop_keyword_recognition_async	Detiene de forma asincrónica el reconocimiento iniciado por la palabra clave.
stop_listening	Solicita una detención inmediata a cualquier operación de escucha activa. Esto puede interrumpir una interacción de voz a texto en curso y cualquier resultado de conversión de voz a texto recibido puede representar una entrada de voz incompleta. No se debe llamar a métodos sincrónicos al controlar un evento. Use stop_listening_async si se desea una detención en respuesta a un evento.
stop_listening_async	Solicita una detención inmediata a cualquier operación de escucha activa. Esto puede interrumpir una interacción de voz a texto en curso y cualquier resultado de conversión de voz a texto recibido puede representar una entrada de voz incompleta.

connect

Establece de forma sincrónica una conexión con el servicio. La conexión se realiza automáticamente cuando es necesario, pero esta llamada manual puede ser útil para asegurarse de que la conexión está activa antes de su primer uso para ayudar a reducir la latencia inicial.

A cambio, es posible que la conexión aún no esté lista. Suscríbase al evento conectado de la instancia de conexión que se notificará cuando se establezca la conexión al servicio. Use Connection para recuperar la instancia mediante el from_dialog_service_connector método .

connect()

connect_async

Establece de forma asincrónica una conexión con el servicio. La conexión se realiza automáticamente cuando es necesario, pero esta llamada manual puede ser útil para asegurarse de que la conexión está activa antes de su primer uso para ayudar a reducir la latencia inicial.

connect_async()

Devoluciones

Tipo	Description
	Un futuro que se cumple una vez que se ha inicializado la conexión.

disconnect

Desconecta sincrónicamente del servicio. Las llamadas posteriores que requieren una conexión se volverán a conectar automáticamente después de la desconexión manual.

disconnect()

disconnect_async

Desconecta de forma asincrónica del servicio. Las llamadas posteriores que requieren una conexión se volverán a conectar automáticamente después de la desconexión manual.

disconnect_async()

Devoluciones

Tipo	Description
	Un futuro que se cumple cuando se desconecta.

listen_once

Inicia sincrónicamente una interacción de conversión de voz a texto con este conector y se bloquea hasta que se reciba un único resultado final de conversión de voz a texto. El resultado de la conversión de voz en texto recibido también se proporciona a la implementación de diálogo configurada y ese sistema de diálogos puede generar cualquier número de cargas de actividad en respuesta a la interacción de voz. Las interacciones de voz se pueden correlacionar con las actividades a través de datos específicos del diálogo en la carga de actividad.

listen_once() -> SpeechRecognitionResult

Devoluciones

Tipo	Description
	el resultado de la conversión de voz en texto del reconocimiento de voz.

listen_once_async

Inicia de forma asincrónica una interacción de voz a texto con este conector y se bloquea hasta que se reciba un único resultado final de conversión de voz a texto. El resultado de la conversión de voz en texto recibido también se proporciona a la implementación de diálogo configurada y ese sistema de diálogos puede generar cualquier número de cargas de actividad en respuesta a la interacción de voz. Las interacciones de voz se pueden correlacionar con las actividades a través de datos específicos del diálogo en la carga de actividad.

listen_once_async() -> ResultFuture

Devoluciones

Tipo	Description
	Un futuro que contiene el valor de resultado de conversión de voz en texto del reconocimiento asincrónico.

send_activity

Envía de forma sincrónica una carga de datos al servicio back-end de diálogo al que está conectada esta instancia de DialogServiceConnector. Normalmente, se trata de un documento JSON con su esquema determinado por la implementación del diálogo en el servicio y el contenido de una actividad enviada debe rellenarse con conocimientos sobre el formato y las expectativas de contenido del sistema de diálogos. Las actividades enviadas no están asociadas a ninguna otra interacción y generarán su propio identificador de interacción independiente cuando el servicio lo procese. La correlación de conversaciones y otras interacciones debe realizarse a través de la propia carga de actividad mediante las funcionalidades de la implementación del diálogo usadas.

send_activity(activity: str) -> str

Parámetros

Nombre	Description
activity Requerido	la carga serializada de una actividad que se va a enviar.

Devoluciones

Tipo

Description

un identificador de interacción adquirido cuando el servicio reconoce la actividad. Esto puede ocurrir antes de que la implementación del diálogo procese y evalúe la actividad y la recepción de un identificador de interacción no indica ningún éxito o error en el procesamiento de la actividad. La información sobre el éxito o el error se puede obtener a través de actividades de respuesta con datos de correlación o con eventos TurnStatusReceived que se correlacionan con este identificador de interacción.

send_activity_async

Envía de forma asincrónica una actividad al cuadro de diálogo de respaldo, consulte los detalles de la descripción en . send_activity

send_activity_async(activity: str) -> ResultFuture

Parámetros

Nombre	Description
activity Requerido	la carga serializada de una actividad que se va a enviar.

Devoluciones

Tipo	Description
	Futuro que contiene el valor de resultado de la operación de envío de actividad asincrónica.

start_keyword_recognition

Inicia de forma sincrónica una interacción de voz a texto con este conector mediante una palabra clave . Esta interacción usará el modelo de palabra clave proporcionado para escuchar una palabra clave indefinidamente, durante el cual el audio no se envía al servicio de voz y todo el procesamiento se realiza localmente. Cuando se reconoce una palabra clave, DialogServiceConnector se conectará automáticamente al servicio de voz y comenzará a enviar datos de audio desde justo antes de la palabra clave como si listen_once_async se invocaran. Cuando se reciben, el controlador de resultados proporcionado puede procesar los resultados de voz a texto o recuperarse a través de una suscripción al evento reconocido. El resultado de la conversión de voz en texto generado por esta operación también se proporciona a la implementación de diálogo configurada y ese sistema de diálogos puede generar cualquier número de cargas de actividad en respuesta a la interacción de voz. Las interacciones de voz se pueden correlacionar con las actividades a través de datos específicos del diálogo en la carga de actividad.

Llame stop_keyword_recognition_async a para detener el reconocimiento iniciado por palabras clave.

start_keyword_recognition(model: KeywordRecognitionModel)

Parámetros

Nombre	Description
model Requerido	el modelo de reconocimiento de palabras clave que especifica la palabra clave que se va a reconocer.

start_keyword_recognition_async

Configura de forma asincrónica el conector del servicio de diálogo con el modelo de palabras clave especificado. Después de llamar a este método, el conector escucha la palabra clave para iniciar el reconocimiento. Llame stop_keyword_recognition_async a para detener el reconocimiento iniciado por palabras clave.

Consulte start_keyword_recognition para obtener una descripción detallada de la funcionalidad.

start_keyword_recognition_async(model: KeywordRecognitionModel)

Parámetros

Nombre	Description
model Requerido	el modelo de reconocimiento de palabras clave que especifica la palabra clave que se va a reconocer.

Devoluciones

Tipo	Description
	Un futuro que se cumple una vez inicializado el reconocimiento.

stop_keyword_recognition

Detiene sincrónicamente el reconocimiento iniciado por palabra clave.

stop_keyword_recognition()

stop_keyword_recognition_async

Detiene de forma asincrónica el reconocimiento iniciado por la palabra clave.

stop_keyword_recognition_async()

Devoluciones

Tipo	Description
	Un futuro que se cumple una vez detenido el reconocimiento.

stop_listening

Solicita una detención inmediata a cualquier operación de escucha activa. Esto puede interrumpir una interacción de voz a texto en curso y cualquier resultado de conversión de voz a texto recibido puede representar una entrada de voz incompleta.

No se debe llamar a métodos sincrónicos al controlar un evento. Use stop_listening_async si se desea una detención en respuesta a un evento.

stop_listening()

Devoluciones

Tipo	Description
	Un futuro que se cumple una vez que se ha detenido la escucha.

stop_listening_async

Solicita una detención inmediata a cualquier operación de escucha activa. Esto puede interrumpir una interacción de voz a texto en curso y cualquier resultado de conversión de voz a texto recibido puede representar una entrada de voz incompleta.

stop_listening_async()

Devoluciones

Tipo	Description
	Un futuro que se cumple una vez que se ha detenido la escucha.

Atributos

activity_received

Indica que se recibió una actividad del back-end.

Las devoluciones de llamada conectadas a esta señal se llaman con una ActivityReceivedEventArgsinstancia de , como argumento único, dependiendo del tipo de reconocedor.

authorization_token

Token de autorización que se usará para conectarse al servicio.

Nota:

El autor de la llamada debe asegurarse de que el token de autorización es válido. Antes de

El token de autorización expira, el autor de la llamada debe actualizarlo mediante una llamada a este establecedor con un

nuevo token válido. De lo contrario, el reconocedor encontrará errores durante el reconocimiento.

canceled

Señal de eventos que contienen resultados de reconocimiento cancelados (que indican un intento de reconocimiento que se canceló como resultado o una solicitud de cancelación directa o, alternativamente, un error de transporte o protocolo).

Las devoluciones de llamada conectadas a esta señal se llaman con una SpeechRecognitionCanceledEventArgsinstancia de , como argumento único.

recognized

Señal de eventos que contienen los resultados finales del reconocimiento (lo que indica un intento de reconocimiento correcto).

Las devoluciones de llamada conectadas a esta señal se llaman con una SpeechRecognitionEventArgsinstancia de , como argumento único, dependiendo del tipo de reconocedor.

recognizing

Señal de eventos que contienen resultados intermedios de reconocimiento.

Las devoluciones de llamada conectadas a esta señal se llaman con una SpeechRecognitionEventArgsinstancia de , como argumento único.

session_started

Señal para eventos que indican el inicio de una sesión de reconocimiento (operación).

Las devoluciones de llamada conectadas a esta señal se llaman con una SessionEventArgs instancia como argumento único.

session_stopped

Señal para eventos que indican el final de una sesión de reconocimiento (operación).

Las devoluciones de llamada conectadas a esta señal se llaman con una SessionEventArgs instancia como argumento único.

speech_activity_template

Obtiene la plantilla JSON que se proporcionará al servicio de voz para la siguiente conversación. El servicio intentará combinar esta plantilla en todas las actividades enviadas al back-end del cuadro de diálogo, independientemente de si el cliente lo originó con SendActivityAsync o generado por el servicio, como sucede con los resultados de conversión de voz a texto.

speech_end_detected

Señal para eventos que indican el final de la voz.

Las devoluciones de llamada conectadas a esta señal se llaman con una RecognitionEventArgs instancia como argumento único.

speech_start_detected

Señal para eventos que indican el inicio de la voz.

Las devoluciones de llamada conectadas a esta señal se llaman con una RecognitionEventArgs instancia como argumento único.

turn_status_received

Indica que se recibió una actualización de estado de turno del back-end.

Las devoluciones de llamada conectadas a esta señal se llaman con una TurnStatusReceivedEventArgsinstancia de , como argumento único.