建構專案

動作建構工具 動作 SDK

Actions 專案會將所有動作封裝成單一容器。你將這項專案發布到 Actions on Google，讓 Google 助理瞭解如何探索及叫用對話體驗。

圖 1. 動作專案結構

您可以使用下列低階元件建構 Actions 專案：

• 「設定和資源」會定義專案中繼資料，以及專案圖示等資源。Google 會使用這些資訊將您的動作發布到 Google 助理目錄，方便使用者探索並叫用這些動作。

• 意圖代表要執行的任務，例如部分使用者輸入內容或需要處理的系統事件。最常見的意圖類型是使用者意圖。這些意圖可讓您宣告 NLU (自然語言理解) 引擎自然訓練的詞組，以提供更多更多類似詞組。NLU 會使用這些詞組的匯總來訓練 Google 助理用來比對使用者輸入內容的語言模型。在對話期間，如有部分使用者輸入內容與意圖的語言模型相符，Google 助理執行階段會將意圖傳送至您的動作，以便進行處理並回應使用者。

• 「類型」可讓您從使用者輸入內容擷取結構化資料。透過訓練型註解為類型加上註解，NLU 可以為您擷取相關的結構化資料，因此您無須剖析開放式輸入。

• 情境程序意圖，是動作的主要邏輯執行者。他們能執行運算單元填補、評估條件邏輯、向使用者傳送提示，甚至呼叫外部網路服務來執行商業邏輯。與意圖搭配使用，場景可讓您有效地偵測特定使用者輸入或系統事件，並執行對應的邏輯。

• 「提示」會定義您用於回應使用者的靜態或動態回應。

• Webhook 可讓您將額外工作委派給網路服務 (執行要求)，例如驗證資料或產生提示。您的動作會透過以 JSON 為基礎的 Webhook 通訊協定與執行要求進行通訊。

• 互動式畫布可讓您使用 HTML、CSS 和 JavaScript 的網頁應用程式建立豐富的沉浸式體驗。

建立專案

您必須先在 Actions 主控台建立專案，才能開發 Google 助理。建立專案的步驟如下：

1. 前往動作控制台。
2. 按一下 [新專案]。
3. 輸入專案名稱，然後按一下「Create Project」(建立專案)。
4. 在「您想建構什麼動作？」畫面中，選取最符合專案的類別，然後點選「下一步」。
5. 在「How 如何想要建構」畫面中，選取建構方式，然後按一下「Start Building」(開始建構)。舉例來說，您可以先使用空白專案或範例。

重點：如果您是為互動式畫佈建構應用程式，請按照下列額外步驟操作：

1. 如果您未在「您想建構的動作類型」畫面中選取「遊戲」資訊卡，請按一下頂端導覽列中的「部署」。在「其他資訊」下方，選取「遊戲與娛樂」類別。 按一下 [Save] (儲存)。
2. 按一下「動作」控制台頂端導覽選單的「開發」。
3. 按一下左側導覽列中的 [互動式畫布]。
4. 在「你的動作是否使用互動式畫布？」下方，選取「是」。
5. 選用：在「設定預設網頁應用程式網址」欄位中輸入網頁應用程式的網址。這項操作會在主要叫用中加入預設含有網址欄位的 Canvas 回應。
6. 按一下「儲存」。

定義專案資訊

注意： 如要進一步瞭解如何管理專案資訊，請參閱目錄資訊說明文件。

專案的設定和資源會定義專案相關資訊，例如特徵和途徑支援、支援的語言代碼、顯示名稱、說明、標誌等。下表說明您提供的主要設定和資源。Actions on Google 會利用這些資訊來部署專案並發布至 Google 助理目錄。

姓名	說明
目錄資訊	提供資訊，以便 Actions on Google 將專案發布至 Google 助理目錄。包括專案的中繼資料，以及標誌和橫幅圖片的圖片資源。
指定地區	設定可使用動作的語言代碼。
介面功能	設定可用於執行動作的介面。
公司詳細資料	指定貴公司的聯絡資訊。
公司行號驗證	連結您擁有的網站或 Android 應用程式，即可享有您各種額外功能，例如預留的叫用名稱，以及動作內的網站連結。
發布版本	為「測試」和「正式版」設定不同的測試和正式版。
Google 助理連結	允許使用者從網站資源叫用你的動作。

如何定義專案資訊：

在模擬器中測試專案

注意事項： 請參閱動作模擬器說明文件，瞭解測試專案的完整資訊。

Actions 主控台會提供模擬器，方便您預覽動作。模擬工具可讓您查看偵錯資訊、設定裝置功能、模擬語言代碼等等。

圖 3. 模擬工具的主要區域：(1) 使用者輸入內容、(2) 裝置檢視畫面、(3) 選項和設定，以及 (4) 對話記錄。

如要測試專案：