Application Integration を使用して会話型エージェントを構築する

アプリケーションインテグレーションでは、会話エージェント（Dialogflow CX）と直接統合することで、会話型エクスペリエンスの作成が簡素化されました。この機能を使用すると、 API トリガーを使用して、統合ワークフローから直接、ユーザーインタラクションを強化し、タスクを自動化するインテリジェント chatbot とツールを構築できます。

会話エージェントとは

会話エージェント（Dialogflow CX）の会話エージェントは、ユーザーと自然言語の会話でやり取りする仮想エージェントです。ユーザー入力を分析し、インテントを解釈して適切なレスポンスを提供することで、インタラクティブでパーソナライズされた会話エクスペリエンスを実現します。これらのエージェントは、ウェブサイト、モバイルアプリ、メッセージングプラットフォームなど、さまざまなチャネルでの会話を処理するように設計されています。

会話エージェントツールとは

会話エージェント（Dialogflow CX）では、ツールは、会話エージェントがアクセスできる特定の機能またはサービスを表します。ツールはハンドブック内で定義され、エージェントがデータの取得、API の実行、外部システムとのやり取りなどのアクションを実行できるようにします。Application Integration は、統合の API トリガーに基づいてこれらのツールを生成するため、統合ロジックを会話フローに簡単に接続できます。

始める前に

Application Integration を使用して会話型エージェントツールを作成する前に、次の点を確認してください。

プリンシパルに次の IAM ロールを割り当てます。
- サービスアカウント管理者（roles/iam.serviceAccountAdmin）
- Service Usage 管理者（roles/serviceusage.serviceUsageAdmin）
- Dialogflow コンソールエージェント編集者（roles/dialogflow.consoleAgentEditor）
プリンシパルにロールを付与する方法については、単一のロールの付与または取り消しをご覧ください。

サービスアカウントに必要な IAM ロール

会話型エージェントツールの作成に使用するサービスアカウントには、次の IAM ロールが必要です。

サービスアカウント	説明	必要なロール
サービスアカウント	会話型エージェントツールの作成に使用されるサービスアカウント。	Application Integration の起動元（`roles/integrations.integrationInvoker`）
Dialogflow サービスエージェント（`service-{$PROJECT_ID}@gcp-sa-dialogflow.iam.gserviceaccount.com`）	会話エージェント（Dialogflow CX）が統合にアクセスするために使用するサービスアカウント。	サービスアカウントトークン作成者（`roles/iam.serviceAccountTokenCreator`）

新しい会話型エージェントツールを作成する

Application Integration を使用して新しい会話型エージェントツールを作成するには、次の操作を行います。

Google Cloud コンソールで [Application Integration] ページに移動します。
Application Integration に移動
ナビゲーションメニューで [統合] をクリックします。
[統合] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。
既存の統合を選択するか、[統合の作成] をクリックして新しい統合を作成します。
新しい統合を作成する場合:
1. [統合の作成] ペインで名前と説明を入力します。
2. 統合のリージョンを選択します。
  注: [リージョン] プルダウンには、Google Cloud プロジェクトにプロビジョニングされたリージョンのみが表示されます。新しいリージョンをプロビジョニングするには、[リージョンを有効にする] をクリックします。詳細については、新しいリージョンを有効にするをご覧ください。
3. 統合用のサービスアカウントを選択します。統合のサービスアカウントの詳細は、統合ツールバーの [統合の概要] ペインでいつでも変更または更新できます。
  注: サービスアカウントを選択するオプションは、選択したリージョンで統合ガバナンスを有効にしている場合にのみ表示されます。
4. [作成] をクリックします。
  統合エディタで統合が開きます。
既存の統合を選択します。統合エディタで統合が開きます。
選択した統合が 1 つ以上の API トリガーで構成されていることを確認します。
統合バージョンを公開します。
デザイナーツールバーで、[]（アクションメニュー）をクリックし、[Create Conversational Agent Tool] を選択します。
Application Integration は、必要な API が有効になっていることを確認します。有効になっていない場合は、有効にするよう求められます。
[Create Conversational Agent Tool] ペインで、次の情報を入力します。
1. API トリガー: デフォルトでは、統合のすべての API トリガーが選択されています。必要に応じて、ツールに含めたくない API トリガーの選択を解除できます。
2. タイプ: [Create new Conversational Agent] を選択し、次の詳細を入力します。
  1. リージョン: エージェントのリージョンを選択します。
  2. エージェント名: エージェントの名前を入力します。
  3. ツール名: ツールの名前を入力します。
3. サービスアカウント: エージェントのリソースアクセスに必要なロールと権限を持つサービスアカウントを選択します。権限がない場合は、付与するよう求められます。
[View spec] をクリックして、選択したトリガーの生成された仕様を確認します。必要に応じて、保存する前に仕様を編集できます。
[保存] をクリックします。
ツールが正常に作成されたことを示すメッセージが表示されます。[表示] をクリックして、会話エージェント（Dialogflow CX）コンソールでエージェントを開きます。
会話エージェント（Dialogflow CX）コンソールで [Playbooks] に移動し、作成したエージェントのハンドブックをクリックして、ツールを使用する手順をハンドブックに追加します。詳細については、ハンドブックツールをご覧ください。

既存のエージェントを使用して会話エージェントツールを作成する

既存のエージェントを使用して会話型エージェントツールを作成するには、次の操作を行います。

Google Cloud コンソールで [Application Integration] ページに移動します。
Application Integration に移動
ナビゲーションメニューで [統合] をクリックします。
[統合] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。
既存の統合を選択するか、[統合の作成] をクリックして新しい統合を作成します。
新しい統合を作成する場合:
1. [統合の作成] ペインで名前と説明を入力します。
2. 統合のリージョンを選択します。
  注: [Regions] プルダウンには、Google Cloud プロジェクトにプロビジョニングされたリージョンのみが表示されます。新しいリージョンをプロビジョニングするには、[リージョンを有効にする] をクリックします。詳細については、新しいリージョンを有効にするをご覧ください。
3. 統合用のサービスアカウントを選択します。統合のサービスアカウントの詳細は、統合ツールバーの [統合の概要] ペインでいつでも変更または更新できます。
  注: サービスアカウントを選択するオプションは、選択したリージョンで統合ガバナンスを有効にしている場合にのみ表示されます。
4. [作成] をクリックします。
  統合エディタで統合が開きます。
既存の統合を選択します。統合エディタで統合が開きます。
選択した統合が 1 つ以上の API トリガーで構成されていることを確認します。
統合バージョンを公開します。
デザイナーツールバーで、[]（アクションメニュー）をクリックし、[Create Conversational Agent Tool] を選択します。
Application Integration は、必要な API が有効になっていることを確認します。有効になっていない場合は、有効にするよう求められます。
[Create Conversational Agent Tool] ペインで、次の情報を入力します。
1. API トリガー: デフォルトでは、統合のすべての API トリガーが選択されています。必要に応じて、ツールに含めたくない API トリガーの選択を解除できます。
2. タイプ: [既存の会話型エージェントを選択] を選択し、次の操作を行います。
  1. 会話型エージェント: プロジェクトで使用可能なエージェントのリストが表示されます。使用するエージェントを選択します。
  2. ツール: [新しいツールを作成] または [既存のツールを選択] を選択します。
    [新しいツールを作成] を選択した場合は、ツールの名前を入力します。
    
    [既存のツールを選択] を選択すると、選択したエージェントで使用可能なツールのリストが表示されます。使用するツールを選択します。
3. サービスアカウント: エージェントのリソースアクセスに必要なロールと権限を持つサービスアカウントを選択します。権限がない場合は、権限を付与するよう求められます。
[View spec] をクリックして、選択したトリガーの生成された仕様を確認します。必要に応じて、保存する前に仕様を編集できます。
[保存] をクリックします。
ツールが正常に作成されたことを示すメッセージが表示されます。[表示] をクリックして、会話エージェント（Dialogflow CX）コンソールでエージェントを開きます。
会話エージェント（Dialogflow CX）コンソールで [Playbooks] に移動し、作成したエージェントのハンドブックをクリックして、ツールを使用する手順をハンドブックに追加します。詳細については、ハンドブックツールをご覧ください。

考慮事項

会話型エージェントツールを使用する場合は、次の点にご注意ください。

会話エージェントツールは、API トリガーを含む公開済みの統合に対してのみ作成できます。
作成後に、会話エージェント（Dialogflow CX）コンソールでエージェントを確認してテストします。