エージェント

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

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

エージェントを作成する

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

コンソール

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

API

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

エージェントを作成するには、Agent タイプの create メソッドをご覧ください。

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

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

エージェントのデータ

Dialogflow CX エージェントは、仮想エージェントの設定とデータの最上位コンテナとして機能します。次のデータはエージェントに関連付けられています。

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

スマート エンドポイント

Speech-to-Text（STT）は、機械学習を使用して音声をテキストに変換する API です。これにより、音声認識をアプリケーションに統合できます。サポートされている STT モデルには、任意の長文モデル（phone_call など）が含まれます。サポートされている言語は en-US のみです。

エージェントでスマート エンドポイントが有効になっている場合は、待機タイムアウトを設定して追加の時間を指定することで、数値パラメータのスマート エンドポイントの動作をカスタマイズできます。Dialogflow CX は、ユーザーが追加の入力を提供するまで待機します。

待機タイムアウトは、音声タイムアウトがトリガーされる前に STT 文字起こしに何かを追加できる猶予期間です。Dialogflow CX は、ヒューリスティックを使用して、文字起こしに基づいて選択する必要があるタイムアウトを指定します。たとえば、インテントが正常に一致した場合、非常に短いタイムアウトを選択できます。インテントが一致しなかった場合、タイムアウトを延長して別の発言を促し、インテントのマッチングを再試行できます。

その他の STT 機能は次のとおりです。

  • エンドポイントの高速化: リアルタイム分析では、音声文字変換ストリーミングを使用して、STT ストリームが開いたままの状態で、自然な一時停止と発話の完了を区別します。ユーザーが話し終えた場合、Dialogflow CX はストリームを早期に終了して、より迅速なレスポンスを提供します。
  • 自然な会話フィードバック: ユーザーが発話の途中で一時停止した場合、Dialogflow CX は STT タイムアウトを動的に延長して、早期の中断を防ぐことができます。また、仮想エージェントがまだリスニングしていることを確認するために、自然なバックチャネル キュー（「うんうん」、「ふむふむ」など）を挿入することもできます。

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

エージェントをファイルにエクスポートすることや、そのファイルを使用してエージェントを復元することができます。

エージェントのエクスポートには、次のデータを除くすべてのエージェント データが含まれます。

  • フロー バージョン: 選択した環境で使用されているフロー バージョンのみがファイルにエクスポートされます。
  • 環境: 選択した環境以外の環境はファイルにエクスポートされません。

エージェントを復元すると、以下を除くすべてのターゲット エージェント データが上書きされます（すべてのフロー バージョンを含む）。

  • 環境: ターゲット エージェントでは、すべてのカスタム環境が変更されずに残ります。ターゲット エージェント内のカスタム環境が参照するフロー バージョンは、関連する環境が存在する限り存続します。ただし、これらの古いフロー バージョンは、エージェントに関して表示されず、選択可能なフロー バージョンではありません。
  • Vertex AI エージェント アプリ: Vertex AI エージェント アプリへの関連付けは、ターゲット エージェントで変更されません（つまり、GenAppBuilderSettings の engine の値）。これは、結果として得られるエージェントが Vertex AI Agents アプリに関連付けられている必要があるため、データストア エージェントを他の既存のデータストア エージェントにのみ復元できることを意味します。

  • Vertex AI Agents データストア: 次のルールに従って、データストアへのすべての参照がターゲット エージェントで上書きされます。

    • ターゲット エージェントがアプリに関連付けられていない場合は、データストアを参照しているエージェントを復元できません。このような操作を行うと、エラー メッセージが表示されます。この問題を修正するには、ゼロから新しいデータストア エージェントを作成します。（または、データストアの状態ハンドラを追加することで、既存のエージェントをデータストア エージェントに変えることができます。この場合は、関連付けられているアプリをエージェントに追加する手順が表示されます）。
    • ターゲット エージェントがアプリに関連付けられている場合、すべてのデータストア参照は復元時に更新されます。 Google Cloud プロジェクト ID と場所は、ターゲット エージェントのアプリと一致するように更新されます。コレクション ID とデータストア ID は変更されません。つまり、復元オペレーションの前に、一致するタイプのすべての ID のデータストアをターゲット エージェントのアプリに追加する必要があります。

    例: ソース エージェントが projects/123/locations/eu-west2/collections/default_collection/dataStores/myDataStore1 というデータストアを参照し、ターゲット エージェントのアプリの名前が projects/321/locations/us-east1/collections/default_collections/engines/app123 の場合、ターゲット エージェントの結果のデータストア参照は projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1 になります。

エクスポートするときは、エクスポートのファイル形式を選択できます。エージェント データに対してソース管理バージョニングを使用している場合は、JSON 形式でエクスポートする必要があります。エージェントを復元すると、Dialogflow CX によってファイル形式が自動的に決定されます。

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

コンソール

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

API

Agent 型の export メソッドと restore メソッドをご覧ください。

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

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

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

GitHub を使用している場合は、GitHub エクスポート / 復元ガイドもご覧ください。

エージェントを削除する

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

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

コンソール

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

API

Agent 型の delete メソッドをご覧ください。

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

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

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

前へ
Dialogflow CX コンソールの概要
次へ
概要