创建您的第一个代理

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

前提条件

创建代理

本指南将向您介绍如何使用示例应用创建代理。该示例提供了一种快速探索代理功能的方式,并供您作为代理开发的起点。如果您想要修改现有应用以添加代理,请参阅此示例,您的应用逻辑提供了一个很好的模型。

在本快速入门中,您将执行以下操作:

  • 注册为合作伙伴
  • 创建品牌和代理
  • (可选)在与 Business Messages 小助手机器人的对话中探索功能
  • 设置代理以收发消息

如需在不使用示例的情况下创建代理,请参阅创建代理

注册为合作伙伴

  1. 打开 Business Communications 开发者控制台
  2. Business Messages 下方,点击创建合作伙伴帐号
  3. 输入您的合作伙伴信息:

    字段
    您的姓名 您的全名
    合作伙伴名称 您的组织名称
    合作伙伴网站 您的组织网站
    区域 您要托管 Business Messages 服务的区域
  4. 查看并接受 Business Messages 服务条款

  5. 点击创建

您现已注册为 Business Messages 合作伙伴。系统已经为您创建了一个新的 Google Cloud 项目,并启用了 Business Messages 和 Business Communications API。您无权访问此项目,并且该项目不会干扰您现有的任何 Google Cloud 项目。

您现在可以使用 Business Messages API 和 Business Communications API。

创建服务帐号

  1. Business Communications Developer Console 首页上,点击合作伙伴帐号设置
  2. 在左侧导航栏中,点击服务帐号
  3. 点击创建密钥,然后点击创建

    您的浏览器会下载服务帐号密钥。请将其存储在安全的位置。您稍后需要使用此密钥部署 Web 应用,并在将来访问 Business Messages 和 Business Communications API。

创建品牌和代理

代理是品牌的对话表示形式,即用户与用户互动的对话实体。您创建一个代表商家的品牌,并创建代理,以便消费者能够与其对话交流。

  1. 打开 Business Communications Developer Console,然后使用您的 Business Messages Google 帐号登录。
  2. 点击创建代理
  3. 对于代理类型,请选择 Business Messages
  4. 输入品牌名称代理名称的值。
  5. 执行以下任一项操作:
    • 如需体验与代理的对话,您可以在其中探索可用功能,请选择启用 Business Messages 小助手机器人
    • 如需自定义您的代理并使其准备好处理消息,请取消选择启用 Business Messages 小助手机器人
  6. 点击创建代理

如果您启用了 Business Messages 小助手机器人,则可以立即发起对话。否则,请继续设置代理以进行消息处理

使用 Business Messages 小助手机器人探索功能

借助 Business Messages 小助手机器人,您可以快速与代理对话,体验平台提供的功能。启用小助手机器人是可选的,但强烈建议您在创建第一个代理时启用。

借助小助手机器人,您可以

  • 探索丰富功能
  • 了解如何实现功能
  • 查找用于设置代理的资源

启用小助手机器人后,它会为代理发送和接收消息;不需要网络钩子。您需要先停用小助手机器人,然后才能设置网络钩子启用 Dialogflow 来处理用户消息。

与小助手机器人发起对话

启用 Business Messages 小助手机器人后,您可以发起对话。 创建代理后,系统会立即打开一个对话框,以帮助您开始使用。

如需与小助手机器人互动,请在此对话框中执行以下步骤:

  1. 访问该代理的测试网址。您可以通过以下几种方式执行此操作:

    • 点击 Android 按钮或 iOS 按钮。然后,使用相应的移动设备扫描二维码,并点击启动。或者,点击 Copy Android 网址Copy iOS 网址 以复制代理的测试网址。
    • 点击发送,将网址发送到您的电子邮件地址。
  2. 在您的移动设备上打开相应网址。(iOS 设备需要使用 Google 地图应用)。

停用小助手机器人

在自定义代理并为启动做好准备之前,您需要先停用 Business Messages 小助手机器人。

如需停用小助手机器人,

  1. 打开 Business Communications Developer Console
  2. 选择您的代理。
  3. 在左侧导航栏中,点击集成
  4. 帮助程序聊天机器人部分,点击停用

停用小助手机器人后,它将不再收发代理消息。现在,您可以设置代理以处理消息传递流程。

设置代理以进行消息处理

在本指南中,您将使用一个用于处理用户消息的网络钩子将 Echo 聊天机器人部署到 Google Cloud Platform (GCP)。

Echo Bot 是一个示例应用,可将消息回显给用户。它可让您在与代理的对话中尝试使用丰富的功能,例如建议操作复合搜索卡。您也可以使用 Echo 聊天机器人作为开发代理的起点。

请完成以下步骤:

  • 将 Echo Bot 示例部署到 GCP
  • 为 Business Messages 合作伙伴帐号配置网络钩子网址
  • 提供有关代理的基本信息

在本指南结束时,您的代理将可以收发消息。

将 Web 应用部署到 GCP

Business Messages 会将用户的消息转发到基础架构中的网络钩子。在本指南中,您需要将 Echo Bot 示例源代码部署到预配置的网络钩子。如果您已经有可以利用的 Web 基础架构来接收消息,则可以在该 Web 服务上创建新的 Webhook,但您需要自行配置逻辑。如需了解详情,请参阅设置合作伙伴级网络钩子

创建 Cloud 环境

您需要一个云环境来部署 Echo Bot 示例。

如需创建 GCP 项目作为云环境,请按以下步骤操作:

  1. 打开 Google Cloud Console 项目选择器

    如果您从未创建过 Google Cloud 项目,则需要接受条款和服务

  2. 点击创建项目

  3. 为新项目输入名称和位置

    • 系统会自动生成您的项目 ID,并将其显示在项目名称下方。
    • 位置字段中,点击浏览以显示项目的潜在位置。如果您找不到自己的 Google Workspace 单位,则表明您未登录 Google Workspace 帐号。您可以在没有组织的情况下创建项目,但部分功能会受到限制。如需了解详情,请参阅组织资源的优势
  4. 点击创建

  5. 点击菜单

  6. 点击结算

  7. 点击关联结算帐号

  8. 创建新的结算帐号,或将现有的结算帐号添加到项目中。如需了解付款方式,请参阅 Google Cloud 免费计划功能

部署 Echo Bot 示例

  1. 安装 gcloud CLI。您将使用此代码将示例代码部署到 Google Cloud。
  2. 下载并提取 Echo Bot 示例(Node.jsJavaPython)。

  3. 将您在创建服务帐号中下载的 JSON 凭据文件复制到示例的资源文件夹中,然后将凭据重命名为“bm-agent-service-account-credentials.json”。此凭据文件的路径取决于您下载的示例。

    Node.js

    ./bm-nodejs-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json
    

    Java

    ./bm-java-echo-bot/full_sample/src/main/resources/bm-agent-service-account-credentials.json
    

    Python

    ./bm-python-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json
    
  4. 在终端中,导航到示例的 full_sample 目录。

  5. 在终端中运行以下命令以部署示例:

    Node.js

    gcloud config set project PROJECT_ID
    gcloud app create
    gcloud app deploy
    

    PROJECT_ID 是您在创建 Cloud 环境中创建的项目的 ID。项目 ID 列在 Google Cloud 的项目信息中心内。

    Java

    gcloud config set project PROJECT_ID
    gcloud app create
    mvn appengine:deploy
    

    PROJECT_ID 是您在创建 Cloud 环境中创建的项目的 ID。项目 ID 列在 Google Cloud 的项目信息中心内。

    Python

    gcloud config set project PROJECT_ID
    gcloud app create
    gcloud app deploy
    

    PROJECT_ID 是您在创建 Cloud 环境中创建的项目的 ID。项目 ID 列在 Google Cloud 的项目信息中心内。

  6. 请记下上一个命令输出的内容中已部署应用的网址。以下是您的网络钩子网址的基础:

    Deployed service [default] to [https://PROJECT_ID.appspot.com]

设置网络钩子

由于 Echo 聊天机器人已部署,您需要指定您操纵的网络钩子网址,以开始接收消息

  1. 在 Business Communications Developer Console 中打开帐号设置
  2. 确保选择了正确的合作伙伴帐号。
  3. 对于 Business Messages 网络钩子网址,点击配置
  4. Webhook 端点网址部分,输入应用的网址 + "/callback”。

    您的端点将采用“https://PROJECT_ID.appspot.com/callback”的格式。

    此端点在您部署到 GCP 的示例的应用逻辑中是预定义的。

  5. 在开发者控制台中,点击验证

    Business Messages 验证您的 webhook 后,对话框将关闭。

如需使用 Business Communications API 配置网络钩子,请参阅示例:更新网络钩子网址

您可以使用 Business Messages 测试框架来测试您的网络钩子是否成功响应 Business Messages 载荷。

输入代理信息

提供一些基本信息以完成代理设置。

  1. 打开 Business Communications Developer Console
  2. 在左侧导航栏中,点击代理信息
  3. 您可以随意更新这些值,或使用以下建议:

    字段
    欢迎辞 欢迎使用 Echo Bot 对话!
    隐私权政策 https://policies.google.com/privacy
  4. 点击保存

开始对话

如需与 Echo 聊天机器人互动,请按以下步骤操作:

  1. 打开 Business Communications Developer Console
  2. 在左侧导航栏中,点击代理信息
  3. 代理测试网址下,点击 Android 按钮或 iOS 按钮。
  4. 使用相应的移动设备扫描二维码,或点击复制 Android 网址 (Copy Android 网址) 或复制 iOS 网址 (Copy iOS 网址) 来复制代理的测试网址。

    您也可以点击发送,将网址发送到您的电子邮件地址。

  5. 在您的移动设备上打开相应网址。(iOS 设备需要使用 Google 地图应用)。

客服人员的欢迎信息会问候您。此时,您可以与 Echo 聊天机器人互动。并回显您发送给自己的消息。此外,您还可以通过发送特定字符串(“轮播”、“卡片”、“条状标签”)来调用丰富功能。

后续步骤

现在,您已经创建了第一个代理,接下来不妨详细了解 Business Messages,以及您可以在平台上执行哪些其他操作。