跳转到主要内容
一个问题由智能体用 ask 提出,包含选项,之后还会包含答案。
  • 等待上限。 ask 和 wait_for_reply 占用一次调用的时间绝不超过 50 秒,因为有些客户端会在 60 秒时切断调用。
  • 幂等的 ask。 如果 4 分钟内存在智能体、问题和选项都相同的未决或已答复的问题,ask 会返回那个问题,不会重复发送任何内容。客户端会自行重复调用。
  • 答案绑定到问题。 答案属于它的 question_id。只要问题仍被保留,用该 id 调用 wait_for_reply 每次都会返回答案,所以客户端放弃的调用不会丢失任何东西。
  • 选项 id。 按钮和列表的 id 包含问题和选项序号,所以即使同时有多个未决问题,回复也能精确对应到那个问题。
  • 限制。 按钮标题最多 20 个字符,列表行最多 24 个,一个问题最多 10 个选项。出错时会指明违反规则的字段。