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).