事前構築済みコンポーネントの概要

事前構築済みコンポーネントは、会話エージェント（Dialogflow CX）が提供する一般的なタスクやシナリオ用の事前構築済みフローのコレクションです。これらは、新規エージェントと既存エージェントの両方の開発を加速させるために使用できます。

事前構築済みコンポーネントには次の 2 種類があります。

構成要素: 名前や住所など、特定のパラメータを収集するコンポーネント
ユースケース: 大規模なユーザージャーニーを表すコンポーネントのうち、一つ以上の構成要素を使用するもの（支払いの実行など）。

事前構築済みコンポーネントフローには、すぐに使用できるインテントとエンティティが含まれます。外部サービスとの統合が必要なコンポーネントの場合は、柔軟な Webhook の構成を変更して、適切なエンドポイントと統合する必要があります。

次のビルディングブロックコンポーネントを使用できます。

次のユースケースコンポーネントが使用可能です。

制限事項

次の制限が適用されます。

事前構築済みコンポーネントは現在、英語（en）のみをサポートしています。

事前構築済みコンポーネントをインポートする

事前構築済みエージェントをプロジェクトにインポートするには:

Dialogflow CX コンソールに移動する。
ご自身の Google Cloud プロジェクトを選択します。
エージェントを選択するか、新しいエージェントを作成します。
[Manage] タブを選択します。
[管理] パネルで [事前構築済み] をクリックします。
対象のコンポーネントをクリックし、[フローとしてインポート] をクリックします。
各コンポーネント固有のドキュメントを参照して、Webhook の追加設定が必要かどうかを判断してください。
テストとカスタマイズを開始します。

VPC Service Controls

プロジェクトが VPC Service Controls（VPC-SC）境界内にある場合は、事前構築済みコンポーネントの最新バージョンの、それが格納されている Google がホストする外部の Google Cloud Storage バケットからのインポートを有効にする下り（外向き）ルールの追加が必要になることがあります。VPC-SC ルールで Google がホストするバケットへの下り（外向き）がブロックされている場合、Google Cloud Storage URI「gs://gassets-api-ai/prebuilt_components/cx-standard-prebuilt-components/resource-name にアクセスする権限が拒否されました」というインポートでのエラーメッセージが表示されることがあります。

インポートを有効にするには、Google Cloud Storage バケット gs://gassets-api-ai を含む外部 Google Cloud プロジェクトへのアクセスを許可する下り（外向き）ルールを作成する必要があります。次の属性は、Google 所有のリソースからのインポートを有効にするために必要なリソースとオペレーションを表します。

リソース: projects/921279757870
サービス名: storage.googleapis.com
メソッド: google.storage.objects.get

カスタマイズと設定

コンポーネントをカスタマイズして設定を改善するには:

エージェントの応答とカスタムエンティティを編集して、ビジネスニーズに合わせます。
音声エージェントの場合は、次の音声設定をおすすめします。
- STT モデルを変更して latest_short にします。特定の言語に対して、このモデルでサポートされている機能を確認するには、Speech-to-Text がサポートされている言語をご覧ください。
- 自動音声適応を有効にします。
電話のキーパッドの押下からのパラメータ値抽出を許可するテレフォニー統合を使用する場合は、テレフォニー統合用の DTMF を有効にします。
シミュレータを使用してエージェントをテストします。
音声でコンポーネントをテストするには、Dialogflow CX Phone Gateway を使用することをおすすめします。

Exit イベントを処理する

タスクが正常に完了すると、事前構築されたコンポーネントは END_FLOW シンボリック遷移ターゲットで終了します。

事前構築されたコンポーネントがタスクを完了できない場合、事前構築されたコンポーネントフローへの移行の原因となった呼び出しページに対して次のイベントが発生します。呼び出しページで対応するイベントハンドラを作成して、エージェント内でこれらのイベントを処理することをおすすめします。

組み込みイベントをご覧くください:

flow-cancelled
flow-failed
flow-failed-human-escalation

追加機能

一部のビルド済みコンポーネントには追加機能があります。特定のコンポーネントに実装されている機能を確認するには、コンポーネント固有のドキュメントをご覧ください。

繰り返し機能

エンドユーザーにとって仮想エージェントの解釈が難しい場合や、エージェントのレスポンスを聞き取れなかった場合は、最後のプロンプトを繰り返すよう要求できます。

発話例:

今なんて言った？
もう一度言って。
繰り返してください。
何とおっしゃいました？

待合室機能

エージェントに戻るまでにエンドユーザーには時間が必要で、プロンプトにすぐに答えられない場合は、仮想エージェントに待機するよう要求できます。エンドユーザーが会話を続行する準備ができたら、会話を再開するように「準備ができました」とエージェントに伝えることができます。事前構築された一部のコンポーネントでは、待合室の事前構築されたコンポーネントを呼び出すことで待合室機能が有効になります。待合室機能は、待合室の事前構築済みコンポーネントの概要で説明されている設定手順に沿って、エージェント内の任意の場所で有効にすることもできます。

発話例:

しばらくお待ちください。
しばらくお待ちください。
ちょっと待ってください。確認します。
確認しているので待ってください。
準備できました。

再生機能

エンドユーザーがこれまでに収集したデータを知りたい場合は、エージェントに再生を依頼できます。エージェントは、現在キャプチャされているパラメータを再生します。

発話例:

再生。
再生して。
再生してください。
読んでください。

共通のインテント

共通のインテントは、複数のコンポーネントの共通の動作に使用されるインテントです。

共通のインテント	説明
prebuilt_components_confirmation_yes	肯定や同意を示したり、質問やリクエストに対する発言を強調、増幅する言葉を追加するために使用される肯定的なフレーズ
prebuilt_components_confirmation_no	質問やリクエストに対する否定的、不同意、拒否の表現に使用される否定的なフレーズ
prebuilt_components_confirmation_done	エンドユーザーがタスクやリクエストを完了したことを示すために使用されるフレーズ
prebuilt_components_escalate_human_agent	仮想エージェントがエンドユーザーを人間のエージェントに接続するようリクエストするために使用されるフレーズ
prebuilt_components_start_over	エクスペリエンス全体を最初からやり直すようにリクエストするために使用されるフレーズ
prebuilt_components_playback	エンドユーザーが現在収集している入力を確認できるように、エンドユーザーに対して再生するよう要求する特定のフレーズ。
prebuilt_components_replay	前のプロンプトが再度発話されるようにするリクエストのために使用するフレーズ
prebuilt_components_waiting_room	質問やリクエストに対するレビュー、検索、情報の提供を行うための時間が必要であることを示すフレーズ
prebuilt_components_ready	エンドユーザーがアクションの継続を希望していることを仮想エージェントに通知するために使用されるフレーズ

生成フォールバック

口座残高