Starter Kit

宿主接入包不是附件合集,而是最小联调入口

这页给研发和实施团队。目标不是继续讲概念,而是直接下载最小示例代码,把 Ziin 接进宿主系统、微信小程序、App 容器或第三方智能体。

使用建议

不要一次性全拿,先按宿主形态选一个入口

  • 先选一个最贴近当前宿主形态的示例。
  • 先跑通最小 query,再补 feedback、sync 和媒体能力。
  • 示例代码应该拿来联调,不是只做演示截图。
  • 优先使用公网正式域名,不再引用旧 IP 或旧路径。

Starter Pack

可直接下载的最小示例

每个接入包都对准一种典型接法,避免客户拿着接口文档自己猜怎么落代码。
Starter Kit

Web 最小嵌入包

适合宿主 Web 页面或 H5 页面快速验证 query 调用。

Starter Kit

Node 服务端接入包

适合 BFF、网关或宿主服务端直接代理调用 Ziin,包含 query、feedback 和 ASR。

Starter Kit

Media / ASR 接入包

适合需要图片、语音、文件上传与异步任务轮询的宿主系统。

Starter Kit

微信小程序接入包

适合小程序页面或业务助手入口直接接入。

Starter Kit

宿主智能体接入包

适合宿主已有 AI、客服机器人或对话引擎,先在浏览器里看清结构化返回和上下文输入。

Starter Kit

宿主 Adapter 接法

适合宿主后端、BFF 或已有智能体,把公共上下文沉到 adapter defaults 里。

Starter Kit

接入包说明

说明每个示例适合什么场景,以及统一的公网接口地址。

How To Choose

不同宿主该拿哪一个包

不要一次性全拿。先按你的宿主形态选一个入口,跑通后再补其他端。

Web / H5 / 内嵌页面

优先拿 Web 最小嵌入包,用浏览器环境直接调用 query,适合前台助手、右侧面板和浮层入口。

BFF / 网关 / 宿主服务端

优先拿 Node 服务端接入包,由宿主后端代理调用 Ziin,更适合权限上下文收敛在服务端的系统。

小程序和移动端容器

优先拿小程序接入包,再按同一协议扩展到 App。核心不是 UI 差异,而是统一传 mode、context 和 inputs。

宿主已有自己的 AI

优先拿宿主智能体接入包,把 Ziin 当成软件操作专家工具,而不是重新造一套对话层。