Live Console

在线调用控制台

这是公开可试的产品控制台。留空 Key 时走官网演示通道，填入商用 Key 时验证真实 `query` 和 `feedback` 对外接口，方便同时测试试玩链路和正式门禁。

看接入规范看学习闭环

What To Verify

控制台主要用来验证三件事

先在网页里验证链路，再接入宿主系统，可以明显减少实施期的联调成本。

结构化返回

检查 `answer`、`steps`、`warnings`、`sources`、`learningImpact` 是否完整。

权限上下文

通过 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

直接试调用

不要让访客自己拼一大段 JSON。先点一个高频场景，再看结构化结果、后续动作和学习闭环是否真的跑通。
当前问题为什么入库单提交失败？

模块：inventory

当前页面入库管理

/inventory/inbound/create

当前菜单仓储中心 / 入库管理

角色：warehouse_clerk

可执行动作4 项

navigate / focus_field / scroll_to / open_dialog

负反馈原因
仍未解决
结构化结果摘要尚未返回
还没有返回结果

先点一个场景模板，再发送 Query。你应该重点看 answer、steps、warnings 和 action plans 是否像操作助手，而不是像帮助文档。

Query Raw JSONno result
null
Feedback + 联调建议等待反馈
反馈结果尚未提交

先返回一个结果，再点“标记有用 / 无用”。

当前应该看什么不是只看 answer
  • 入口题要看是否直接回答“在哪”。
  • 卡点题要看是否直接指出权限、字段或主数据问题。
  • 操作题要看 steps 是否短，是否真能执行。
null
Multimodal Summary尚未调用
还没有多模态结果

点“发送多模态 Demo”后，这里会先显示 provider、识别输入数量，再展示最终 queryResult 是否像同一条使用助手链路。

Multimodal Raw JSON/api/ziin/multimodal
null

你现在可以怎么测

  • 先点“订单管理在哪里”，看回答是否直接给入口，而不是讲一段总览说明。
  • 再点“为什么保存不了”，看它能不能同时指出权限、字段和主数据问题。
  • 再点“标记有用 / 无用”，确认结果会回流到学习闭环，而不是一次性输出。
  • 最后再发多模态 Demo，确认语音 / 图片最终进入的是同一条 query 能力链。

商用多模态接入方式

  • 现在直接走真实媒体网关：原始文件上传后进入 OCR / ASR 任务，不再走 mock 识别。
  • 图片默认走 `local-ocr`，官网助手语音走 `omnimodal realtime`，任务型语音转写仍可走本机 `faster-whisper`。
  • 宿主系统仍可只发 base64 到统一接口，但服务端内部会自动转成真实上传、解析和轮询流程。
  • 统一返回 `recognizedInputs`、`synthesizedQuery` 和最终 `queryResult`，同时保留 fileId / taskId，方便审计与复核。