您可以建立多個版本的代理程式,並將這些版本發布至不同的環境。
編輯介面時,您會編輯草稿介面。您隨時可以將草稿代理程式儲存為代理程式版本,這是代理程式的不可變更快照。
儲存草稿服務專員後,系統會將其發布至預設環境。建立代理程式版本時,您可以將這些版本發布至自訂環境。您可以建立各種自訂環境,用於:
- 測試
- development
- 正式環境
- 其他
實際工作環境流量
一律使用代理程式版本處理正式版流量
每當團隊中的開發人員進行變更時,草稿代理程式就會更新。很容易不小心破壞草稿代理程式,尤其是當有多個人擁有代理程式的寫入權限時。此外,最近編輯的草稿代理程式可能與已訓練的模型不一致,因為訓練可能會延遲或需要手動執行。
您應一律使用代理程式版本來處理實際工作流量。您應先測試草稿代理程式,再將其升級為正式版,這樣如果發現任何問題,您就能回溯至先前的版本。
變更版本時,請考量可能發生的代理程式錯誤
如果在工作階段處於活動狀態時,在實際工作環境中變更代理程式版本,可能會導致部分活動工作階段發生代理程式錯誤。如果舊版和新版不相容,導致工作階段狀態中斷,就可能發生這些錯誤。因此,請在非上線時間或離峰時段變更版本。
在新環境中發布版本
如要將代理程式草稿發布為版本並建立自訂環境,請按照下列步驟操作:
控制台
- 前往 Dialogflow ES 主控台。
- 從左側欄選單中接近頂端的位置選取您的代理程式。
- 按一下代理程式名稱旁邊的設定 settings 按鈕。
- 按一下「環境」分頁標籤。
- 按一下「發布版本」。
- 新增選用說明,然後按一下「下一步」。
選取「+ 新增環境」。
輸入環境名稱。
選擇環境的執行要求方法。
選取環境的文字轉語音設定。
按一下 [發布]。
環境資訊現已列於「Custom environments」部分。
API
- 呼叫 Version type 的
create
方法,建立新的代理程式版本。 - 呼叫 Environment 類型的
create
方法,建立新的環境。在agentVersion
欄位中提供剛剛建立的代理程式版本。
將環境還原至先前版本
您可以將環境還原為先前的代理程式版本:
控制台
- 按一下「Custom environments」部分中的任一環境。
- 環境設定對話方塊隨即開啟。
- 在「Publishing History」部分,按一下先前發布版本的選項 more_vert 按鈕。
- 按一下「還原至此版本」。
- 發布記錄會隨之更新。
API
呼叫環境類型的 patch
/update
方法,以便更新環境。將先前建立的代理程式版本提供給 agentVersion
欄位。
將先前版本載入為草稿
將先前版本載入為草稿時,系統會使用所選代理程式版本覆寫預設環境中的草稿代理程式。
如要將先前版本載入為草稿,請按照下列步驟操作:
控制台
- 前往 Dialogflow ES 主控台。
- 從左側欄選單中接近頂端的位置選取您的代理程式。
- 按一下代理程式名稱旁邊的設定 settings 按鈕。
- 按一下「環境」分頁標籤。
- 按一下「草稿」部分中的「查看所有版本」。
- 按一下要加載至草稿的版本的 more_vert 按鈕。
- 按一下 [Load to Draft] (載入為草稿)。
- 按一下「是,我確定」。
- 重新載入所有已開啟的主控台瀏覽器分頁,以便重新整理並顯示最新的代理程式資料。
API
針對環境類型,使用以下輸入內容呼叫 patch
/update
方法:
- 使用
-
做為環境 ID 指定預設環境。 - 將
allowLoadToDraftAndDiscardChanges
設為 true。 - 針對
agentVersion
欄位,請提供會覆寫草稿代理程式的代理程式版本。
匯出版本
在環境中測試您的代理程式
您可以使用 API 在任何自訂環境中測試代理程式。呼叫 detect intent 方法,但在 agent
和 sessions
之間插入 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