次の方法で共有


Windows.ApplicationModel.ConversationalAgent 名前空間

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

重要

Windows.ApplicationModel.ConversationalAgent API は、制限付きアクセス機能の一部です ( 「LimitedAccessFeatures クラス」を参照)。 詳細またはロック解除トークンを要求するには、 LAF アクセス トークン要求フォームを使用してください。

クラス

ActivationSignalDetectionConfiguration

アクティブ化信号検出器でサポートされる単一信号の構成の詳細を提供します。 たとえば、キーワード (keyword) "Hey Cortana" (米国英語) です。

ActivationSignalDetectionConfigurationCreationResult

ActivationSignalDetectorActivationSignalDetectionConfiguration を作成した場合の結果を提供します。

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 にコマンドを発行することはできません)。