Google Cloud 專案設定

本文說明設定Google Cloud 專案以整合電話服務所需的步驟。

選取或建立 Google Cloud 專案

SIP Trunk 僅基於通訊目的連結至專案,但其影響不限於特定專案。

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

您可以使用其他專案,專門管理 SIP Trunk。這樣一來,其他團隊就能管理中繼,您也可以在中繼 UI 中,建立不同的 SBC 群組,用於開發、測試和正式環境。

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

在 Google Cloud 控制台的專案選取器頁面中,選取或建立 Google Cloud 專案。

選取或建立專案所需的角色

  • 選取專案:選取專案時不需要特定 IAM 角色,只要您獲派某個專案的角色,即可選取該專案。
  • 建立專案:如要建立專案,您必須具備專案建立者角色 (roles/resourcemanager.projectCreator),其中包含 resourcemanager.projects.create 權限。瞭解如何授予角色。

前往專案選取器

權限

  1. 在 Google Cloud 控制台,依序前往「IAM & Admin」(IAM 與管理) >「IAM」。
  2. 選取現有服務帳戶或建立新的服務帳戶,並指派 Dialogflow API Admin 角色。必須具備這個角色,才能整合電話服務。

電話號碼 API 存取權

您必須具備特殊存取權,才能使用電話號碼 API 方法。詳情請洽詢 Google 代表。

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

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

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

(選用) 申請提高 Dialogflow CX Phone Gateway 通話時間長度配額

Dialogflow ES Essentials 和 Dialogflow CX 訂閱方案隨附標準可用配額。如果您完全不使用 Dialogflow,例如只使用 Agent Assist、轉錄或通話錄音,預設配額會與 Dialogflow ES Essentials 配額相同。

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

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

如要為 Dialogflow API (dialogflow.googleapis.com) 啟用稽核記錄,以便記錄管理員讀取、資料讀取和資料寫入作業,請使用這項功能查看所有個別對話式 AI API 呼叫,以及用於授權和用量的憑證。這可讓您更有效地排解及偵錯問題。

後續步驟