以前に Dialogflow CX を使用していた場合は、 CX Agent Studio を使用して新しいエージェントを徐々に構築しながら、既存の フロー を再利用できます。
フローベースのエージェントを作成して、END_SESSION に達するまで会話をフローに引き渡すことができます。 その時点で、会話はフローベースのエージェントを開始した CX Agent Studio エージェントに戻ります。
CX Agent Studio エージェント アプリケーションは、DetectIntent API メソッドを使用してユーザー入力をフローに送信します。
音声入力の場合、CX Agent Studio エージェント アプリケーションは、これらのインタラクションの TTS と STT を処理します。
コンソールを使用して、エージェント アプリケーションとフローの間でデータがどのように送受信されるかを定義できます。
権限を構成する
エージェント アプリケーションが Dialogflow CX フローを呼び出す権限を持つようにするには、 Customer Engagement Suite Service Agent に Dialogflow API クライアント ロールを付与する必要があります。
フローベースのエージェントを作成する
エージェント ビルダーからフローベースのエージェントを作成するには:
- フローベースのエージェントを開始するエージェントの下部にあるプラスボタンをクリックします。
- [フローベースのエージェントをインポート] をクリックします。 構成パネルが開きます。
- フローのプロジェクトを選択します。
- フローのエージェントを選択します。
- 表示名を指定します。
- フローに制御を転送するタイミングを説明する、親 CX Agent Studio エージェントの説明を入力します。
- フローの開始リソースを指定します。
- フローに使用する環境を指定します。 デフォルトはドラフトになります。
- 入力変数のマッピングを指定します。 ここで指定した変数は、セッション パラメータとしてフローに送信されます。
- 出力変数のマッピング。 ここで指定したフロー セッション パラメータは、変数としてエージェント アプリケーションに送信されます。
- [インポート] をクリックします。
移行に関するベスト プラクティス
既存のフローを使用する場合は、次のベスト プラクティスに留意してください。
ハンドブック
CX Agent Studio エージェントはハンドブックと同様の機能を提供しますが、CX Agent Studio エージェントはドロップイン置換ではないことを理解しておくことが重要です。 Dialogflow CX エージェントでは、プレイブックとフローが密結合しているため、直接置換することは困難です。
分離型エージェント タイプと統合型エージェント タイプ
フローとハンドブックの間に複雑な関係がある Dialogflow CX エージェントから CX Agent Studio エージェントに移行する場合は、まずエージェント タイプを分離することを検討する必要があります。
新しいユースケース用に新しい CX Agent Studio エージェントを作成し、古いユースケース用に Dialogflow CX エージェントを引き続き維持できます。 これは、ルーティング レイヤを使用して、呼び出すエージェントのタイプを決定することで実現できます。
CX Agent Studio ステアリング エージェントは、END_SESSION に達して制御が CX Agent Studio ステアリング エージェントに戻るまで、Dialogflow CX エージェント間で転送を実行できないことに注意してください。
このアプローチが実現可能ではなく、既存のフローを使用する必要がある場合は、このガイドで説明されているように、CX Agent Studio フローベースのエージェントを使用できます。 CX Agent Studio エージェントとフロー間のルーティングを管理するには、CX Agent Studio エージェントをステアリング エージェントとして使用することが重要です。
このプロセスは、一度にかなりの労力を要する可能性があることに注意してください。
決定論的なビジネス ロジックのフロー
フローは、決定論的なビジネス ロジックの管理に最適です。特に、CX Agent Studio コールバックで処理できないロジックの場合に最適です。
フローを使用する適切な例:
- 順次データ収集と検証を行う
- セッション パラメータに基づいて認証フローを実行する
フローを使用する不適切な例:
- 定型レスポンスでユーザーに応答する。これは、CX Agent Studio エージェント コールバックを使用して簡単に実現できます。
- インテントの分類と検出を行う。このような目的には LLM を使用する必要があります。
ブラックボックスとしてのフロー
フローの問題の 1 つは、暗黙的なグローバル パラメータであるセッション パラメータに依存していることです。 デフォルトでは、フロー内で収集されたすべてのパラメータがセッション スコープに自動的に伝播され、後続のフローからアクセスできるようになります。 この方法では、アップストリーム フローのパラメータ収集ロジックを変更すると、ダウンストリーム フローが誤って中断されるという問題が発生します。
CX Agent Studio フローベースのエージェントを使用する場合は、この動作を慎重に検討する必要があります。 CX Agent Studio エージェントは、フローをカプセル化されたブラックボックスとして扱う必要があります。必要な情報はすべて、明示的な入力パラメータを介して伝達されます。 フローの開始時に、フローは渡されたパラメータをセッション パラメータとして使用して、指定されたアクションを実行する必要があります。 逆に、フローを終了するときは、フローがセッション パラメータから事前定義された出力パラメータを設定してから、CX Agent Studio エージェントに制御を譲ることが重要です。
例
次の図は、推奨される構成を示しています。この構成では、CX Agent Studio エージェントがルーティング レイヤとして機能し、フローは制御を解放する前に自己完結型のロジックを実行します。
次の図は、ハンドブック <-> フローのインタラクションがルーティング CX Agent Studio エージェントからブラックボックスとしてカプセル化されている限り、許容される構成を示しています（ハンドブックが組み込まれていることに注意してください）。
次の図は、許容されない構成 を示しています。これは、CX Flow BとPS Agent Aの間で複雑なやり取りが行われるため、 インターフェースのカプセル化が損なわれるためです。
