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 存在绑定关系,传入的值与实际不一致。请替换为提示中的对应的内容。