Recommender API - 上传使用事件

Question

这个 API 的文档在功能方面有点难以理解。 https://westus.dev.cognitive.microsoft.com/docs/services/Recommendations.V4.0/operations/577d91f77270320f24da2592

将使用事件上传到模型。如果 buildId 设置为“-1”，则事件 针对模型的 Active Build 摄取。设置 buildId 为 设置为 null 或 0，则针对 Active 构建摄取事件，如果 活动构建不存在，事件不与任何关联 构建。

“根据模型的 Active Build 摄取”

• 这是什么意思？
• 将事件与构建相关联时会发生什么？

我一直在使用上传使用事件 API 发送事件，但在“数据统计”选项卡上的活动构建中没有看到任何变化。

任何帮助理解这一点将不胜感激。

---

我正在构建一个批处理来发送新的使用事件，现在我的方法是：

1. 上传新的使用文件
2. 删除旧使用文件
3. 创建新版本
4. 更改活动构建
5. 删除旧版本

我希望其他仅用于发送用户事件的 API 能够正常工作，但由于我无法使其按预期工作，因此我改用了这种方法。

这是一个好方法还是应该以不同的方式做到这一点？

Answer 1

上传使用文件是比上传使用事件更好的方法。

原因：

1. 您可以将事件作为一个文件发送，从而减少您的 api 使用次数
2. 您可以随时查看并更正您的使用文件，以防出现问题。我没有看到用于查看/编辑/删除上传事件的 api 命令
3. 您可以重复使用您的使用文件来重新创建模型，以防当前文件出现问题

这是我自己在午夜的过程：

1. 根据今天的事件上传新的使用文件
2. 创建新版本
3. 更新我的系统以使用新的内部版本号（因为我在同一型号中有不同的内部版本类型）

为什么是这个过程？

显然，无论如何，我们都需要创建一个新的构建，以便考虑新的使用数据。

根据另一个帖子（由有关该主题的权威回答）

在updloading a usage event 之后，您需要在 使用事件的模型被视为 推荐请求。

您可以查看整个帖子here

此外，如链接帖子中所述，如果实时/频繁地进行一些使用事件可能不足以更改建议，从而浪费精力。因此，使用使用文件并每天执行一次的批处理是更实用的方法。