结构化返回
检查 `answer`、`steps`、`warnings`、`sources`、`learningImpact` 是否完整。
What To Verify
控制台主要用来验证三件事
先在网页里验证链路，再接入宿主系统，可以明显减少实施期的联调成本。权限上下文
通过 token 和 route 模拟不同用户，验证回答不会越过宿主权限边界。
学习闭环
对返回结果提交有用 / 无用反馈，确认排序分数和记忆链路正常写回。
多端模式
修改 `mode` 为 `mini-program`、`mobile-app`、`embedded-agent`，验证统一协议是否稳定。
多模态链路
直接发送语音、截图、文档的模拟资产，验证统一 `multimodal` 接口是否能编排成最终 query。
Suggested Path
建议的测试顺序
先测 query，再测 feedback，然后去知识台和运营台看链路是否完整，不要只停在一次接口返回。1. 跑 Query
先确认 `traceId`、`memoryId`、`steps`、`warnings` 和 `sources` 是否稳定返回。
2. 提交 Feedback
验证这次问答是否能回流到学习闭环，而不只是一次性输出。
3. 去知识台
确认相关知识资产是否存在，知识结构是否足够支撑当前模块。
4. 去运营台
查看任务、命中影响和审计事件，确认产品不是只有一个聊天接口。
Interactive API
直接试调用
输入 token 和请求体，直接调用公网部署中的真实接口，并可对返回结果提交反馈。Query Resultno result
null
Feedback Result/api/ziin/feedback
null
你现在可以怎么测
- 先直接发送默认 payload，检查是否返回 `traceId`、`memoryId`、`steps`、`warnings`。
- 再点“发送多模态 Demo”，验证 `audio/image -> multimodal -> query` 链路是否返回识别结果与结构化答案。
- 再点“标记有用 / 无用”，验证学习闭环接口是否写回成功。
- 修改 `mode` 为 `mini-program` 或 `mobile-app`，验证多端模式是否正常响应。
- 修改 `inputs`，模拟文本、错误弹窗、图片说明等多模态输入组合。
- 如果站点切到商用门禁模式，额外填写 `Commercial API Key` 再测试。
Multimodal Result/api/ziin/multimodal
null
商用多模态接入方式
- 默认 `mock` 提供方可直接本地和测试环境跑通，适合联调。
- 配置 `ZIIN_MULTIMODAL_PROVIDER=openai-compatible` 后，可接商用 OCR / ASR / 文档理解兼容网关。
- 宿主系统只需要把音频、截图、文档转成 base64 后发到统一接口，不必自己编排多个服务。
- 统一返回 `recognizedInputs`、`synthesizedQuery` 和最终 `queryResult`，方便宿主审计与复核。