エージェント フローの複数のバージョンを作成し、それらを別々のサービス環境にデプロイできます。
フローを編集する場合は、下書きフローを編集することになります。下書きフローは、いつでもフロー バージョンとして保存できます。フロー バージョンは、フローデータと、インテント、エンティティ、webhook、ページ、ルートグループなどの関連付けられたエージェント データの不変のスナップショットです。
下書きフローを保存すると、デフォルト環境にデプロイされます。特定のフロー バージョンを作成する場合、カスタム環境にデプロイできます。以下の目的で、幅広いカスタム環境を作成できます。
- テスト
- 開発
- 本番環境
- その他
本番環境トラフィック
下書きフローは、チームのデベロッパーが変更を加えるたびに更新されます。特に複数のユーザーがエージェントへの書き込みアクセス権を持っている場合は、下書きフローを意図せずに中断してしまうことがよくあります。また、最近編集した下書きフローはトレーニング済みモデルと矛盾する可能性があります。これは、トレーニングが遅れたり、手動実行が必要なことがあるためです。
本番環境のトラフィックには、必ずフローのバージョンを使用してください。下書きフローは本番環境に昇格する前にテストしてください。問題が見つかった場合は以前のバージョンにロールバックできます。
フロー バージョンを下書きに読み込む
いつでも、フロー バージョンを下書きに読み込んで、デフォルトの環境で編集して使用できます。
フロー バージョンを下書きに読み込むと、インテントやエンティティなどのエージェント レベルのリソースを含むエージェント内の複数のリソースを更新できます。コンソールまたは API でバージョンを下書きに読み込むときに、エージェント レベルのリソースを上書きするかどうかを選択できます。
フロー バージョンを管理する
フロー バージョンを管理するには、以下の手順を行います。
コンソール
フローの現在のバージョンを一覧表示するには:
- Dialogflow CX Console を開きます。
- GCP プロジェクトを選択します。
- エージェントを選択します。
- [エージェント設定] をクリックします。
- [Version] タブをクリックします。
- エージェントのフローが一覧表示されます。1 つ選択してください。
- 選択したフロー バージョンが一覧表示されます。
フローごとに次の情報が表示されます。
- Version: バージョン名。
- NLU Type: フローのバージョンの NLU タイプ。
- Version Created: バージョンが作成された日時。
- Status: トレーニングのステータス。ステータスが Ready になるまでフロー バージョンは使用できません。
新しいフロー バージョンを作成するには、[Add Version] ボタンをクリックして情報を指定します。
特定のフロー バージョンを下書きフローとして読み込むには、リスト内のバージョンの右側にある読み込みボタンをクリックします。読み込み時にエージェント レベルのデータを上書きするオプションが用意されています。
特定のフロー バージョンを削除するには、リスト内のバージョンの右側にある削除ボタン delete をクリックします。
API
Version
型に対するメソッドをご覧ください。
バージョン リファレンスのプロトコルとバージョンを選択:
プロトコル | V3 | V3beta1 |
---|---|---|
REST | バージョン リソース | バージョン リソース |
RPC | バージョン インターフェース | バージョン インターフェース |
C# | 提供なし | 利用できません |
Go | 提供なし | 利用できません |
Java | VersionsClient | VersionsClient |
Node.js | VersionsClient | VersionsClient |
PHP | 提供なし | 利用できません |
Python | VersionsClient | VersionsClient |
Ruby | 提供なし | 利用できません |
環境の管理
エージェント環境を管理するには、次の手順を行います。
コンソール
エージェントの現在の環境を一覧表示するには:
- Dialogflow CX Console を開きます。
- GCP プロジェクトを選択します。
- エージェントを選択します。
- [エージェント設定] をクリックします。
- [環境] タブをクリックします。
- エージェント環境が一覧表示されます。
新しい環境を作成するには、[Add Environment] ボタンをクリックして情報を指定します。
フロー バージョンを選択して環境を構成するには、環境をクリックして情報を指定します。
環境の編集履歴を表示するには、リスト内の環境の右側にある履歴 history ボタンをクリックします。
環境 ID を含む環境リソース名をコピーするには、リスト内の環境の右側にある コピーボタン content_copy をクリックします。
環境を削除するには、リスト内の環境の右側にある削除ボタン delete をクリックします。
API
Environment
型に対するメソッドをご覧ください。
環境リファレンスのプロトコルとバージョンを選択:
プロトコル | V3 | V3beta1 |
---|---|---|
REST | 環境リソース | 環境リソース |
RPC | 環境インターフェース | 環境インターフェース |
C# | 提供なし | 利用できません |
Go | 提供なし | 利用できません |
Java | EnvironmentsClient | EnvironmentsClient |
Node.js | EnvironmentsClient | EnvironmentsClient |
PHP | 提供なし | 利用できません |
Python | EnvironmentsClient | EnvironmentsClient |
Ruby | 提供なし | 利用できません |
ランタイム セッション呼び出しの環境を指定する
ランタイム セッション呼び出しの環境(detectIntent
、streamingDetectIntent
、matchIntent
、セッション エンティティ呼び出しなど)を指定できます。環境を指定するには、agent
パス パラメータと sessions
パス パラメータの間に environments/environment-id
を挿入してエンドポイント URL を変更します。
たとえば、次のエンドポイントでは 6db409d7-57ac-41d7-83bd-89b8768e2745
環境 ID が使用されます。
https://dialogflow.googleapis.com/v3beta1/projects/my-project-id/locations/us/agents/my-agent-id/environments/6db409d7-57ac-41d7-83bd-89b8768e2745/sessions/my-session-id:detectIntent
環境が指定されていない場合は、デフォルトの環境が使用されます。