会話型アクションのサポートは 2023 年 6 月 13 日に終了しました。詳細については、会話型アクションの廃止をご覧ください。

このページは Cloud Translation API によって翻訳されました。

Dialogflow から Actions Builder プロジェクトへの移行

Dialogflow デベロッパーは、既存のアクションを Actions Builder に移行したい場合があります。新しいコンソール内メソッドを使用してアクションを開発すると、多くのメリットがあり、既存の Dialogflow プロジェクトを簡単に移行できます。このページでは、Dialogflow/Actions Builder の移行ツールの使用方法について説明します。

このガイドに進む前に、Dialogflow から Actions Builder への移行の概要をご確認ください。ここには、Dialogflow と Actions Builder の重要なコンセプトおよび相違点が記載されています。

移行ツールの機能

Dialogflow から Actions Builder への移行ツールは、インテントやエンティティなどの特定の Dialogflow 要素を変換し、Action Builder と連携できるようにします。

移行ツールは、次の Dialogflow 要素を Actions Builder に自動的に移行します。

Dialogflow のデフォルトのウェルカムインテント（メイン呼び出しとして移行されます）。
アクションがサポートする各言語のすべてのトレーニングフレーズとエンティティ。
入力コンテキストのないインテント。グローバルインテントとして移行されます。
1 つの入力コンテキストを持つインテント。シーンとインテントとして移行されます。
1 つの入力コンテキストとスロットフィルを持つインテントは、2 つのシーンと 1 つのインテントとなり、スロットフィル付きシーンへの移行を処理します。
Dialogflow のフォールバック、メディア、ウェルカムイベントを使用するインテントは、関連する Actions Builder ハンドラと、トレーニングフレーズを含むインテントになります。
Dialogflow の日付や数値のシステムエンティティを使用するインテントは、関連する Actions Builder のシステムタイプになります。

この移行ツールは、次の Dialogflow 要素を処理しません。

複数の入力コンテキストを持つインテントシーンは手動で作成する必要があります。
Dialogflow でカスタムイベントを使用するインテント。
日付や数値ではない Dialogflow システムエンティティ。これらのエンティティは新しい型として作成されますが、類義語を手動で追加する必要があります。
Dialogflow フルフィルメントのソースコード。API バージョンの違いにより、このコードは Builder に移行されません。

移行ツールにアクセスする

移行ツールにアクセスするには、Actions Console で Dialogflow プロジェクトを開き、[Develop] > [Actions] に移動します。

Actions Console で使用されているプロジェクトがわからない場合は、Dialogflow コンソールに移動し、次の操作を行います。

移行するプロジェクトを開き、設定アイコンをクリックします。
[全般] > [プロジェクト ID] で、[Action on Google] リンクをクリックします。このステップでは、特定のプロジェクトの Actions Console が表示されます。
[Develop] > [Actions] に移動し、[Preview migration] をクリックします。

情報スライドを確認し、[Start migration] をクリックして移行ダッシュボードを表示します。

移行ダッシュボード

移行ダッシュボードには、移行オプションと、移行される項目に関連する情報が表示されます。

移行オプション

移行ツールには、Dialogflow プロジェクトを Actions Builder に移行するための 2 つのオプションがあります。

新しいプロジェクトとして移行する（推奨）
- 既存の Dialogflow プロジェクトをそのままにして、コピーを新しいプロジェクトに移行します。
- 表示名とディレクトリ情報は、既存の本番環境プロジェクトに関連付けられたままになります。ライブプロジェクトを移行したプロジェクトで上書きする方法については、推奨プロセスをご覧ください。
このプロジェクトを移行する
- 既存の Dialogflow プロジェクトが置き換えられ、プロジェクトに定義した既存の表示名とアシスタントディレクトリ情報が保持されます。
  注意: この移行オプションは元に戻せません。既存の Dialogflow プロジェクトは、表示名とディレクトリ情報とともに移行されます。この移行オプションを使用する際の考慮事項:
  - 本番環境のアクションは引き続き公開されますが、なんらかの理由で更新する必要がある場合は、まず手動で移行手順を完了する必要があります。
  - Dialogflow プロジェクトは引き続き編集できますが、表示名とディレクトリ情報が移行後の Actions Builder プロジェクトに関連付けられます。

移行レポート

移行レポートの各セクションを展開すると、次の情報に関するプロジェクト固有の詳細を表示できます。

完全に移行されるデータ
移行対象だが、移行後の追加の設定が必要なデータ。
移行されないデータで、必要に応じて手動で追加する必要があるデータ。
Dialogflow プロジェクトで使用している機能のうち、Actions Builder で使用できないもの。

移行レポートをダウンロードすることもできます。ダウンロードしたレポートは、移行後に変更をする際に参照できます。

移行後の設定

この移行ツールは、Dialogflow プロジェクトの重要な部分を Actions Builder に移行するのに役立ちますが、移行されなかった移行、プロンプト、Webhook を設定するには、追加の開発が必要です。

シーンを使用するように会話のフローを更新する

移行ツールは 1 つの入力コンテキストを持つ Dialogflow インテントに基づいてシーンを生成しますが、これは 1 対 1 の関係ではありません。移行されたシーンの一部は、新しい会話モデルを使用する Actions Builder では意味をなさない可能性があります。

どのようなシーンが必要かを評価して、会話の流れを見直す必要があるかもしれません。アクションの複雑さによっては、生成されたシーンが会話のフローに合わなくなった場合は、そのシーンを削除する方が簡単な場合があります。

グローバルインテントを確認して更新する

入力コンテキストのない Dialogflow インテントは、グローバルインテントとして Actions Builder に移行されます。グローバルインテントは会話全体を通してアクティブであるため、いつでもマッチングできます。

グローバルインテントを使用して、ユーザーがアクションを呼び出したときに、ユーザーを特定のフローにディープリンクすることもできます。生成されたグローバルインテントが、アクティブでグローバルスコープのユーザーがアクセスできるべきかどうかを検証することが重要です。グローバルインテントを通常のインテントに変更するには、インテントをクリックして、グローバルインテント処理オプションを [いいえ] に変更します。

類似のトレーニングフレーズを使用してインテントを統合する

複数のインテントが非常に類似したトレーニングフレーズを共有している場合は、インテントを 1 つの汎用インテントに統合する必要があります。これにより、インテントマッチングの精度が向上します。

たとえば、インテント A には次のトレーニングフレーズがあります。

「準備が整っているか確認したい」
「準備できました」
「やってみる」

インテント B には、次のトレーニングフレーズがあります。

「準備が整っているか確認したい」
「承知しました」

2 つのインテントのトレーニングフレーズは似ているため、インテント A とインテント B をより一般的なインテント（インテント C）に統合し、元のフレーズを削除します。インテント A またはインテント B を参照しているシーンでインテント C を使用します。

インテント C には、次のトレーニングフレーズがあります。

「準備が整っているか確認したい」
「準備できました」
「やってみる」
「承知しました」

イベント処理を更新する

Dialogflow で特定のイベント（fallback、media、welcome）を使用するインテントの場合、移行ツールはそのイベントに関連するシステムインテントを作成します。同じ Dialogflow インテントにトレーニングフレーズがある場合、同じトレーニングフレーズで別のインテントが作成されます。

Actions Builder でイベントの設定を完了するには、必要に応じて Webhook ハンドラと遷移を追加する必要があります。

システムインテントを追加してフォールバックインテントを処理する

Dialogflow では、ユーザーの入力をインテントが認識できない場合をフォールバックインテントが処理します。Actions Builder は、NO_MATCH と NO_INPOUT のシステムインテントを利用して、このようなケースに対応します。

NO_MATCH と NO_INPUT のシステムインテントは、どちらも最大 3 回シーンに追加できます。たとえば、シーンに 3 つの NO_MATCH インテントを追加すると、アクションがユーザーのレスポンスに何を求めているのかについて、段階的に詳細なレスポンスを返すことができます。

Dialogflow プロジェクトでフォールバックインテントを使用している場合は、システムインテントを追加することが重要です。よく使用される Actions Builder のシステムインテントの例には、NO_MATCH や NO_INPUT などがあります。これらのシステムインテントについて詳しくは、システムインテントをご覧ください。

フルフィルメント戦略を更新する

Dialogflow フルフィルメントコードを Actions Builder に移行する作業は、移行プロセスの中でも特に重要な作業の一つです。Webhook 呼び出しと一般的なフルフィルメントのコンセプトは変わりませんが、Actions Builder には関数を再利用するオプションが用意されており、Webhook トリガーの機会を増やしています。

この点を念頭に置いて、Actions Builder の機能を利用できるよう、プロジェクトのフルフィルメントを再検討することをおすすめします。

カスタム Webhook ハンドラ名を使用すると、異なるシーンの複数の部分から同じ Webhook 関数を呼び出すことができます。
Webhook の呼び出しは、シーンの開始、条件付き検証、スロットフィル、インテントマッチングに基づいて行われます。Webhook 呼び出しをいつ、どこで行うかを細かく制御することで、よりクリエイティブなフルフィルメントソリューションが可能になります。

フルフィルメントコードを更新するときは、Webhook 呼び出しをトリガーするタイミングと場所を検討します。[Webhook の呼び出し] オプションを使用すると、シーンの複数の部分で Webhook を有効にできます。Webhook の有効化について詳しくは、フルフィルメント移行ガイドの Webhook セクションをご覧ください。

移行の例

Dialogflow から Actions Builder に移行したプロジェクトは、各ツールで使用する会話モデルが異なるため、構造が大きく異なります。移行されたプロジェクトのコードは、Actions Builder のシーン、プロンプト、遷移を使用したり、再利用可能な Webhook ハンドラなどの機能で使用されたりするため、元のプロジェクトと大きく異なります。

移行されたプロジェクトを比較すると、Dialogflow から Actions Builder に移行する際に必要となる変更の種類と範囲を把握できます。次の移行済みのサンプルプロジェクトを参照して、実装を比較できます。

サンプルプロジェクト	Dialogflow コード	Actions Builder のコード
Google のファクト	プロジェクトコード	プロジェクトコード
トランザクション数	プロジェクトコード	プロジェクトコード
アカウントのリンク	プロジェクトコード	プロジェクトコード