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 文档

在 Google Cloud 控制台的项目选择器页面上, 选择或创建 Google Cloud 项目。

选择或创建项目所需的角色

  • 选择项目:选择项目不需要特定的 IAM 角色,您可以选择已获授角色的任何项目。
  • 创建项目:如需创建项目,您需要 Project Creator 角色 (roles/resourcemanager.projectCreator),该角色包含 resourcemanager.projects.create 权限。了解如何授予 角色

转到“项目选择器”

权限

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

电话号码 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 控制台页面顶部的下拉菜单中找到现有项目。
  4. REGION 字段中输入您选择的区域。系统支持所有 Dialogflow 区域
  5. 您可以保留 JWT 字段不变,也可以在此处输入您的 JWT 值。如果留空,则默认使用单点登录。
  6. 点击顶部项目 部分中的播放按钮,以运行该部分的代码。系统提示时,请允许笔记本访问您的 Google 凭据。
  7. 展开 为 SIP/SIPREC 配置对话式 AI 部分。在 Create a dummy Dialogflow ES agent...下,点击显示代码,然后运行 代码,无需进行任何更改。这会创建一个虚拟 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:输入您希望生成的对话配置文件与之关联的 Dialogflow CX 代理的名称。
  9. 运行此代码。输出将包括生成的 ConversationProfile 的名称、安全设置和 GTP 手机号码。
  10. 前往 Dialogflow ES 控制台 ,验证是否已创建名为 Dummy_ES_agent 的代理。点击 设置 ,验证该代理是否与正确的 Google Cloud 项目关联,以及是否已升级到 Essentials 版。
  11. 前往 Agent Assist 控制台。 点击左侧菜单中的对话配置文件 ,验证是否已创建具有您输入的 CONVERSATION_PROFILE_NAME 的对话配置文件。
  12. 前往 对话式 AI Insights 控制台。验证与 Dialogflow CX 代理关联的所有对话记录是否都已导入。

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

Dialogflow ES Essentials 和 Dialogflow CX 订阅附带标准可用配额。如果您完全不使用 Dialogflow,例如仅使用 Agent Assist、转录或通话录制,则您的默认配额与 Dialogflow ES Essentials 配额相同。

您可以根据预计的流量选择申请增加配额。在大多数用例中,标准配额足以进行设置和测试,但运行时应用需要增加配额。如需了解配额详情以及申请增加配额的说明,请参阅 Dialogflow 配额页面

(可选)为 Dialogflow API 启用审核日志记录

您可以选择为 Dialogflow API (dialogflow.googleapis.com) 启用审核日志记录,以记录管理员读取、数据读取和 数据写入操作。这样,您就可以查看所有单独的对话式 AI API 调用以及用于授权和使用的凭据。这对于问题排查和调试非常有用。

后续步骤

了解如何设置和配置 SBC