版本和環境

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

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

儲存草稿代理程式時，系統會將其發布至預設環境。建立代理程式版本後，您可以將其發布至自訂環境。您可以建立各種自訂環境，用於：

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

實際工作環境流量

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

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

建議您一律使用代理程式版本處理正式流量。草稿代理程式應先經過測試，再升級為正式版。如果發現任何問題，可以還原為先前的版本。

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

如果在工作階段處於啟用狀態時，變更正式環境中的代理程式版本，部分啟用中的工作階段可能會發生代理程式錯誤。如果新舊版本不一致，導致工作階段狀態中斷，就可能發生這類錯誤。因此，建議您在停機或離峰時段變更版本。

在新環境中發布版本

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

控制台

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

7. 選取「+New Environment」。

   注意： 您可以選取環境選單中的「建立版本但不發布」，建立代理程式版本但不發布。

8. 輸入環境名稱。

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

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

11. 按一下「發布」。

12. 環境資訊現在會列在「Custom environments」(自訂環境) 部分。

API

1. 呼叫 Version 型別的 create 方法，建立新的代理程式版本。
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

使用下列輸入內容，呼叫 Environment 類型的 patch/update 方法：

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

匯出版本

如要匯出版本，請先將版本載入草稿，然後匯出代理程式。

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

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

舉例來說，下列端點會使用「development」環境，且未指定使用者：

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

特定環境設定

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

如要進一步瞭解如何在不同層級套用資料，請參閱代理程式應用程式層級。

Google 助理

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

超級代理程式

請參閱如何使用巨型代理程式的版本和環境。

限制

限制如下：

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