Windows.ApplicationModel.ConversationalAgent Namespace

Fornece aos aplicativos a capacidade de expor a funcionalidade por meio de qualquer assistente digital compatível com a plataforma do Agente de Conversação do Windows.

Importante

As APIs Windows.ApplicationModel.ConversationalAgent fazem parte de um Recurso de Acesso Limitado (consulte Classe LimitedAccessFeatures). Para obter mais informações ou para solicitar um token de desbloqueio, use o Formulário de Solicitação de Token de Acesso do LAF.

Classes

ActivationSignalDetectionConfiguration	Fornece os detalhes de configuração para um único sinal com suporte por um detector de sinais de ativação. Por exemplo, o palavra-chave "Ei Cortana" em inglês dos EUA.
ActivationSignalDetectionConfigurationCreationResult	Fornece os resultados quando um ActivationSignalDetector cria um ActivationSignalDetectionConfiguration.
ActivationSignalDetector	Representa componentes de hardware e software que podem gerar sinais de ativação com base na entrada do ambiente de um usuário, como palavra-chave faladas, detecção de som ou pressionamento de botão.
ConversationalAgentDetectorManager	Fornece acesso ao detector de sinais existente e às definições de configuração de uma assistente digital.
ConversationalAgentSession	O canal de comunicação entre o assistente digital e a plataforma do Agente de Conversação do Windows.
ConversationalAgentSessionInterruptedEventArgs	Fornece dados de evento para o evento SessionInterrupted .
ConversationalAgentSignal	Um sinal detectado por um agente que corresponde a um ActivationSignalDetectionConfiguration. Esse sinal indica que o agente correspondente deve ser ativado para lidar com uma interação.
ConversationalAgentSignalDetectedEventArgs	Fornece dados de evento para o evento SignalDetected .
ConversationalAgentSystemStateChangedEventArgs	Fornece dados de evento para o evento SystemStateChanged .
DetectionConfigurationAvailabilityChangedEventArgs	Fornece dados de evento para o evento ActivationSignalDetectionConfiguration.AvailabilityChanged .
DetectionConfigurationAvailabilityInfo	Fornece detalhes de disponibilidade para o ActivationSignalDetector.

Enumerações

ActivationSignalDetectionConfigurationCreationStatus	Especifica os resultados possíveis ao criar um ActivationSignalDetectionConfiguration para o assistente digital.
ActivationSignalDetectionConfigurationRemovalResult	Especifica os resultados possíveis ao remover um ActivationSignalDetectionConfiguration da assistente digital.
ActivationSignalDetectionConfigurationSetModelDataResult	Especifica os possíveis resultados retornados ao definir os dados de configuração do modelo de um ActivationSignalDetectionConfiguration para o assistente digital.
ActivationSignalDetectionConfigurationStateChangeResult	Especifica os possíveis resultados retornados ao habilitar ou desabilitar ActivationSignalDetectionConfiguration para o assistente digital.
ActivationSignalDetectionTrainingDataFormat	Especifica os formatos de dados de treinamento de sinal de ativação compatíveis com o ActivationSignalDetector para o assistente digital.
ActivationSignalDetectorKind	Especifica os tipos ActivationSignalDetector com suporte.
ActivationSignalDetectorPowerState	Especifica os modos de energia, com suporte de um ActivationSignalDetector, que descrevem as condições relacionadas à energia sob as quais um detector tem permissão para operar.
ConversationalAgentActivationKind	Especifica os tipos de ativação de agente com suporte.
ConversationalAgentActivationResult	Especifica os valores de resultado da solicitação de ativação do agente com suporte.
ConversationalAgentSessionUpdateResponse	Especifica cada resposta possível para uma atualização conversationalAgentSession .
ConversationalAgentState	Especifica cada AgentState possível para um assistente digital.
ConversationalAgentSystemStateChangeType	Especifica as possíveis alterações de estado para o evento SystemStateChanged .
ConversationalAgentVoiceActivationPrerequisiteKind	Especifica as configurações possíveis necessárias para a ativação de voz funcionar.
DetectionConfigurationAvailabilityChangeKind	Especifica os níveis de permissão concedidos por um usuário a cada ActivationSignalDetectionConfiguration de um ActivationSignalDetector.
DetectionConfigurationTrainingStatus	Especifica os estados de dados de treinamento de voz reconhecidos pelo ActivationSignalDetector para a assistente digital. Observação Essas determinações são feitas pelos algoritmos de treinamento de um detector de sinais individual e podem ser específicas para as implementações de hardware ou software do detector.
SignalDetectorResourceKind	Especifica os tipos de recursos do sistema que podem ser relatados como indisponíveis para um ActivationSignalDetectionConfiguration.

Comentários

Os usuários podem habilitar um sinal de detecção no nível da plataforma para um agente de conversa em Configurações. Esse sinal pode incluir um enunciado palavra-chave, transmissão Bluetooth, acelerador de teclado do sistema, reconhecimento de fala no aplicativo ou outros sons (batida de porta, detector de fumaça). Por exemplo, o palavra-chave "Ei Cortana" que inicia uma interação de voz com a Cortana.

Os detectores de sinal no nível da plataforma atuam como um filtro de "primeira passagem" e podem resultar em muitas ativações não intencionais. Por esse motivo, recomendamos que você considere a verificação adicional de um sinal de ativação, como o uso de um detector de palavra-chave mais rigoroso no contexto do aplicativo do agente.

Se um ConversationalAgentSignal for detectado enquanto o aplicativo não estiver em execução ou não puder responder ao evento ConversationalAgentSession.SignalDetected , o aplicativo será ativado em segundo plano usando uma tarefa registrada com um ConversationalAgentTrigger.

Se um conversationalAgentSignal for detectado enquanto o aplicativo puder responder a um evento ConversationalAgentSession.SignalDetected (chamando ConversationalAgentSession.RequestAgentStateChangeAsync), nenhuma ativação em segundo plano ocorrerá, pois o sinal já foi tratado.

Se um ConversationalAgentSignal for detectado para um agente de conversa enquanto uma sessão interruptível (consulte RequestInterruptableAsync) já estiver ativa, a sessão receberá um evento ConversationalAgentSession.SessionInterrupted para indicar que um novo evento de sinal foi gerado.

Observação

Algumas sessões de assistente digital não podem ser interrompidas por outro sinal. Por exemplo, a Cortana exige que o usuário emita um comando cancelar ou parar para encerrar a sessão atual (o usuário não pode estar em uma sessão da Cortana e emitir comandos para Alexa).