一部のサービスと機能は名前を変更中です。生成ハンドブックとフロー機能も、単一の統合コンソールに移行されます。詳しくは、こちらをご覧ください。

このページは Cloud Translation API によって翻訳されました。

エージェント

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

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

エージェントを作成する

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

コンソール

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

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）エージェントは、仮想エージェントの設定とデータの最上位コンテナとして機能します。

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

コンソール

Dialogflow CX コンソールを開きます。
エージェント用の Google Cloud プロジェクトを選択します。
リストでエージェントを見つけます。
エージェントの表示名をクリックします。
他のガイドの説明に従ってフローやページなどを更新します。

API

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

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

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

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

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

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

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

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

環境: ターゲットエージェントでは、すべてのカスタム環境が変更されずに残ります。ターゲットエージェント内のカスタム環境が参照するフローバージョンは、関連する環境が存在する限り存続します。ただし、これらの古いフローバージョンは、エージェントに関して表示されず、選択可能なフローバージョンではありません。
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）によってファイル形式が自動的に決定されます。

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

コンソール

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

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 エクスポート / 復元ガイドもご覧ください。

エージェントを削除する

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

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

コンソール

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

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）エージェントとデータが直ちに削除されます。

エージェントビルダーコンソールの概要

ハンドブック