Alexa Skill Developers 基于参考的目录管理 API

Question

This doc 说“使用基于引用的目录管理 API，您可以创建引用外部数据源的自定义插槽类型以获取插槽类型值。此 API 允许您创建和维护插槽类型的目录价值观与您的 Alexa 技能无关。”

但是，当您深入研究它时，它并没有提供有关如何在 s3 等端点上实际设置目录的一些必要细节。

虽然 this resource 在此 similar question 中作为答案提供，但它实际上指的是内容目录（如音乐播放列表），而不是基于参考的目录管理 API，所以我认为这是错误的，它不是适用的。

因此，对于基于参考的目录管理 API：文档说它需要采用 JSON 格式，并提供 ingredients.json 作为示例。但是我直接使用了它，但它失败了（见下文）。此外，它没有描述包含同义词的格式应该是什么。请描述一下。

我可以使用 '/v1/skills/api/custom/interactionModel/catalogs/' 成功创建目录并获得一个 catalogId 作为回报。但是，通过“/skills/api/custom/interactionModel/catalogs/{catalogId}/versions”创建目录版本失败。当我发出 POST 时，我得到“网站暂时不可用”。

这是我在该帖子中包含的请求正文结构：

data: {

  "source": {

      "type": "URL",

      "url": "https://s3.amazonaws.com/..../ingredients.json"

  },

  "description": "test S3 bucket"

}

另外，S3 端点是否必须公开？两种方法我都试过了，好像没什么。如果它必须是公开的，你是如何处理安全性的？

感谢您的帮助。

Answer 1

虽然 API 调用失败，但我确实使用 CLI 方法让它工作。

ask api create-model-catalog-version -c {catalogID} -f {filename}

文件应为 JSON 格式，结构如下：

{
  "type": "URL",
  "url": "[your catalog url]"
}

如何让 API 方法发挥作用仍然是一个悬而未决的问题，因此欢迎任何答案。也许这是一个错误，因为我在 API 调用的数据结构中指定了与 CLI 命令使用的 JSON 文件中完全相同的“源”定义。

这是我在使用 CLI 时学到的知识：

是的，必须公开 S3 端点才能使 create-model-catalog-version 作业成功。我觉得这是一个问题，希望看到围绕这些端点封装一些安全性的能力。

这里是您想要使用的 JSON 格式，包括在官方 Amazon example 中未描述的同义词的使用。请注意，您不必包含该示例中所示的 ID。

{                
  "values": [
      {
          "name": {
              "value": "hair salon",
              "synonyms": [
                  "hairdresser",
                  "beauty parlor"
              ]
          }
      },
      {
          "name": {
              "value": "hospital",
              "synonyms": [
                  "emergency room",
                  "clinic"
              ]
          }
      },
  ]
}