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