百宝箱开放平台关于API的常见问题解答

137 阅读2分钟

1. 获取会话 ID(conversationId)

会话 ID 用于在多轮的对话中,保持连贯的上下文,相同 conversationId 共享一份历史对话数据等信息。目前仅支持从调用结果中获取,从输出中找到type=header的消息,然后提取 sessionId作为后续对话的会话 ID。后续也可以通过创建会话的接口获取会话 ID。

{
    "entity": {
        "node_type": "output",
        "execute_id": "3",
        "node_name": "结束_1",
        "node_id": "output_zttttx"
    },
    "lane": "output_zttttx_text_1",
    "payload": "{"extraParams":{},"mediaType":"text","requestId":"6acb2c69-48e8-4f0c-94df-1e22197d8ea7","sessionId":"20250724Ha0V36385917"}",
    "type": "header"
}

2. 接口提示:“未检测到授权令牌,请参考百宝箱 SDK 接入文档完成授权令牌的申请和配置”

在使用百宝箱 OpenAPI 时,在 HTTP Header 中必须传入 Authorization 参数。获取方式请参见:授权管理

3. 接口提示:“授权令牌无效,请校验是否输入了有效令牌或配置新令牌”

传入的令牌不正确,请确认后重试。

4. 接口提示:“授权令牌已失效,请前往百宝箱开放平台申请新令牌并更新到调用配置中”

令牌被删除或被关闭,请根据授权管理指引,前往授权管理页确认令牌状态。

5. 接口提示:“UserId 不能为空,请检查调用参数。”

调用百宝箱OpenAPI时,userId 为必填字段,请传入后重试。

6. 接口提示:“应用访问受阻,当前授权令牌无权限访问该应用。”

个人令牌按租户空间维度生效,请确认填入的令牌 token 与应用所在空间是否匹配。

7. 接口提示:“当前传入的conversationId:xx 记录对应的appId:xx 与传入值的appId值:xx 不一致”

多轮对话 id 与 appid 存在绑定关系,需将 appid 参数值替换为提示中对应的 appid 后重试。

8. 接口提示:“ConversationId 无效,请确认是否按照 SDK 指引正确传入。”

根据对话的类型可以分为两种情况:

  • 新开对话,无需传入 ConversationId。
  • 多轮对话,需传入接口嗲用返回的 ConversationId。

9. 接口提示:“当前传入的requestId:xx 记录对应的appId:xx 与传入值的appId值:xx 不一致”

requestId 与 appid 存在绑定关系,传入的值与实际不一致。请替换为提示中的对应的内容。