Compartir a través de


Windows.ApplicationModel.ConversationalAgent Espacio de nombres

Proporciona a las aplicaciones la capacidad de exponer la funcionalidad a través de cualquier asistente digital compatible con la plataforma del Agente de conversación de Windows.

Importante

Las API Windows.ApplicationModel.ConversationalAgent forman parte de una característica de acceso limitado (consulte La clase LimitedAccessFeatures). Para obtener más información o solicitar un token de desbloqueo, use el formulario de solicitud de token de acceso LAF.

Clases

ActivationSignalDetectionConfiguration

Proporciona los detalles de configuración de una sola señal compatible con un detector de señales de activación. Por ejemplo, la palabra clave "Hey Cortana" en inglés de EE. UU.

ActivationSignalDetectionConfigurationCreationResult

Proporciona los resultados cuando un ActivationSignalDetector crea una ActivationSignalDetectionConfiguration.

ActivationSignalDetector

Representa componentes de hardware y software que pueden generar señales de activación basadas en la entrada del entorno de un usuario, como palabras clave habladas, detección de sonido o pulsación de botón.

ConversationalAgentDetectorManager

Proporciona acceso a las definiciones de configuración y detector de señales existentes de un asistente digital.

ConversationalAgentSession

Canal de comunicación entre el asistente digital y la plataforma del agente de conversación de Windows.

ConversationalAgentSessionInterruptedEventArgs

Proporciona datos de eventos para el evento SessionInterrupted .

ConversationalAgentSignal

Señal detectada por un agente que corresponde a activationSignalDetectionConfiguration. Esta señal indica que el agente coincidente debe activarse para controlar una interacción.

ConversationalAgentSignalDetectedEventArgs

Proporciona datos de eventos para el evento SignalDetected .

ConversationalAgentSystemStateChangedEventArgs

Proporciona datos de eventos para el evento SystemStateChanged .

DetectionConfigurationAvailabilityChangedEventArgs

Proporciona datos de eventos para el evento ActivationSignalDetectionConfiguration.AvailabilityChanged .

DetectionConfigurationAvailabilityInfo

Proporciona detalles de disponibilidad para ActivationSignalDetector.

Enumeraciones

ActivationSignalDetectionConfigurationCreationStatus

Especifica los resultados posibles al crear una activationSignalDetectionConfiguration para el asistente digital.

ActivationSignalDetectionConfigurationRemovalResult

Especifica los resultados posibles al quitar activationSignalDetectionConfiguration del asistente digital.

ActivationSignalDetectionConfigurationSetModelDataResult

Especifica los posibles resultados devueltos al establecer los datos de configuración del modelo de una activationSignalDetectionConfiguration para el asistente digital.

ActivationSignalDetectionConfigurationStateChangeResult

Especifica los posibles resultados devueltos al habilitar o deshabilitar ActivationSignalDetectionConfiguration para el asistente digital.

ActivationSignalDetectionTrainingDataFormat

Especifica los formatos de datos de entrenamiento de señal de activación admitidos por ActivationSignalDetector para el asistente digital.

ActivationSignalDetectorKind

Especifica los tipos de ActivationSignalDetector admitidos.

ActivationSignalDetectorPowerState

Especifica los modos de alimentación, compatibles con un ActivationSignalDetector, que describen las condiciones relacionadas con la energía en las que un detector puede funcionar.

ConversationalAgentActivationKind

Especifica los tipos de activación del agente admitidos.

ConversationalAgentActivationResult

Especifica los valores de resultado de la solicitud de activación del agente admitidos.

ConversationalAgentSessionUpdateResponse

Especifica cada respuesta posible para una actualización ConversationalAgentSession .

ConversationalAgentState

Especifica cada AgentState posible para un asistente digital.

ConversationalAgentSystemStateChangeType

Especifica los posibles cambios de estado para el evento SystemStateChanged .

ConversationalAgentVoiceActivationPrerequisiteKind

Especifica la configuración posible necesaria para que funcione la activación por voz.

DetectionConfigurationAvailabilityChangeKind

Especifica los niveles de permiso concedidos por un usuario a cada ActivationSignalDetectionConfiguration de un ActivationSignalDetector.

DetectionConfigurationTrainingStatus

Especifica los estados de datos de entrenamiento de voz reconocidos por ActivationSignalDetector para el asistente digital.

Nota

Estas determinaciones se realizan mediante los algoritmos de entrenamiento de un detector de señales individuales y pueden ser específicos de las implementaciones de hardware o software del detector.

SignalDetectorResourceKind

Especifica los tipos de recursos del sistema que podrían notificarse como no disponibles para activationSignalDetectionConfiguration.

Comentarios

Los usuarios pueden habilitar una señal de detección de nivel de plataforma para un agente de conversación en Configuración. Esta señal puede incluir una expresión de palabra clave, una transmisión por Bluetooth, un acelerador de teclado del sistema, un reconocimiento de voz en la aplicación u otros sonidos (detección de humo, cierre de puerta). Por ejemplo, la palabra clave "Hey Cortana" que comienza una interacción de voz con Cortana.

Los detectores de señales de nivel de plataforma actúan como un filtro de "primer paso" y pueden dar lugar a demasiadas activaciones no deseadas. Por este motivo, se recomienda considerar la comprobación adicional de una señal de activación, como el uso de un detector de palabras clave más estricto desde el contexto de la aplicación del agente.

Si se detecta conversationalAgentSignal mientras la aplicación no se está ejecutando o no puede responder al evento ConversationalAgentSession.SignalDetected , la aplicación se activa en segundo plano mediante una tarea registrada con conversationalAgentTrigger.

Si se detecta un objeto ConversationalAgentSignal mientras la aplicación puede responder a un evento ConversationalAgentSession.SignalDetected (llamando a ConversationalAgentSession.RequestAgentStateChangeAsync), no se produce ninguna activación en segundo plano, ya que la señal ya se ha controlado.

Si se detecta conversationalAgentSignal para un agente de conversación mientras una sesión interrumpible (consulte RequestInterruptableAsync) ya está activa, la sesión recibirá un evento ConversationalAgentSession.SessionInterrupted para indicar que se ha generado un nuevo evento de señal.

Nota

Algunas sesiones de asistente digitales no se pueden interrumpir mediante otra señal. Por ejemplo, Cortana requiere que el usuario emita un comando cancel o stop para finalizar la sesión actual (el usuario no puede estar en una sesión de Cortana y emitir comandos a Alexa).