设置：

1. 首先，我们将在 Actions on Google 的 开发者控制台 上创建一个项目，然后使用 API.AI 在该项目中设置 Action。

2. 完成上述步骤后，将打开 API.AI 控制台，在那里为刚刚创建的项目创建一个代理。

3. 现在我们已经有了一个代理。为了在 Google 上创建 SUSI Action，我们需要在 API.AI 左侧菜单中定义一个“意图”。但由于我们需要从 SUSI API 获取响应，因此必须先设置 Webhook。

4. 在左侧菜单中找到“履行”选项，将其打开并输入 URL。我们需要将前面编写的代码部署到 Heroku 上，但在那之前，先创建一个 GitHub 仓库，并将我们之前创建的文件夹中的文件推送到该仓库。

   在命令行中，将当前目录切换到我们之前创建的文件夹，然后执行以下命令：

   git init
   git add .
   git commit -m "initial"
   git remote add origin <远程仓库URL>
   git remote -v
   git push -u origin master
   

   您可以通过在 GitHub 上创建一个仓库并复制其链接来获取远程仓库的 URL。

5. 现在我们需要将这个 GitHub 仓库部署到 Heroku，以获得 URL。

   如果您还没有 Heroku 账户，请在此处注册：https://www.heroku.com/；否则直接登录并创建一个新的应用。

通过部署选项将您的仓库部署到 Heroku，并选择 GitHub 作为部署方式。

选择自动部署，这样当您对 GitHub 仓库进行任何更改时，这些更改都会自动部署到 Heroku。

6. 从右上角的选项中打开您的应用，复制 Heroku 应用的链接，并在其末尾添加 /webhook，然后将此 URL 输入到履行 URL 中。

   https://{Your_App_Name}.herokuapp.com/webhook
   

7. 设置好 Webhook 后，我们将在 API.AI 上创建一个意图，该意图将接收用户向 SUSI 提出的问题。要创建意图，从左侧菜单中选择“意图”，按照下方截图中的信息创建意图，并保存。

8. 创建完意图后，您的代理就准备好了。接下来只需将代理与 Actions on Google 集成即可。在左侧菜单的“集成”选项中启用集成功能。

9. 现在您的 SUSI Action 已经可以在 Google 助手上使用了。要测试它，请在集成菜单中点击 Actions on Google，然后选择“测试”选项。

10. 您只能使用第 7 步中用于创建项目的同一邮箱进行测试。要在 Google 助手中测试，请观看此演示视频：https://youtu.be/wHwsZOCKaYY

susi_gassistantbot 快速上手指南

本指南帮助开发者将 SUSI AI 集成到 Google Assistant，创建一个智能语音助手动作（Action）。

环境准备

在开始之前，请确保你拥有以下账号和环境：

• Google 账号：用于访问 Actions on Google 控制台 和 API.AI (Dialogflow)。
• GitHub 账号：用于托管代码仓库。
• Heroku 账号：用于部署后端服务（注册地址）。
  • 注意：由于网络原因，访问 Heroku 和 Google 相关服务可能需要配置科学上网环境。目前暂无官方推荐的国内镜像源。
• 本地环境：已安装 git 命令行工具。

安装与部署步骤

1. 创建 Google Action 项目

1. 登录 Actions on Google 控制台 创建一个新项目。
2. 在项目设置中选择使用 API.AI (现称为 Dialogflow) 来构建动作。
3. 系统将自动跳转至 API.AI 控制台，为该项目创建一个对应的 Agent（代理）。

2. 配置 Webhook 前置准备

为了接收 SUSI API 的响应，我们需要先部署后端代码以获取 Webhook URL。

1. 在本地初始化 git 仓库并推送代码到 GitHub：

   git init
   git add .
   git commit -m "initial"
   git remote add origin <你的 GitHub 仓库 URL>
   git remote -v
   git push -u origin master
   

   请将 <你的 GitHub 仓库 URL> 替换为你在 GitHub 上创建的实际仓库地址。

3. 部署到 Heroku

1. 登录 Heroku 并创建一个新的 App。
2. 进入 Deploy 选项卡，选择 GitHub 作为部署来源。
3. 连接你的 GitHub 账号并搜索刚才创建的仓库。
4. 选择 Automatic deployments（自动部署），确保后续代码更新能同步到 Heroku。
5. 等待部署完成后，点击顶部右上角的 Open app，复制生成的应用链接（例如：https://your-app-name.herokuapp.com）。
6. 在该链接后追加 /webhook，得到完整的 Webhook 地址：

   https://your-app-name.herokuapp.com/webhook
   

4. 配置 API.AI 代理

1. 回到 API.AI 控制台，在左侧菜单选择 Fulfillment。
2. 启用 Webhook 开关，并将上一步生成的完整 URL 填入 URL 字段。
3. 在左侧菜单选择 Intents，创建一个新的 Intent。
   • 参考原项目文档中的截图配置意图名称和训练语句。
   • 确保该 Intent 开启了 Fulfillment 选项，以便调用 SUSI API。
   • 保存 Intent。

5. 集成与测试

1. 在 API.AI 左侧菜单选择 Integrations。
2. 点击 Actions on Google 并开启集成。
3. 点击 Test 按钮进入测试界面。
4. 重要提示：只能使用创建该项目时相同的 Google 邮箱账号进行测试。
5. 按照测试界面的指引，或在真机上通过 Google Assistant 唤醒你的应用进行对话测试。
   • 演示视频参考：https://youtu.be/wHwsZOCKaYY

基本使用

完成上述步骤后，你的 SUSI Google Assistant 动作即可投入使用。

• 触发方式：在支持 Google Assistant 的设备上说 "Ok Google, talk to [你的应用名称]"。
• 交互示例：
  • 用户："What is the weather in Beijing?"
  • 助手：(通过 SUSI API 返回北京天气信息)

此时，用户的请求将通过 Google Assistant 转发至你部署在 Heroku 的 Webhook，再由后端调用 SUSI API 处理并返回结果。