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