不要一次性全拿,先按宿主形态选一个入口
- 先选一个最贴近当前宿主形态的示例。
- 先跑通最小 query,再补 feedback、sync 和媒体能力。
- 示例代码应该拿来联调,不是只做演示截图。
- 优先使用公网正式域名,不再引用旧 IP 或旧路径。
Starter Pack
适合宿主 Web 页面或 H5 页面快速验证 query 调用。
适合 BFF、网关或宿主服务端直接代理调用 Ziin,包含 query、feedback 和 ASR。
适合需要图片、语音、文件上传与异步任务轮询的宿主系统。
适合小程序页面或业务助手入口直接接入。
适合宿主已有 AI、客服机器人或对话引擎,先在浏览器里看清结构化返回和上下文输入。
适合宿主后端、BFF 或已有智能体,把公共上下文沉到 adapter defaults 里。
说明每个示例适合什么场景,以及统一的公网接口地址。
How To Choose
优先拿 Web 最小嵌入包,用浏览器环境直接调用 query,适合前台助手、右侧面板和浮层入口。
优先拿 Node 服务端接入包,由宿主后端代理调用 Ziin,更适合权限上下文收敛在服务端的系统。
优先拿小程序接入包,再按同一协议扩展到 App。核心不是 UI 差异,而是统一传 mode、context 和 inputs。
优先拿宿主智能体接入包,把 Ziin 当成软件操作专家工具,而不是重新造一套对话层。