本文档介绍了为电话集成配置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权限。了解如何授予角色。
权限
- 在 Google Cloud 控制台中,前往 IAM 和管理 > IAM。
- 选择现有服务账号或创建新服务账号,并为其分配
Dialogflow API Admin角色。电话集成需要此角色。
电话号码 API 访问权限
使用手机号码 API 方法需要特殊访问权限。如需了解详情,请与您的 Google 代表联系。
配置 Dialogflow、对话配置文件和手机号码
本部分介绍了如何创建具有关联的 Google Telephony Platform (GTP) 手机号码的对话式 AI 对话配置文件。
- 前往 Colab Enterprise。如果系统提示,请启用 Compute Engine、Dataform 和 Vertex API。
- 选择导入笔记本,然后选择网址作为数据源。 输入 GitHub 代码库网址,然后选择导入。
- 在
PROJECT_ID字段中,输入要与集成关联的项目的 Google Cloud 项目 ID。在 Google Cloud 控制台页面顶部的菜单中找到现有项目。 - 在
REGION字段中输入您选择的区域。支持所有 Dialogflow 区域。 - 您可以将
JWT字段留空,也可以在此处输入JWT值。如果留空,则默认使用单点登录。 - 点击顶部项目部分中的播放按钮,运行该部分的代码。出现提示时,允许笔记本访问您的 Google 凭证。
- 展开为 SIP/SIPREC 配置对话式 AI 部分。在创建虚拟 Dialogflow ES 代理…下,点击显示代码,然后运行代码,无需进行任何更改。这会创建一个虚拟 Dialogflow ES 代理,并将其层级设置为企业版。需要一个虚拟 Dialogflow ES 代理才能访问 Dialogflow API 端点。每个 Google Cloud 项目只能有一个 Dialogflow ES 代理。
- 展开以显示用于创建
ConversationProfile… 的脚本部分下的代码。CONVERSATION_PROFILE_NAME:可以是任何字符串。您可以使用默认值,也可以输入自己的值。SECURITY_SETTINGS:可以是任意字符串。您可以使用默认值,也可以输入自己的值。PHONE_NUMBER_COUNTRY_CODE:输入您要与 GTP 手机号码关联的国家/地区代码。CX_AGENT_NAME:输入您希望生成的对话配置文件与之关联的 Dialogflow CX 代理的名称。
- 运行此代码。输出将包含生成的
ConversationProfile的名称、安全设置和 GTP 手机号码。 - 前往 Dialogflow ES 控制台,验证是否已创建名为
Dummy_ES_agent的代理。点击设置,验证代理是否与正确的Google Cloud 项目相关联,以及是否已升级到 Essentials 版本。 - 前往 Agent Assist 控制台。
点击导航菜单中的对话配置文件,验证是否已创建具有您输入的
CONVERSATION_PROFILE_NAME的对话配置文件。 - 前往对话式 AI 数据分析控制台。 验证是否已导入与 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。