Google Cloud 项目设置

本页介绍了为电话集成配置 Google Cloud 项目所需的步骤。

选择或创建 Google Cloud 项目

SIP 中继线仅出于通信原因连接到项目,但其影响并不限于特定项目。

例如,您可能有三个不同的项目(开发、测试、生产)。如果所有 SBC 到 GTP 通信都使用同一 SIP 中继,则只有创建 SIP 中继的第一个请求会成功,而同一区域/主机名中创建 SIP 中继的其余请求都会失败。

我们建议您使用另一个项目专门用于管理 SIP 中继。 这样,不同的团队就可以负责不同的中继,并且在“中继”界面中,他们可以为开发、测试和生产建立不同的 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.

Go to project selector

权限

  1. 在 Google Cloud 控制台中,前往 IAM 和管理 -> IAM
  2. 选择现有服务账号或创建新的服务账号,并确保该账号已获分配 Dialogflow API Admin 角色。电话集成需要此角色。

Phone number API 访问权限

使用手机号码 API 方法需要特殊访问权限。如需了解更多信息,请与您的 Google 代表联系。

配置 Dialogflow、对话配置文件和手机号码

本部分将引导您完成以下流程:创建具有关联的 Google Telephony Platform (GTP) 手机号码的对话式 AI 对话配置文件

  1. 前往 Colab Enterprise 如果系统提示,请启用 Compute EngineDataformVertex API。
  2. 点击导入笔记本,然后选择网址作为数据源。输入此 GitHub 代码库网址,然后点击 IMPORT
  3. PROJECT_ID 字段中,输入您要与集成相关联的项目的 Google Cloud 项目 ID。您可以在 Cloud 控制台页面顶部的下拉菜单中找到现有项目。
  4. REGION 字段中输入您选择的区域。支持所有 Dialogflow 区域
  5. 您可以将 JWT 字段保留原样,也可以在此处输入 JWT 值。如果留空,则默认使用 SSO。
  6. 点击顶部项目部分中的“播放”按钮,运行该部分代码。当系统提示时,允许笔记本访问您的 Google 凭据。
  7. 展开为 SIP/SIPREC 配置对话式 AI 部分。在创建虚拟 Dialogflow ES 代理...下,点击显示代码,然后运行代码,无需进行任何更改。此命令会创建一个虚拟 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:输入您希望生成的对话配置文件关联的 Conversational Agents (Dialogflow CX) 代理的名称。
  9. 运行此代码。输出将包含生成的 ConversationProfile 的名称、安全设置和 GTP 手机号码。
  10. 前往 Dialogflow ES 控制台,验证是否已创建名为 Dummy_ES_agent 的代理。点击设置,验证代理是否与正确的Google Cloud 项目相关联,以及是否已升级到基础版
  11. 前往 Agent Assist 控制台。 点击左侧菜单中的对话配置文件,验证是否已创建包含您输入的 CONVERSATION_PROFILE_NAME 的对话配置文件。
  12. 前往 Conversational AI Insights 控制台。 验证与您的 Conversational Agents (Dialogflow CX) 代理相关的所有对话记录是否都已导入。

(可选)申请增加 Dialogflow CX 电话网关通话时长的配额

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