阅读路线与示例使用方法
先选目标,再完成一个最小闭环;按文件位置使用同一接入包的示例。
按目标开始
| 目标 | 先读什么 | 本轮完成的结果 |
|---|---|---|
| 在网站或 App 中接待 | 自建渠道 → 对应客户端快速接入 | 真实客户发出一条消息,接待台找到同一会话和回复 |
| 集成语音互动 | 对应客户端 → 语音边界 → 官方平台原文 | 实际收音、AI 出声、可打断、挂断与后台清理分别确认 |
| 业务系统调用接口 | 服务端认证 → capabilities → 接口参考 | 当前密钥确有目标操作权限,用当前字段完成一次授权调用 |
| 连接外部 AI 助手 | AI 工具接入 → 企业连接核对 → 对应任务 | 客户端确认实际企业和最小权限,再按具体任务检查执行结果 |
打开对应路线
使用代码示例的顺序
- 先看“使用位置”和“运行前”,从同一下载包复制对应文件并保留相对目录。不要把模块文件当作浏览器控制台命令。
- 替换自己的公开入口参数;服务端密钥只设置在服务端环境。示例里的占位值不对应真实可用资源。
- 先执行只读检查,再由用户点击打开接待或语音。看到代码或复制成功,不代表连接、录音或业务已完成。
- 核对“预期结果”,再做拒绝权限、网络未知、重复提交、账号切换与关闭清理。较长完整文件可展开或从接入包中阅读。
如何确认示例是当前版本
本指南的全部代码块来自接入包中的源码文件,或现有只读预检命令;在线页面与离线手册使用同一份生成结果。修改示例源码后须重新生成并检查,不能只改页面里的一段代码。
接口参考的五种语言示例继续由当前开放操作和请求契约生成;只有请求骨架时必须先补齐真实业务字段。原生工程编译、真机媒体和真实业务调用的验收边界分别保留。
实现依据 · 仓库内路径
scripts/developer-guide-examples.mjslib/developer-docs/developer-guide-examples.json
文档描述当前源码能力;不等于你的宿主或生产环境已通过验收。