Windows.ApplicationModel.ConversationalAgent Spazio dei nomi
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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).