Windows.ApplicationModel.ConversationalAgent Spazio dei nomi

Offre alle applicazioni la possibilità di esporre funzionalità tramite qualsiasi assistente digitale supportata dalla piattaforma Windows Conversational Agent.

Importante

Le API Windows.ApplicationModel.ConversationalAgent fanno parte di una funzionalità di accesso limitato (vedere La classe LimitedAccessFeatures). Per altre informazioni o per richiedere un token di sblocco, contattare supporto tecnico Microsoft.

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 statunitense.
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 parlate, 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 la assistente digitale e la piattaforma Agente conversazionale di Windows.
ConversationalAgentSessionInterruptedEventArgs	Fornisce i dati degli eventi per l'evento Session Interrotto .
ConversationalAgentSignal	Segnale rilevato da un agente che corrisponde a un ActivationSignalDetectionConfiguration. Questo segnale indica che l'agente corrispondente deve essere attivato per gestire un'interazione.
ConversationalAgentSignalDetectedEventArgs	Fornisce i dati degli eventi per l'evento SignalDetected .
ConversationalAgentSystemStateChangedEventArgs	Fornisce i dati degli eventi per l'evento SystemStateChanged .
DetectionConfigurationAvailabilityChangedEventArgs	Fornisce i dati dell'evento ActivationSignalDetectionConfiguration.AvailabilityChanged .
DetectionConfigurationAvailabilityInfo	Fornisce i dettagli sulla disponibilità per ActivationSignalDetector.

Enumerazioni

ActivationSignalDetectionConfigurationCreationStatus	Specifica i risultati possibili durante la creazione di un'opzione ActivationSignalDetectionConfiguration per l'assistente digitale.
ActivationSignalDetectionConfigurationRemovalResult	Specifica i risultati possibili quando si rimuove un'opzione ActivationSignalDetectionConfiguration dall'assistente digitale.
ActivationSignalDetectionConfigurationSetModelDataResult	Specifica i possibili risultati restituiti quando si impostano i dati di configurazione del modello di un oggetto ActivationSignalDetectionConfiguration per il assistente digitale.
ActivationSignalDetectionConfigurationStateChangeResult	Specifica i possibili risultati restituiti durante l'abilitazione o la disabilitazione di ActivationSignalDetectionConfiguration per l'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 un attivazioneSignalDetector, 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 dello stato per l'evento SystemStateChanged .
ConversationalAgentVoiceActivationPrerequisiteKind	Specifica le possibili impostazioni necessarie per l'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 dall'attivazioneSignalDetector per il assistente digitale. Nota Queste determinazioni vengono effettuate dagli algoritmi di training di un singolo rilevatore di segnale e possono essere specifici delle implementazioni hardware o software del rilevatore.
SignalDetectorResourceKind	Specifica i tipi di risorse di sistema che potrebbero essere segnalati come non disponibili per un ActivationSignalDetectionConfiguration.

Commenti

Gli utenti possono abilitare un segnale di rilevamento a livello di piattaforma per un agente conversazionale in Impostazioni. Questo segnale può includere un'espressione parola chiave, trasmissione Bluetooth, acceleratore di tastiera di sistema, riconoscimento vocale in-app o altri suoni (slam di 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 considerare 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 viene rilevato un oggetto ConversationalAgentSignal 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 si verifica alcuna attivazione in background, poiché il segnale è già stato gestito.

Se un oggetto ConversationalAgentSignal viene rilevato per un agente conversazionale 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 digitali assistente non possono essere interrotte da un altro segnale. Ad esempio, Cortana richiede all'utente di emettere un comando annulla o arresta per terminare la sessione corrente(l'utente non può essere in una sessione di Cortana e rilasciare comandi a Alexa).