Windows.ApplicationModel.ConversationalAgent Spazio dei nomi

Offre alle applicazioni la possibilità di esporre le funzionalità tramite qualsiasi assistente digitale supportata dalla piattaforma Agente di conversazione di Windows.

Importante

Le API Windows.ApplicationModel.ConversationalAgent fanno parte di una funzionalità di accesso limitato (vedere classe LimitedAccessFeatures). Per altre informazioni o per richiedere un token di sblocco, usare il modulo di richiesta del token di accesso LAF.

Classi

ActivationSignalDetectionConfiguration	Fornisce i dettagli di configurazione per un singolo segnale supportato da un rilevatore di segnali di attivazione. Ad esempio, la parola chiave "Hey Cortana" in inglese (Stati Uniti).
ActivationSignalDetectionConfigurationCreationResult	Fornisce i risultati quando un ActivationSignalDetector crea un ActivationSignalDetectionConfiguration.
ActivationSignalDetector	Rappresenta componenti hardware e software che possono generare segnali di attivazione in base all'input dell'ambiente di un utente, ad esempio parole chiave vocali, rilevamento audio o pressione del pulsante.
ConversationalAgentDetectorManager	Fornisce l'accesso alle definizioni di rilevamento e configurazione dei segnali esistenti di un assistente digitale.
ConversationalAgentSession	Canale di comunicazione tra il assistente digitale e la piattaforma agente di conversazione di Windows.
ConversationalAgentSessionInterruptedEventArgs	Fornisce i dati dell'evento SessionInterrupted .
ConversationalAgentSignal	Segnale rilevato da un agente che corrisponde a activationSignalDetectionConfiguration. Questo segnale indica che l'agente corrispondente deve essere attivato per gestire un'interazione.
ConversationalAgentSignalDetectedEventArgs	Fornisce i dati dell'evento SignalDetected .
ConversationalAgentSystemStateChangedEventArgs	Fornisce i dati dell'evento SystemStateChanged .
DetectionConfigurationAvailabilityChangedEventArgs	Fornisce i dati dell'evento ActivationSignalDetectionConfiguration.AvailabilityChanged .
DetectionConfigurationAvailabilityInfo	Fornisce i dettagli di disponibilità per ActivationSignalDetector.

Enumerazioni

ActivationSignalDetectionConfigurationCreationStatus	Specifica i risultati possibili durante la creazione di activationSignalDetectionConfiguration per il assistente digitale.
ActivationSignalDetectionConfigurationRemovalResult	Specifica i risultati possibili quando si rimuove un activationSignalDetectionConfiguration dal assistente digitale.
ActivationSignalDetectionConfigurationSetModelDataResult	Specifica i risultati possibili restituiti quando si impostano i dati di configurazione del modello di un activationSignalDetectionConfiguration per il assistente digitale.
ActivationSignalDetectionConfigurationStateChangeResult	Specifica i possibili risultati restituiti durante l'abilitazione o la disabilitazione di ActivationSignalDetectionConfiguration per il assistente digitale.
ActivationSignalDetectionTrainingDataFormat	Specifica i formati di dati di training del segnale di attivazione supportati da ActivationSignalDetector per il assistente digitale.
ActivationSignalDetectorKind	Specifica i tipi ActivationSignalDetector supportati.
ActivationSignalDetectorPowerState	Specifica le modalità di alimentazione, supportate da activationSignalDetector, che descrivono le condizioni correlate all'alimentazione in cui è consentito il funzionamento di un rilevatore.
ConversationalAgentActivationKind	Specifica i tipi di attivazione dell'agente supportati.
ConversationalAgentActivationResult	Specifica i valori dei risultati della richiesta di attivazione dell'agente supportati.
ConversationalAgentSessionUpdateResponse	Specifica ogni possibile risposta per un aggiornamento conversationalAgentSession .
ConversationalAgentState	Specifica ogni possibile AgentState per un assistente digitale.
ConversationalAgentSystemStateChangeType	Specifica le possibili modifiche di stato per l'evento SystemStateChanged .
ConversationalAgentVoiceActivationPrerequisiteKind	Specifica le possibili impostazioni necessarie per il funzionamento dell'attivazione vocale.
DetectionConfigurationAvailabilityChangeKind	Specifica i livelli di autorizzazione concessi da un utente a ogni ActivationSignalDetectionConfiguration di un ActivationSignalDetector.
DetectionConfigurationTrainingStatus	Specifica gli stati dei dati di training vocale riconosciuti da ActivationSignalDetector per il assistente digitale. Nota Queste determinazioni vengono effettuate dagli algoritmi di training di un singolo rilevatore di segnali e possono essere specifiche per le implementazioni hardware o software del rilevatore.
SignalDetectorResourceKind	Specifica i tipi di risorse di sistema che potrebbero essere segnalati come non disponibili per activationSignalDetectionConfiguration.

Commenti

Gli utenti possono abilitare un segnale di rilevamento a livello di piattaforma per un agente di conversazione in Impostazioni. Questo segnale può includere un'espressione parola chiave, la trasmissione Bluetooth, l'acceleratore di tastiera di sistema, il riconoscimento vocale in-app o altri suoni (slam della porta, rilevatore di fumo). Ad esempio, la parola chiave "Hey Cortana" che inizia un'interazione vocale con Cortana.

I rilevatori di segnali a livello di piattaforma fungono da filtro "first-pass" e possono comportare troppi attivazioni impreviste. Per questo motivo, è consigliabile prendere in considerazione la verifica aggiuntiva di un segnale di attivazione, ad esempio l'uso di un rilevatore di parole chiave più rigoroso dal contesto dell'applicazione agente.

Se un oggetto ConversationalAgentSignal viene rilevato mentre l'applicazione non è in esecuzione o non è in grado di rispondere all'evento ConversationalAgentSession.SignalDetected , l'applicazione viene attivata in background usando un'attività registrata con conversationalAgentTrigger.

Se viene rilevato un oggetto ConversationalAgentSignal mentre l'applicazione è in grado di rispondere a un evento ConversationalAgentSession.SignalDetected (chiamando ConversationalAgentSession.RequestAgentStateChangeAsync), non viene eseguita alcuna attivazione in background, perché il segnale è già stato gestito.

Se un oggetto ConversationalAgentSignal viene rilevato per un agente di conversazione mentre una sessione interrotta (vedere RequestInterruptableAsync) è già attiva, la sessione riceverà un evento ConversationalAgentSession.SessionInterrupted per indicare che è stato generato un nuovo evento di segnale.

Nota

Alcune sessioni assistente digitali non possono essere interrotte da un altro segnale. Ad esempio, Cortana richiede all'utente di eseguire un comando di annullamento o arresto per terminare la sessione corrente (l'utente non può trovarsi in una sessione di Cortana e rilasciare comandi ad Alexa).