创建您的第一个代理

前提条件

创建代理

本指南将向您逐步介绍如何使用示例应用创建代理。该示例提供了一种探索代理功能的快速方法，可作为开发代理的着手点。如果您想要修改现有应用以添加代理，该示例可为您的应用逻辑提供一个良好的模型。

在本快速入门中，您将执行以下操作：

  • 注册为合作伙伴
  • 创建品牌和代理
  • （可选）在与 Business Messages 进行对话时探索功能 小助手机器人
  • 设置代理以发送和接收消息

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

注册为合作伙伴

  1. 打开 Business Communications 开发者控制台。
  2. 在 Business Messages 下方，点击创建合作伙伴账号。

  3. 输入您的合作伙伴信息：

    字段 值
    您的姓名 您的全名
    合作伙伴名称 您的组织名称
    合作伙伴网站 您的组织网站
    区域 您要托管 Business Messages 服务的区域

  4. 查看并接受 Business Messages 服务条款。

  5. 点击创建。

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

现在，您可以访问 Business Messages API 和 Business Communications API。

创建服务账号

  1. 在 Business Communications 开发者控制台首页，点击合作伙伴账号设置。
  2. 在左侧导航栏中，点击 服务账号。

  3. 点击创建密钥，然后点击创建。

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

创建品牌和代理

代理是品牌的对话表示形式 — 对话实体 以及用户互动您创建了一个品牌来代表该企业 创建代理，以便消费者可以通过对话方式与其联系。

  1. 打开 Business Communications Developer（商业通信开发者） 控制台 并使用您的 Business Messages Google 账号登录。
  2. 点击创建代理。
  3. 对于代理类型，请选择 Business Messages。
  4. 输入品牌名称和代理名称的值。
  5. 执行以下某项操作：
    • 如需体验与代理的对话，您可以在其中探索 请选择启用 Business Messages 小助手机器人。
    • 如需自定义您的代理并使其准备好处理消息，请取消选择启用 Business Messages 小助手机器人。
  6. 点击创建代理。

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

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

借助 Business Messages 小助手机器人，您可以快速发起与 以便您体验该平台提供的各项功能。启用帮助程序 聊天机器人是可选的，但强烈建议您在创建第一个代理时使用。

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

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

启用小助手机器人后，它会为您的代理收发消息； 不需要 webhook。您需要停用小助手机器人 然后才能设置网络钩子或启用 Dialogflow 处理用户消息。

与小助手机器人对话

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

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

  1. 访问代理的测试网址。为此，您可以采用以下几种方法：

    • 点击 Android 按钮或 iOS 按钮。然后扫描二维码 与相应移动设备相关联，然后点击启动。 或者，点击复制 Android 网址或复制 iOS 网址进行复制 代理的测试网址。
    • 点击发送，将网址发送到您的电子邮件地址。

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

停用小助手机器人

在自定义代理并使其做好发布准备之前，您需要： 停用 Business Messages 小助手机器人。

如需停用小助手机器人，请执行以下操作：

  1. 打开 Business Communications Developer（商业通信开发者） 控制台。
  2. 选择您的代理。
  3. 在左侧导航栏中，点击集成。
  4. 对于小助手机器人，请点击停用。

停用小助手机器人后，它就不会再针对 您的代理。现在，您可以设置代理来处理 消息流。

设置代理以进行消息处理

在本指南中，您将向 Google Cloud Platform (GCP) 部署一个 Echo 聊天机器人， 旨在处理用户消息的 webhook。

Echo Bot 是一个示例应用，可将消息回显给用户。它 您可以尝试使用各种功能，例如 建议的操作 和 复合搜索卡 与代理对话。你也可以使用 Echo Bot 作为 是开发代理的关键。

您将完成以下步骤：

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

在本指南结束时，您的代理将已准备好发送和接收消息。

将 Web 应用部署到 GCP

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

创建 Cloud 环境

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

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

  1. 打开 Google Cloud 控制台项目选择器。

    如果您从未创建过 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.js、 Java、 Python）。

  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 是您在其中创建的项目的 ID 创建 Cloud 环境。Google Cloud 的项目信息中心内会列出项目 ID。

    Java

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

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

    Python

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

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

  6. 记下最后一个命令的输出中已部署应用的网址。 这是您的网络钩子网址的基础：

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

设置网络钩子

在部署完 Echo Bot 后，您需要指定一个网络钩子网址（ 操作）启动 接收消息。

  1. 打开 账号设置 在 Business Communications 开发者控制台中完成。
  2. 请确保选择了正确的合作伙伴账号。
  3. 在 Business Messages 网络钩子网址部分，点击配置。

  4. 对于网络钩子端点网址，输入应用的网址 +“/callback”。

    您的端点将采用以下格式： "https://PROJECT_ID.appspot.com/callback".

    此端点在您之前发布的示例的应用逻辑中预定义 部署到 GCP

  5. 在 Developer Console 中，点击验证。

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

如需使用 Business Communications API 配置您的网络钩子，请参阅 示例：更新网络钩子网址。

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

输入代理信息

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

  1. 打开 Business Communications Developer（商业通信开发者） 控制台。
  2. 在左侧导航栏中，点击代理信息。

  3. 您可以视需要更新这些值，或采用以下建议：

    字段 值
    欢迎辞 欢迎与 Echo Bot 对话！
    隐私权政策 https://policies.google.com/privacy

  4. 点击保存。

发起对话

如要与 Echo Bot 互动，请按以下步骤操作：

  1. 打开 Business Communications Developer（商业通信开发者） 控制台。
  2. 在左侧导航栏中，点击代理信息。
  3. 在代理测试网址下，点击 Android 按钮或 iOS 按钮。

  4. 使用相应的移动设备扫描二维码，或点击复制 Android 网址或复制 iOS 网址以复制代理的测试网址。

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

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

代理的欢迎辞会向您致以问候。此时，您可以 Echo Bot。它会回显您发回的消息。此外，您还可以 通过发送特定字符串来调用丰富的功能：“轮播”“卡片”“条状标签”。

后续步骤

现在您已经创建了第一个代理，接下来可以详细了解 Business Messages 以及您还可以在此平台上做些什么。