Google Cloud 專案設定

本頁面說明如何設定 Google Cloud 專案,以整合電話功能。

選取或建立 Google Cloud 專案

SIP 中繼線路只會基於通訊原因連結至專案,但影響範圍不限於特定專案。

舉例來說,您可能有三個不同的專案 (開發、測試、正式環境)。如果所有 SBC 對 GTP 通訊都使用相同的 SIP Trunk,只有第一個建立 SIP Trunk 的要求會成功,其餘在相同區域/主機名稱建立 SIP Trunk 的要求都會失敗。

建議您使用其他專案,專門管理 SIP 中繼線。這樣一來,不同的團隊就能負責中繼線,並在 Trunk UI 中為開發、測試和生產建立不同的 SBC 群組。

如要使用 Google Cloud提供的服務,您必須建立專案。專案可整理您所有的 Google Cloud 資源。專案是由一組協作者、已啟用的 API (和其他資源)、監控工具、帳單資訊,以及驗證和存取權控管組成。您可以建立一個專案,也可以建立多個專案,並使用這些專案在 Google Cloud 資源階層中整理您的資源。建立專案時,請記下專案 ID,因為您需要這個 ID 才能進行 API 呼叫。 如要進一步瞭解專案,請參閱 Resource Manager 說明文件

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

  • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
  • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

權限

  1. 在 Google Cloud 控制台中,依序前往「IAM 與管理」->「身分與存取權管理」
  2. 選取現有服務帳戶或建立新的服務帳戶,並確認已指派 Dialogflow API Admin 角色。如要整合電話服務,必須具備這個角色。

Phone Number API 存取權

使用電話號碼 API 方法需要特殊存取權。詳情請洽詢您的 Google 代表。

設定 Dialogflow、對話設定檔和電話號碼

本節將逐步說明如何建立對話式 AI 對話設定檔,並連結相關聯的 Google Telephony Platform (GTP) 電話號碼。

  1. 前往 Colab Enterprise 如果系統提示,請啟用 Compute EngineDataformVertex API。
  2. 按一下「匯入筆記本」,然後選取「網址」做為資料來源。輸入這個 GitHub 存放區網址,然後按一下「匯入」IMPORT
  3. PROJECT_ID 欄位中,輸入要與整合服務建立關聯的專案 Google Cloud 專案 ID。您可以在 Cloud Console 頁面頂端的下拉式選單中找到現有專案。
  4. REGION 欄位中輸入所選區域。支援所有 Dialogflow 地區
  5. 請保留 JWT 欄位,或在此輸入 JWT 值。如果留空,系統預設會使用單一登入。
  6. 按一下頂端「專案」部分中的播放按鈕,即可執行該部分的程式碼。按照系統提示,允許筆記本存取你的 Google 憑證。
  7. 展開「Configuring Conversational AI for SIP/SIPREC」(為 SIP/SIPREC 設定 Conversational AI) 部分。在「建立虛擬 Dialogflow ES 代理程式...」下方,按一下「顯示程式碼」,然後執行程式碼,不進行任何變更。這會建立虛擬的 Dialogflow ES 代理程式,並將層級設為 Enterprise。如要存取 Dialogflow API 端點,必須有虛擬的 Dialogflow ES 虛擬服務專員。每個 Google Cloud 專案只能有一個 Dialogflow ES 代理程式。
  8. 展開「Script to create a...」(建立...的指令碼)ConversationProfile 部分,即可顯示程式碼。
    • CONVERSATION_PROFILE_NAME:可以是任何字串。你可以使用預設值,也可以自行輸入。
    • SECURITY_SETTINGS:可以是任何字串。你可以使用預設值,也可以自行輸入。
    • PHONE_NUMBER_COUNTRY_CODE:輸入要與 GTP 電話號碼建立關聯的國家/地區代碼。
    • CX_AGENT_NAME:輸入您要將產生的對話設定檔與之建立關聯的 Conversational Agents (Dialogflow CX) 服務專員名稱。
  9. 執行程式碼。輸出內容會包含產生的ConversationProfile名稱、安全性設定和 GTP 電話號碼。
  10. 前往 Dialogflow ES 主控台,確認已建立名為 Dummy_ES_agent 的代理程式。按一下「設定」,確認代理程式已與正確的Google Cloud 專案建立關聯,並已升級至 Essentials 版。
  11. 前往 Agent Assist 控制台。按一下左側選單中的「對話設定檔」,確認系統已建立您輸入 CONVERSATION_PROFILE_NAME 的對話設定檔。
  12. 前往 Conversational AI Insights 控制台。確認與 Conversational Agents (Dialogflow CX) 服務專員相關的所有對話轉錄稿都已匯入。

(選用) 要求提高 Dialogflow CX Phone Gateway 通話時間配額

Dialogflow ES Essentials 和 Conversational Agents (Dialogflow CX) 訂閱方案提供標準可用配額。如果您完全未使用 Dialogflow,例如只使用 Agent Assist、轉錄或通話錄音功能,預設配額與 Dialogflow ES Essentials 方案的配額相同。

如有需要,您可以根據預估流量申請提高配額。在大多數情況下,標準配額足以用於設定和測試,但執行階段應用程式需要提高配額。如要瞭解配額詳情,以及如何要求增加配額,請參閱 Dialogflow 配額頁面

(選用) 啟用 Dialogflow API 的稽核記錄

您可以選擇為 Dialogflow API (dialogflow.googleapis.com) 啟用稽核記錄,記錄管理員讀取、資料讀取和資料寫入作業。這樣一來,您就能查看所有個別的 Conversational AI API 呼叫,以及用於授權和用量的憑證。這項資訊有助於疑難排解和偵錯。

後續步驟

瞭解如何設定及配置 SBC