版本和環境

您可以建立多個版本的代理程式,並將這些版本發布至不同的環境。

編輯介面時,您會編輯草稿介面。您隨時可以將草稿代理程式儲存為代理程式版本,這是代理程式的不可變更快照。

儲存草稿服務專員後,系統會將其發布至預設環境。建立代理程式版本時,您可以將這些版本發布至自訂環境。您可以建立各種自訂環境,用於:

  • 測試
  • development
  • 正式環境
  • 其他

實際工作環境流量

一律使用代理程式版本處理正式版流量

每當團隊中的開發人員進行變更時,草稿代理程式就會更新。很容易不小心破壞草稿代理程式,尤其是當有多個人擁有代理程式的寫入權限時。此外,最近編輯的草稿代理程式可能與已訓練的模型不一致,因為訓練可能會延遲或需要手動執行。

您應一律使用代理程式版本來處理實際工作流量。您應先測試草稿代理程式,再將其升級為正式版,這樣如果發現任何問題,您就能回溯至先前的版本。

變更版本時,請考量可能發生的代理程式錯誤

如果在工作階段處於活動狀態時,在實際工作環境中變更代理程式版本,可能會導致部分活動工作階段發生代理程式錯誤。如果舊版和新版不相容,導致工作階段狀態中斷,就可能發生這些錯誤。因此,請在非上線時間或離峰時段變更版本。

在新環境中發布版本

如要將代理程式草稿發布為版本並建立自訂環境,請按照下列步驟操作:

控制台

  1. 前往 Dialogflow ES 主控台
  2. 從左側欄選單中接近頂端的位置選取您的代理程式。
  3. 按一下代理程式名稱旁邊的設定 按鈕。
  4. 按一下「環境」分頁標籤。
  5. 按一下「發布版本」
  6. 新增選用說明,然後按一下「下一步」
  7. 選取「+ 新增環境」

  8. 輸入環境名稱。

  9. 選擇環境的執行要求方法。

  10. 選取環境的文字轉語音設定。

  11. 按一下 [發布]

  12. 環境資訊現已列於「Custom environments」部分。

API

  1. 呼叫 Version typecreate 方法,建立新的代理程式版本。
  2. 呼叫 Environment 類型create 方法,建立新的環境。在 agentVersion 欄位中提供剛剛建立的代理程式版本。

將環境還原至先前版本

您可以將環境還原為先前的代理程式版本:

控制台

  1. 按一下「Custom environments」部分中的任一環境。
  2. 環境設定對話方塊隨即開啟。
  3. 在「Publishing History」部分,按一下先前發布版本的選項 按鈕。
  4. 按一下「還原至此版本」
  5. 發布記錄會隨之更新。

API

呼叫環境類型patch/update 方法,以便更新環境。將先前建立的代理程式版本提供給 agentVersion 欄位。

將先前版本載入為草稿

將先前版本載入為草稿時,系統會使用所選代理程式版本覆寫預設環境中的草稿代理程式。

如要將先前版本載入為草稿,請按照下列步驟操作:

控制台

  1. 前往 Dialogflow ES 主控台
  2. 從左側欄選單中接近頂端的位置選取您的代理程式。
  3. 按一下代理程式名稱旁邊的設定 按鈕。
  4. 按一下「環境」分頁標籤。
  5. 按一下「草稿」部分中的「查看所有版本」
  6. 按一下要加載至草稿的版本的 按鈕。
  7. 按一下 [Load to Draft] (載入為草稿)
  8. 按一下「是,我確定」
  9. 重新載入所有已開啟的主控台瀏覽器分頁,以便重新整理並顯示最新的代理程式資料。

API

針對環境類型,使用以下輸入內容呼叫 patch/update 方法:

  • 使用 - 做為環境 ID 指定預設環境。
  • allowLoadToDraftAndDiscardChanges 設為 true。
  • 針對 agentVersion 欄位,請提供會覆寫草稿代理程式的代理程式版本。

匯出版本

如要匯出版本,您必須先將該版本載入草稿,然後匯出代理程式

在環境中測試您的代理程式

您可以使用 API 在任何自訂環境中測試代理程式。呼叫 detect intent 方法,但在 agentsessions 之間插入 environments/environment-name/users/-/,藉此變更端點網址。

舉例來說,下列端點會使用「開發」環境,但使用者未指定:

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

特定環境設定

執行要求和文字轉語音是由環境設定,因此代理程式會使用環境的設定來使用這些功能。

如要進一步瞭解如何在各層級套用資料,請參閱「代理程式應用層級」。

Google 助理

如果您使用Actions on Google 發布環境,請參閱 Dialogflow 執行要求資料庫的版本限制。

超級代理程式

請參閱超級代理程式中的版本和環境運作方式

限制

限制如下:

  • 每個代理程式的環境數量上限:10
  • 每個代理程式的版本數量上限:1,000