本指南提供開始使用 Dialogflow 的所有必要設定步驟。此外，也提供試用或測試 Dialogflow 後，可能需要執行的清理步驟建議。
事前準備
閱讀本指南之前，請先完成下列工作：
- 請參閱「Dialogflow ES 基本知識」。
- 參閱版本一文。
Google Cloud 控制台簡介
Google Cloud 控制台 (查看說明文件、開啟控制台) 是網頁 UI，可用於佈建、設定、管理及監控使用 Google Cloud 產品的系統。您可以使用 Google Cloud 控制台設定及管理 Dialogflow CX 資源。
建立專案
如要使用 Google Cloud提供的服務，必須建立專案。專案可整理您所有 Google Cloud 資源。專案是由一組協作者、已啟用的 API (和其他資源)、監控工具、帳單資訊，以及驗證和存取控管組成。您可以建立一個專案，也可以建立多個專案，並使用這些專案在資源階層中整理您的 Google Cloud 資源。建立專案時，請記下專案 ID，因為您需要這個 ID 才能進行 API 呼叫。如要進一步瞭解專案，請參閱「Resource Manager 說明文件」。
建立代理時，Dialogflow ES 控制台 (查看說明文件、開啟控制台) 可視需要為您建立基本專案。如果您不只要使用專案來存取免付費版本，或打算使用 API，請按照下方說明，使用 Google Cloud 控制台建立專案。
建議您建立不同的專案，以用於實驗、測試和實際工作環境。每個專案只能建立一個 Dialogflow 代理程式。如需多個代理，則必須建立多個專案。
在 Google Cloud 控制台的專案選取器頁面中，選取或建立 Google Cloud 專案。
選取或建立專案所需的角色
- 選取專案：選取專案時不需要特定 IAM 角色，只要您獲派某個專案的角色，即可選取該專案。
-
建立專案：如要建立專案，您必須具備專案建立者角色 (
roles/resourcemanager.projectCreator)，其中包含resourcemanager.projects.create權限。瞭解如何授予角色。
啟用計費功能
帳單帳戶可用來定義特定資源組合費用的支付者，其可連結至一或多個專案。專案的使用費會從相連結的帳單帳戶中扣除。在大多數情況下，您會在建立專案時設定帳單。詳情請參閱「帳單說明文件」。
啟用 API
您必須為專案啟用 Dialogflow API。如要進一步瞭解如何啟用 API，請參閱「服務使用情形說明文件」。
啟用 Dialogflow API (如果尚未啟用)。
啟用 API 所需的角色
您必須具備 serviceusage.services.enable 權限，才能啟用 API。如果您建立了專案，可能已透過「擁有者」角色 (roles/owner) 取得這項權限。否則，您可以透過「Service Usage 管理員」角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。
啟用稽核記錄
在專案中啟用 Dialogflow API 的資料存取稽核記錄。這有助於追蹤連結至這項專案的 Dialogflow 代理在設計階段的變更。
安裝並初始化 Google Cloud CLI
如要使用 Dialogflow API，請務必安裝並初始化 Google Cloud CLI。gcloud CLI 是一套工具，可用來管理託管於 Google Cloud的資源和應用程式。
請參閱下列連結中的操作說明：
安裝 Google Cloud CLI。 安裝完成後，請執行下列指令，初始化 Google Cloud CLI：
gcloud init若您採用的是外部識別資訊提供者 (IdP)，請先 使用聯合身分登入 gcloud CLI。
設定驗證和存取控管機制
如果您打算使用 Dialogflow API，必須設定驗證方法。任何使用該 API 的用戶端應用程式都必須經過驗證，並獲得所要求資源的存取權。本節說明重要的驗證概念，並提供設定步驟。詳情請參閱Google Cloud 驗證總覽。
使用使用者帳戶驗證
學習 Dialogflow API 和進行本機開發時，使用者帳戶是最佳驗證選項。您可以使用使用者帳戶，驗證 REST 指令列執行作業或用戶端程式庫呼叫。
REST 指令列使用者帳戶驗證
如要驗證 REST 指令列呼叫，請使用 gcloud CLI。gcloud auth login 指令會使用您的使用者帳戶登入 gcloud，請務必在呼叫 API 前完成這項操作。本說明文件中的 REST 指令列範例會使用 gcloud auth print-access-token 指令，驗證 REST 呼叫。
如要為本機環境建立使用者憑證，請按照下列步驟操作：
gcloud auth login
用戶端程式庫使用者帳戶驗證
如要驗證用戶端程式庫呼叫，請使用 gcloud CLI。gcloud auth application-default login 指令會使用您的使用者帳戶，將您登入 gcloud 以取得應用程式預設憑證，這項操作應在呼叫 API 之前完成。您必須使用 gcloud auth application-default set-quota-project 指令，設定專案的 API 呼叫相關帳單和配額。一般來說，這會是代理使用的專案，您需要提供在上述步驟中建立的專案 ID。
請勿設定 GOOGLE_APPLICATION_CREDENTIALS 環境變數，用戶端程式庫才能使用應用程式預設憑證。
如要為本機環境建立應用程式預設憑證，請按照下列步驟操作：
gcloud auth application-default login gcloud auth application-default set-quota-project PROJECT_ID
使用服務帳戶進行驗證
服務帳戶會為應用程式 (而非使用者) 提供憑證。服務帳戶由專案擁有，您可以為專案建立多個服務帳戶。詳情請參閱：
使用角色控管存取權
當主體 (使用者帳戶、服務帳戶等) 呼叫 API 時， Google Cloud 會要求主體具備適當的權限。您可以將角色授予主體，藉此授予權限。詳情請參閱角色總覽。
如果您是使用使用者帳戶建立專案，則使用者帳戶會具備專案的擁有者基本角色。這個角色可呼叫專案的任何 API。不過，如果專案是由其他帳戶建立，您可能需要先為使用者帳戶授予角色，才能呼叫 API。如需操作說明，請參閱 Dialogflow CX 存取控管指南。
安裝 Dialogflow 用戶端程式庫
呼叫 API 的方式有三種：Google 支援的用戶端程式庫、REST 和 gRPC。
我們提供多種常見語言的用戶端程式庫。如需安裝操作說明，請參閱用戶端程式庫中的所需語言。
清除所用資源
設定並試用或測試 Dialogflow CX 後，您可能需要刪除建立的資源：
- 您可能需要刪除代理。
- 建議您關閉專案。
-
如果您呼叫
gcloud auth login，系統會將憑證儲存在電腦的使用者目錄中。建議您呼叫下列指令來刪除這些憑證：gcloud auth revoke
-
如果您呼叫
gcloud auth application-default login，系統會將憑證儲存在電腦的使用者目錄中。建議您呼叫下列指令來刪除這些憑證：gcloud auth application-default revoke