付费套餐功能

以下功能仅可供 Plus 套餐或更高版本的用户使用。 Plus

• 电话集成
• 专用端点
• 搜索
• watsonx Assistant v2 API
• 日志 Webhook

v2 Logs API 随 Plus 套餐免费试用提供。

以下功能仅适用于企业计划的用户。 企业

• 活动跟踪
• 多个环境
• 覆盖响应方式的系统缺省值
• 将事件发送到分段

页面标题中会显示您当前正在使用的服务实例的套餐类型。 您可以从一种套餐类型升级到另一种套餐类型。 有关更多信息，请参阅升级。

基于用户的套餐说明

与基于API的计划（按一个月内API调用次数衡量使用量）不同，Plus和Enterprise计划按每月活跃用户数衡量使用量。

月度活跃用户（MAU）是指在日历计费月内至少与您的助手或定制应用程序进行过一次交互的任何唯一用户。

通过与助手进行交互的人员所关联的用户标识可识别唯一用户。 Web 聊天和其他内置集成会自动为您设置此属性。

您可以自行计算 IBM Cloud 和 IBM Cloud Pak for Data的 MAU。 要计算 MAU，请使用 logs 端点来导出对话。 对于特定月份，计算结果中找到的唯一用户标识数。 每月具有超过 50 条消息 (API 调用) 的用户标识将针对每 50 条消息进行多次计数。 在公共用例中，每个用户标识都表示与助手进行交谈的客户，每个用户的平均消息数通常远少于 50 条消息，因此对用户标识进行多次计数是不寻常的。

使用 REST API 指定用户标识

如果要将定制客户机与 watsonx Assistant API 配合使用，那么必须在客户机发送到 message 方法的消息有效内容中设置 user_id 属性。 user_id 属性在请求主体的根目录中指定，如以下示例中所示:

{
  "input": {
    "message_type": "text",
    "text": "I want to cancel my order"
  },
  "user_id": "my_user_id"
}

在某些较旧的 SDK 版本中，不支持 user_id 属性作为顶级方法参数。 作为替代方法，您可以在嵌套的 context.global.system 对象中指定 user_id。

有关 user_id 属性的更多信息，请参阅API参考文档：

• v2 无状态 /message
• v2 有状态 /message

如果未指定用户标识

如果您正在使用定制客户机应用程序，并且未设置 user_id 值，那么服务会自动将其设置为下列其中一个值:

• session_id v2 ）：v2定义的一个属性，用于识别用户与助手之间的单个对话。 会话标识在内置集成生成的 /message API 调用中提供。 用户关闭聊天窗口时或达到不活动状态时间限制后，会话会结束。

  如果使用无状态 V2 消息 API，那么必须为进行中交谈内的每条消息指定 session_id（在 context.global.session_id 中）。

• conversation_id（仅v1 ）：v1定义的属性，存储在 /message API调用的上下文对象中。 此属性可用于标识与一个用户的单个交谈交流关联的多个 /message API 调用。 但是，仅当显式保留标识并将其随作为同一交谈的一部分发出的每个请求传回时，才会使用相同的标识。 否则，将为每个新的 /message API 调用生成新标识。

如果同一个人在同一个计费周期内三次与您的助理聊天，您在API调用中如何表示该用户会影响交互的计费方式。 如果使用一个 user_id 来标识用户交互，那么会将这三次聊天计为一次使用。 如果您识别出用户与 session_id 的交互，那么它将被视为三次使用，因为每次交互都会创建一个单独的会话。

将任何定制应用程序设计为捕获唯一的 user_id 或 session_id，并将信息传递到 watsonx Assistant。 选择在整个客户生命周期内不会更改的非人工可识别的标识。 例如，不要将个人电子邮件地址用作用户标识。 事实上，user_id 语法必须符合 RFC 7230 中规定的报头字段要求。

内置集成通过以下方式来派生用户标识：

• 对于 Facebook 集成，user_id 属性设置为 Facebook 在其有效内容中提供的发送方标识。
• 对于 Slack 集成，user_id 属性由团队标识（如 T09LVDR7Y）和用户的成员标识（如 W4F8K9JNF）串联组成。 例如，T09LVDR7YW4F8K9JNF。
• 对于 Web 聊天，可以设置 user_id 属性的值。

根据每个服务实例每月的活动用户来管理计费。 如果单个用户与属于同一套餐的不同服务实例所托管的助手进行交互，那么会将每个交互视为单独一次使用。 这将单独根据该用户与每个服务实例的交互进行计费。

处理匿名用户

如果定制应用程序或助手与匿名用户进行交互，那么可以生成随机的通用唯一标识来表示每个匿名用户。 有关UUID的更多信息，请参阅 RFC 4122。

• 对于 Web 聊天，如果在会话开始时没有传递用户标识，那么 Web 聊天会为您创建一个标识。 它会使用生成的匿名标识来创建第一方 cookie。 该 cookie 会保持 45 天有效。 如果同一用户在当月晚些时候返回到您的站点，并再次与助手聊天，那么 Web 聊天集成会识别到该用户。 同一匿名用户在一个月内多次与助手进行交互时，只会向您收取一次费用。

如果匿名用户登录并且稍后被识别为与具有已知标识的提交请求的人员是同一人，那么将向您收取两次费用。 具有唯一用户标识的每条消息都将作为独立活动用户收费。 为避免此情况，您可以在启动交谈之前提示用户登录。 或者，您可以使用匿名用户标识以一致方式表示用户。

数据中心

IBM Cloud 拥有由全球数据中心构成的网络，这为其云服务提供了性能优势。 请参阅 IBM Cloud 全局数据中心 以获取更多详细信息。

可以创建在以下数据中心位置托管的 watsonx Assistant 服务实例：