エージェント

Dialogflow CX エージェントは、エンドユーザーとの同時会話を処理する仮想エージェントです。これは、人間の言語のニュアンスを理解する自然言語理解モジュールです。Dialogflow は、会話中のエンドユーザーのテキストまたは音声をアプリやサービスが理解できる構造化データに変換します。Dialogflow エージェントは、システムに必要な種類の会話が処理されるように設計および構築されます。

Dialogflow エージェントは、人間のコールセンター エージェントに似ています。 予想される会話のシナリオに対処するためにトレーニングを行ってください。ただし、トレーニングを過度に行う必要はありません。

エージェントを作成する

注: 1 つの GCP プロジェクトに複数の CX エージェントを作成できます。

エージェントを作成する手順は次のとおりです。

コンソール

1. Dialogflow CX Console を開きます。
2. GCP プロジェクトを作成または選択します。
3. [Create Agent（エージェントを作成）] をクリックします。
4. 基本的なエージェント設定に関するフォームに入力します。
   1. 任意の表示名を選択できます。
   2. お好みのロケーションをお選びください詳細な位置情報の設定を変更する場合は、[編集] ボタンをクリックします。
   3. 使用するタイムゾーンを選択します。
   4. エージェントのデフォルト言語を選択します。 エージェントのデフォルトの言語は、一旦作成されると、変更できません。
5. [保存] をクリックします。

API

プロジェクトのロケーション設定をまだ構成していない場合は、API を使用してエージェントを作成する前に、コンソールでこれらの設定を行う必要があります。現在、API を使用してロケーションの設定を行うことはできません。

エージェントを作成するには、Agent タイプの create メソッドをご覧ください。Agent API リファレンスに移動

エージェント リファレンスのプロトコルとバージョンを選択:

プロトコル	V3	V3beta1
REST	エージェント リソース	エージェント リソース
RPC	エージェント インターフェース	エージェント インターフェース
C#	提供なし	利用できません
Go	提供なし	利用できません
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	提供なし	利用できません
Python	AgentsClient	AgentsClient
Ruby	提供なし	利用できません

終了

エージェントのデータ

Dialogflow エージェントは、仮想エージェントの設定とデータの最上位コンテナとして機能します。

エージェントのデータにアクセスする手順は次のとおりです。

コンソール

1. Dialogflow CX Console を開きます。
2. エージェントの GCP プロジェクトを選択します。
3. リストでエージェントを見つけます。
4. エージェントの表示名をクリックします。
5. 他のガイドの説明に従ってフローやページなどを更新します。

API

更新するデータのガイドをご覧ください。

次のデータはエージェントに関連付けられています。

• インテント
• エンティティ型
• Webhook
• フロー
• ページ
• ルートグループ

さまざまなレベルでデータがどのように適用されるかについては、データ アプリケーション レベルをご覧ください。

エージェントの設定

エージェントの構成にアクセスするには、以下の手順に従います。

コンソール

1. Dialogflow CX Console を開きます。
2. GCP プロジェクトを選択します。
3. エージェントを選択します。
4. [エージェント設定] をクリックします。
5. 必要に応じて設定を更新します。
6. [保存] をクリックします。

API

Agent 型の get メソッドと patch/update メソッドをご覧ください。Agent API リファレンスに移動

エージェント リファレンスのプロトコルとバージョンを選択:

プロトコル	V3	V3beta1
REST	エージェント リソース	エージェント リソース
RPC	エージェント インターフェース	エージェント インターフェース
C#	提供なし	利用できません
Go	提供なし	利用できません
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	提供なし	利用できません
Python	AgentsClient	AgentsClient
Ruby	提供なし	利用できません

終了

以下では、エージェント設定の各カテゴリについて説明します。

全般設定

エージェントでは次の全般設定を使用できます。

• 表示名

  人間が読み取れる形式のエージェントの名前。

• タイムゾーン

  エージェントのデフォルトのタイムゾーン。

• デフォルトの言語

  エージェントがサポートするデフォルトの言語。

• エージェントをロックする

  エージェントがロックされているかどうかを示します。ロックされたエージェントは編集できません。

• Stackdriver Logging を有効にする

  エージェントで Cloud Logging が有効になっているかどうかを示します。

• インタラクションのロギングを有効にする

  品質向上のために秘匿化済みエンドユーザー クエリを収集して保存するかどうかを指定します。

  注: テストや NLU モデルの改善など、一部の機能では、トラフィック ログに依存するため、この設定を有効にする必要があります。

さまざまなレベルでデータがどのように適用されるかについては、データ アプリケーション レベルをご覧ください。

ML の設定

Dialogflow は、機械学習（ML）アルゴリズムを使用して、エンドユーザー入力を理解し、インテントと照合して、構造化データを抽出します。Dialogflow は、ユーザーが提供するトレーニング フレーズと、Dialogflow に組み込まれた言語モデルから学習します。このデータに基づいて、エンドユーザー入力と照合するインテントを決定するモデルを構築します。エージェントのフローごとに一意の ML 設定を適用できます。Dialogflow によって作成されたモデルは、フローごとに一意です。

次のエージェント全体の ML 設定が使用できます。

• ML にスペルの修正を許可する

  これを有効にすると、エンドユーザーの入力にスペルミスや文法ミスがあっても、入力が正しく記述されているものとしてインテントと照合されます。インテント検出レスポンスには、修正済みのエンドユーザー入力が含まれます。たとえば、エンドユーザーが「I want an applle」と入力した場合、「I want an apple」と入力したかのように処理されます。これは、システム エンティティとカスタム エンティティの両方を含むマッチングにも当てはまります。

  スペル修正は、Dialogflow でサポートされているすべての言語で使用できますが、現在は特定のリージョンに限定されています。

  注: 元のユーザー入力と修正されたユーザー入力がそれぞれ異なるインテントと一致する場合は、元のユーザー入力と一致するインテントが選択されます。

  警告とおすすめの方法:

  • スペル修正では ASR（自動音声認識）エラーを修正できないため、ASR 入力を使用しているエージェントではこれを有効にしないことをおすすめします。
  • 修正された入力が誤ったインテントと一致する可能性があります。これを修正するには、誤ってインテントに一致することがよくあるフレーズをに追加します。
  • スペルの修正により、エージェントのレスポンス時間がわずかに増加します。
  • エージェントがドメイン固有の専門用語を使用して定義されている場合、修正が望ましくない場合があります。

次のフロー固有の ML 設定が利用できます。

• NLU タイプ

  次のいずれかになります。

  • Standard: 標準の NLU 技術。
  • Advanced: 高度な NLU 技術。この NLU タイプは、特に大規模なエージェントとフローでは標準より優れています。モデルのトレーニングには時間がかかるため、自動トレーニングは無効になっています。手動、または API を使用して、フローをトレーニングする必要があります。

• 自動トレーニング

  有効にすると、フローがコンソールで更新されるたびにトレーニングされます。フローが大きい場合、コンソール UI の遅延の原因となることがあります。その場合はこの設定を無効にし、必要に応じて大規模なフロー用に手動でトレーニングする必要があります。この設定は、高度な NLU タイプでは有効にできません。

• 分類しきい値

  結果から偽陽性を除外した後でも、多様な自然言語入力との一致に基づいてエージェントが応答できるように、機械学習の分類しきい値を調整できます。この設定は、インテントの一致に必要なインテント検出の信頼度を制御します。

  インテント一致の信頼スコアがしきい値より小さい場合は、no-match イベントが呼び出されます。

  注: この値を調整する前に、ネガティブ サンプルの追加を試みてください。

• トレーニングのステータス

  フローデータの最新更新以降にフローがトレーニングされたかどうかを示します。

• NLU のトレーニング

  フローを手動でトレーニングする場合は、このボタンを使用します。

音声と IVR の設定

以下の音声設定を利用できます。

• 音声適応を有効にする

  自動音声適応をご覧ください。

• 音声の詳細設定

  注: 音声の詳細設定は、テレフォニー統合でのみサポートされています。

  このセクションでは、音声機能に関する追加の詳細設定について説明します。この詳細設定は、オンオフを切り替えできます。 これらの設定はエージェント設定で行います（エージェント全体に適用されます）。 フローの設定（フロー全体に適用され、エージェント設定をオーバーライドします）。 ページの設定（ページに適用され、フローとエージェントの設定をオーバーライドします）。 フルフィルメントの設定（フルフィルメントに適用され、ページ、フロー、エージェントの設定をオーバーライドします）。これらの設定のサブセットは、各レベルでの設定の関連性に応じて、各レベルで使用できます。

  • 音声終了の感度

    注: この設定では、en-US 言語タグのみがサポートされます。

    エンドユーザーの音声入力で音声の終わりを認識する感度を制御します。値の範囲は、0（低い感度で、音声を終了する可能性が低い）から 100（高い感度で、音声を終了する可能性が高い）です。

  • 音声のタイムアウトなし

    Dialogflow がエンドユーザーの音声入力の待機を停止する時間（秒）。デフォルトは 5 秒、最大値は 60 秒です。このタイムアウトに対して、Dialogflow は no-input イベントを呼び出します。

  • 割り込み

    有効にすると、エンドユーザーは Dialogflow レスポンス音声を中断できます。中断されると、Dialogflow は音声の送信を停止し、次のエンドユーザー入力を処理します。

    メッセージ キューに複数のメッセージがあり、割り込みが有効なページ、フロー、エージェントに関連付けられたフルフィルメントによりメッセージがキューに登録された場合、キュー内の後続のメッセージすべてに割り込みが有効になります。この場合、統合により割り込みが有効になっているキュー内のすべてのメッセージが再生されなくなります。

  • Google Cloud Storage URI

    指定した場合、リクエストに関連付けられた音声データが Cloud Storage バケットに保存されます。

    保存された音声	該当するリクエスト
    エンドユーザーの音声入力	DetectIntent, StreamingDetectIntent, AnalyzeContent, StreamingAnalyzeContent
    レスポンス用に合成されたテキスト読み上げ（TTS）音声	AnalyzeContent, StreamingAnalyzeContent

    Storage オブジェクト作成者ロールを、プロジェクト内の次のサービス アカウントに付与してください。

    • 形式が「one-click@df-cx-ALPHANUMERIC_VALUE-ALPHANUMERIC_VALUE.iam.gserviceaccount.com」のサービス アカウント（パートナー組み込みのテレフォニー統合を使用する場合）。

    • Dialogflow CX Phone Gateway の統合を使用する場合、[e-mail] 形式のサービス アカウント。IAM でこのサービス アカウントを見つけるには、[Google 提供のロール付与を含める] オプションをオンにします。

共有設定

アクセス制御をご覧ください。

言語設定

エージェントに追加の言語サポートを追加します。全言語の一覧については、言語リファレンスをご覧ください。

セキュリティ設定

セキュリティ設定をご覧ください。

詳細設定

現在、詳細設定は感情分析でのみ利用できます。

エージェントのエクスポートと復元

注: Dialogflow ES と Dialogflow CX のエージェント タイプには、互換性がありません。互換性のないエージェントは復元できません。

エージェントを復元すると、エージェント環境を除くすべての対象のエージェント リソースが上書きされます。

エージェントをエクスポートまたは復元するには、以下の手順に従います。

コンソール

1. Dialogflow CX Console を開きます。
2. エージェントの GCP プロジェクトを選択します。
3. リスト内のエージェントのオプション メニュー をクリックします。
4. [エクスポート] または [復元] ボタンをクリックします。
5. 手順に沿って操作して完了します。

API

Agent 型の export メソッドと restore メソッドをご覧ください。Agent API リファレンスに移動

エージェント リファレンスのプロトコルとバージョンを選択:

プロトコル	V3	V3beta1
REST	エージェント リソース	エージェント リソース
RPC	エージェント インターフェース	エージェント インターフェース
C#	提供なし	利用できません
Go	提供なし	利用できません
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	提供なし	利用できません
Python	AgentsClient	AgentsClient
Ruby	提供なし	利用できません

終了

エージェントのサイズが上限を超える場合は、エージェントのエクスポートと復元用に Cloud Storage オプションを使用します。

エージェントを削除する

注意: エージェントを削除すると元に戻すことはできません。必要に応じて、エージェントをエクスポートしてバックアップを保持してください。

エージェントを削除するには、完全アクセス権か、編集権限を持つロールが必要です。詳しくは、アクセス制御ガイドをご覧ください。

エージェントを削除するには:

コンソール

1. Dialogflow CX Console を開きます。
2. エージェントの GCP プロジェクトを選択します。
3. リスト内のエージェントのオプション メニュー をクリックします。
4. [削除] ボタンをクリックします。
5. ダイアログで削除を確定します。

API

Agent 型の delete メソッドをご覧ください。Agent API リファレンスに移動

エージェント リファレンスのプロトコルとバージョンを選択:

プロトコル	V3	V3beta1
REST	エージェント リソース	エージェント リソース
RPC	エージェント インターフェース	エージェント インターフェース
C#	提供なし	利用できません
Go	提供なし	利用できません
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	提供なし	利用できません
Python	AgentsClient	AgentsClient
Ruby	提供なし	利用できません

終了

プロジェクトを削除する場合、プロジェクトに関連するすべての Dialogflow CX エージェントとデータが直ちに削除されます。