設定和清除

本指南提供開始使用 CX Agent Studio 的所有必要設定步驟。此外，在您試用或測試代理程式後，也會提供可能的清理步驟建議。

關於 Google Cloud 控制台

Google Cloud 控制台 (參閱說明文件、開啟控制台) 是網頁 UI，可用於佈建、設定、管理及監控使用 Google Cloud 產品的系統。 您可以使用 Google Cloud 控制台設定及管理 CX Agent Studio 資源。

建立專案

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

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

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

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

前往專案選取器

啟用計費功能

帳單帳戶可用來定義特定資源組合費用的支付者，其可連結至一或多個專案。專案的使用費會從相連結的帳單帳戶中扣除。在大多數情況下，您會在建立專案時設定帳單。詳情請參閱「帳單說明文件」。

確認 Google Cloud 專案已啟用計費功能。

啟用 API

您必須為專案啟用 Gemini Enterprise for Customer Experience API。如要進一步瞭解如何啟用 API，請參閱「服務使用情形說明文件」。

啟用 Gemini Enterprise for Customer Experience API (如果尚未啟用)。

啟用 API 時所需的角色

如要啟用 API，您必須具備 serviceusage.services.enable 權限。如果您建立了專案，可能已透過「擁有者」角色 (roles/owner) 取得這項權限。否則，您可以透過「服務使用管理員」角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

啟用 API

啟用稽核記錄

在專案中啟用 Gemini Enterprise for Customer Experience API 的資料存取稽核記錄。除了「版本」，稽核記錄也有助於追蹤與專案相關聯的 CX Agent Studio 代理程式應用程式設計階段變更。

安裝並初始化 Google Cloud CLI

如果您打算使用 Gemini Enterprise for Customer Experience API，請安裝並初始化 Google Cloud CLI。gcloud CLI 是一套工具，可用來管理託管於 Google Cloud的資源和應用程式。

如需操作說明，請參閱下列連結：

安裝 Google Cloud CLI。 完成後，執行下列指令來初始化 Google Cloud CLI：

gcloud init

如果您使用外部識別資訊提供者 (IdP)，請先 使用聯合身分登入 gcloud CLI。

設定驗證和存取控管

如果您打算使用 Gemini Enterprise for Customer Experience API，必須設定驗證方法。任何使用該 API 的用戶端應用程式都必須經過驗證，並獲得所要求資源的存取權。本節說明重要的驗證概念，並提供設定步驟。詳情請參閱Google Cloud 驗證總覽。

使用使用者帳戶進行驗證

學習 Gemini Enterprise for Customer Experience 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。

安裝 CX Agent Studio Agents 用戶端程式庫

如需程式庫下載和安裝說明，請參閱「用戶端程式庫」。

清除所用資源

設定並試用或測試 CX Agent Studio 後，您可能想刪除建立的資源：

  • 建議您關閉專案。
  • 如果您呼叫 gcloud auth login，這會將憑證儲存在電腦上的使用者目錄中。您可能想透過呼叫以下項目刪除這些憑證： 
    gcloud auth revoke
  • 如果您呼叫 gcloud auth application-default login，這會將憑證儲存在電腦上的使用者目錄中。您可能想透過呼叫以下項目刪除這些憑證： 
    gcloud auth application-default revoke