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