バージョンと環境

エージェントのバージョンを複数作成して、別々の環境に公開できます。

エージェントを編集する場合は、下書きエージェントを編集することになります。下書きエージェントは、エージェント バージョンとしていつでも保存できます。これは、エージェントの不変のスナップショットです。

下書きエージェントを保存すると、デフォルト環境に公開されます。エージェント バージョンは、作成時にカスタム環境に公開できます。以下の目的で、幅広いカスタム環境を作成できます。

  • テスト
  • 開発
  • 本番環境
  • その他

本番環境トラフィック

本番環境のトラフィックに常にエージェント バージョンを使用する

下書きエージェントは、チームのデベロッパーが変更を加えるたびに更新されます。エージェントへの書き込み権限を持つユーザーが複数人いる場合は特に、下書きエージェントを意図せずに破壊してしまうことがよくあります。また、最近編集された下書きエージェントはトレーニング済みモデルと矛盾する可能性があります。これは、トレーニングが遅れたり、手動による実行が必要とされるためです。

本番環境のトラフィックには、必ずエージェントのバージョンを使用してください。下書きエージェントは本番環境に昇格する前にテストしてください。問題が見つかった場合は以前のバージョンにロールバックできます。

バージョンの変更中に発生する可能性のあるエージェント エラーを考慮する

セッションがアクティブなときに本番環境でエージェント バージョンを変更すると、一部のアクティブなセッションでエージェント エラーが発生する可能性があります。これらのエラーは、以前のバージョンと新しいバージョンで整合性がなく、セッションを中断させるような場合に発生することがあります。そのため、ダウンタイム中やオフピーク時にバージョンを変更する必要があります。

新しい環境でのバージョンの公開

下書きエージェントをバージョンに公開し、カスタム環境を作成するには:

Console

  1. Dialogflow ES コンソールに移動します。
  2. 左側のサイドバー メニューの上部付近でエージェントを選択します。
  3. エージェント名の横にある設定ボタン()をクリックします。
  4. [Environments] タブをクリックします。
  5. [Publish a version] をクリックします。
  6. 任意で説明を追加し、[Next] をクリックします。
  7. [+New Environment] を選択します。

  8. 環境名を入力します。

  9. 環境のフルフィルメントの方法を選択します。

  10. 環境のテキスト読み上げ設定を選択します。

  11. [Publish] をクリックします。

  12. 環境情報は [Custom environments] セクションに一覧表示されます。

API

  1. バージョン タイプcreate メソッドを呼び出して、新しいエージェントのバージョンを作成します。
  2. 環境タイプcreate メソッドを呼び出して、新しい環境を作成します。作成したエージェントのバージョンを agentVersion フィールドに指定します。

環境を以前のバージョンに戻す

環境は、以前のエージェント バージョンに戻すことができます。

Console

  1. [Custom environments] セクションの [environment] をクリックします。
  2. 環境設定ダイアログが開きます。
  3. [Publishing History] セクションでオプションの ボタンをクリックして、以前に公開されたバージョンを表示します。
  4. [Revert to this version] をクリックします。
  5. 公開履歴が更新されます。

API

環境タイプpatch/update メソッドを呼び出して、環境を更新します。前に作成したエージェントのバージョンを agentVersion フィールドに指定します。

以前のバージョンを下書きに読み込む

以前のバージョンを下書きに読み込むと、デフォルトの環境の下書きエージェントが選択したエージェント バージョンで上書きされます。

以前のバージョンを下書きに読み込むには:

Console

  1. Dialogflow ES コンソールに移動します。
  2. 左側のサイドバー メニューの上部付近でエージェントを選択します。
  3. エージェント名の横にある設定ボタン()をクリックします。
  4. [Environments] タブをクリックします。
  5. [下書き] セクションで [すべてのバージョンを表示] をクリックします。
  6. 下書きに読み込むバージョンのオプション ボタンをクリックします。
  7. [Load to Draft] をクリックします。
  8. [YES, I'm sure] をクリックします。
  9. 開いているコンソール ブラウザタブを再読み込みして、最新のエージェント データで更新されるようにします。

API

次の入力を使用して、環境タイプpatch / update メソッドを呼び出します。

  • 環境 ID として - を使用してデフォルト環境を指定します。
  • allowLoadToDraftAndDiscardChanges を true に設定します。
  • agentVersion フィールドに、下書きエージェントを上書きするエージェントのバージョンを指定します。

バージョンをエクスポートする

バージョンをエクスポートするには、まずバージョンを下書きに読み込んでから、エージェントをエクスポートする必要があります。

環境内でエージェントをテストする

API を使用して、任意のカスタム環境でエージェントをテストできます。インテントを検出メソッドを呼び出しますが、agentsessions の間に environments/environment-name/users/-/ を挿入してエンドポイントの URL を変更します。

たとえば、次のエンドポイントでは、「開発」環境で不特定のユーザーが使用されます。

"https://dialogflow.googleapis.com/v2/projects/my-project-id/agent/environments/development/users/-/sessions/123456789:detectIntent"

環境固有の設定

フルフィルメントとテキスト読み上げが環境により構成されるため、エージェントは環境の設定を使用します。

さまざまなレベルでデータがどのように適用されるかの詳細については、エージェント アプリケーション レベルをご覧ください。

Google アシスタント

Actions on Google リリース環境を使用している場合、Dialogflow フルフィルメント ライブラリのバージョニングの制限をご覧ください。

メガ エージェント

メガ エージェントでのバージョンと環境の仕組みをご覧ください。

制限事項

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

  • エージェントごとの環境の最大数: 10
  • エージェントごとのバージョンの最大数: 1,000