エージェント

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

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

エージェントを作成する

注: 1 つの Google Cloud プロジェクトに複数の会話エージェント（Dialogflow CX）エージェントを作成できます。

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

コンソール

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

API

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

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

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

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

終了

エージェントのデータ

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

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

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

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

警告: 2025 年 8 月 15 日をもって、OpenAPI ツールと Webhook の未加工の認証情報のエクスポートを終了いたします。Secret Manager に認証情報を保存するように移行する必要があります。手順については、Webhook と Tool のドキュメントをご覧ください。

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

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

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

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

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

注: API とエクスポートされたデータの内容では、Vertex AI Agents アプリは GenAppBuilder Engine と呼ばれます。エクスポートされた JSON パッケージの例では、エンジン名はキー genAppBuilderSettings.engine の下にある agent.json ファイルで確認できます。

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

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

コンソール

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

注: データストア エージェントを復元するには、ターゲット エージェントがデータストア エージェントとして作成されていることを確認してください。

API

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

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

プロトコル	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. エージェント用の Google Cloud プロジェクトを選択します。
3. リスト内のエージェントのオプション メニュー をクリックします。
4. [削除] ボタンをクリックします。
5. ダイアログで削除を確定します。

API

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

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

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

終了

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