エージェント

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

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

エージェントを作成する

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

コンソール

  1. Dialogflow CX コンソールを開きます。
  2. プロジェクトを作成または選択します。
  3. [Create agent] をクリックします。
  4. [Auto-generate] を選択して データストア エージェント を作成するか、[Build your own] を選択して他の種類のエージェントを作成します。
  5. 基本的なエージェント設定に関するフォームに入力します。
    1. 任意の表示名を選択できます。
    2. お好みの ロケーションをお選びください。 詳細な 位置情報の設定を変更する場合は、 [Edit] ボタンをクリックします。
    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 タイムアウトを動的に延長して、早期の中断を防ぐことができます。また、仮想エージェントがまだリッスンしていることを確認するために、自然なバックチャネル キュー（「mm hmm」、「uh huh」など）を挿入することもできます。

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

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

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

  • フロー バージョン: 下書きのフローのみがファイルにエクスポートされます。
  • 環境: カスタム環境はファイルにエクスポートされません。

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

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

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

    例: ソース エージェントが 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. [Export] または [Restore] ボタンをクリックします。
  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 コンソールの概要
次へ
概要