Windows.ApplicationModel.ConversationalAgent 名前空間

Windows Conversational Agent プラットフォームでサポートされているデジタル アシスタントを介して機能を公開する機能をアプリケーションに提供します。

重要

Windows.ApplicationModel.ConversationalAgent API は、制限付きアクセス機能の一部です ( 「LimitedAccessFeatures クラス」を参照してください)。 詳細またはロック解除トークンを要求するには、Microsoft サポートにお問い合わせください。

クラス

ActivationSignalDetectionConfiguration	アクティブ化信号検出器でサポートされる 1 つの信号の構成の詳細を提供します。 たとえば、キーワード (keyword) "Hey Cortana" (米国英語) などです。
ActivationSignalDetectionConfigurationCreationResult	ActivationSignalDetector が ActivationSignalDetectionConfiguration を作成したときの結果を提供します。
ActivationSignalDetector	音声キーワード (keyword)、サウンド検出、ボタン押しなど、ユーザーの環境からの入力に基づいてアクティブ化シグナルを生成できるハードウェアおよびソフトウェア コンポーネントを表します。
ConversationalAgentDetectorManager	デジタルアシスタントの既存の信号検出器と構成定義へのアクセスを提供します。
ConversationalAgentSession	デジタル アシスタントと Windows Conversational Agent プラットフォームの間の通信チャネル。
ConversationalAgentSessionInterruptedEventArgs	SessionInterrupted イベントのイベント データを提供します。
ConversationalAgentSignal	ActivationSignalDetectionConfiguration に対応するエージェントによって検出されたシグナル。 このシグナルは、相互作用を処理するために一致するエージェントをアクティブ化する必要があることを示します。
ConversationalAgentSignalDetectedEventArgs	SignalDetected イベントのイベント データを提供します。
ConversationalAgentSystemStateChangedEventArgs	SystemStateChanged イベントのイベント データを提供します。
DetectionConfigurationAvailabilityChangedEventArgs	ActivationSignalDetectionConfiguration.AvailabilityChanged イベントのイベント データを提供します。
DetectionConfigurationAvailabilityInfo	ActivationSignalDetector の可用性の詳細を提供します。

列挙型

ActivationSignalDetectionConfigurationCreationStatus	デジタル アシスタントの ActivationSignalDetectionConfiguration を作成するときに考えられる結果を指定します。
ActivationSignalDetectionConfigurationRemovalResult	デジタル アシスタントから ActivationSignalDetectionConfiguration を削除するときに考えられる結果を指定します。
ActivationSignalDetectionConfigurationSetModelDataResult	デジタル アシスタントの ActivationSignalDetectionConfiguration のモデル構成データを設定するときに返される可能性のある結果を指定します。
ActivationSignalDetectionConfigurationStateChangeResult	デジタル アシスタントの ActivationSignalDetectionConfiguration を有効または無効にするときに返される可能性のある結果を指定します。
ActivationSignalDetectionTrainingDataFormat	デジタル アシスタントの ActivationSignalDetector でサポートされるアクティブ化シグナル トレーニング データ形式を指定します。
ActivationSignalDetectorKind	サポートされている ActivationSignalDetector 型を 指定します。
ActivationSignalDetectorPowerState	ActivationSignalDetector でサポートされる電源モードを指定します。このモードでは、検出機能の動作が許可される電力関連の条件が記述されます。
ConversationalAgentActivationKind	サポートされているエージェントのアクティブ化の種類を指定します。
ConversationalAgentActivationResult	サポートされているエージェントアクティブ化要求の結果値を指定します。
ConversationalAgentSessionUpdateResponse	ConversationalAgentSession 更新に対して可能な各応答を指定します。
ConversationalAgentState	デジタル アシスタントに使用できる各 AgentState を指定します。
ConversationalAgentSystemStateChangeType	SystemStateChanged イベントで発生する可能性のある状態の変更を指定します。
ConversationalAgentVoiceActivationPrerequisiteKind	音声アクティブ化が機能するために必要な設定を指定します。
DetectionConfigurationAvailabilityChangeKind	ActivationSignalDetector の各 ActivationSignalDetectionConfiguration に対してユーザーによって付与されるアクセス許可レベルを指定します。
DetectionConfigurationTrainingStatus	デジタル アシスタントの ActivationSignalDetector によって認識される音声トレーニング データの状態を指定します。 注意 これらの決定は、個々の信号検出器のトレーニングアルゴリズムによって行われ、検出器のハードウェアまたはソフトウェア実装に固有であり得る。
SignalDetectorResourceKind	ActivationSignalDetectionConfiguration で使用できないと報告される可能性があるシステム リソースの種類を指定します。

注釈

ユーザーは、[設定] で会話エージェントのプラットフォーム レベルの検出シグナルを有効にすることができます。 この信号には、キーワード (keyword)発話、Bluetooth 伝送、システム キーボード アクセラレータ、アプリ内音声認識、またはその他のサウンド (ドア スラム、煙探知器) を含めることができます。 たとえば、Cortana との音声操作を開始する "Hey Cortana" キーワード (keyword)。

プラットフォーム レベルのシグナル検出機能は "ファーストパス" フィルターとして機能し、意図しないアクティブ化が多すぎる可能性があります。 このため、エージェント アプリケーションのコンテキストからより厳格なキーワード (keyword)検出機能を使用するなど、アクティブ化シグナルの追加検証を検討することをお勧めします。

アプリケーションの実行中に ConversationalAgentSignal が検出された場合、または ConversationalAgentSession.SignalDetected イベントに応答できない場合、 アプリケーションは ConversationalAgentTrigger に登録されているタスクを使用してバックグラウンドでアクティブ化されます。

アプリケーションが ConversationalAgentSession.SignalDetected イベント (ConversationalAgentSession.RequestAgentStateChangeAsync を呼び出すことによって) に応答できる間に ConversationalAgentSignal が検出された場合、シグナルは既に処理されているため、バックグラウンドアクティブ化は行われません。

中断可能なセッション (RequestInterruptableAsync を参照) が既にアクティブな状態で会話エージェントに対して ConversationalAgentSignal が検出された場合、セッションは ConversationalAgentSession.SessionInterrupted イベントを受け取り、新しいシグナル イベントが発生したことを示します。

注意

一部のデジタル アシスタント セッションは、別の信号で中断できません。 たとえば、Cortana では、現在のセッションを終了するためにキャンセルまたは停止コマンドを発行する必要があります (ユーザーは Cortana セッションに参加できず、Alexa にコマンドを発行することはできません)。