AI检索应用接入手册

输入“/”快速插入内容

AI检索应用接入手册

用户2684

4月14日修改

目标：完成AI检索能力开通，并在 App 中支持“自然语言搜索历史事件”的最小闭环。​

1. 这份文档适合谁

适合下面这类开发者：

•
你在做 App 后端、开放平台或设备接入​

•
你需要给用户提供“用自然语言搜索历史事件”的能力​

•
你希望先跑通能力开通、设备前置和搜索接口联调​

2. 接入后能完成什么

完成接入后，你的系统可以：

1.
完成 APP ID 申请与AI检索能力开通​

2.
让设备持续提供可检索的事件数据​

3.
在 App 中发起首次搜索和“查看更多”​

4.
直接展示 AI 摘要与事件列表​

3. 接入前需要准备什么

3.1 申请 APP ID

客户需先完成 APP ID 申请。APP ID 是后续设备、服务端及 App 集成的唯一身份标识。申请完成后，请妥善保存并用于后续配置。​

申请流程参见：申请接入

3.2 确认设备侧前提

请确保目标设备具备以下基础能力：

•
图片和视频数据的采集能力​

•
本地事件检测能力，例如 PIR、声音、人形检测等​

通过集成设备 SDK，可将视觉硬件接入平台，完成设备配网、管理和音视频分发等基础能力接入。​

详细开发流程请参阅：设备端开发

3.3 申请开通AI检索能力

如需开通，请发送邮件至 openapi@tange.ai，并提供以下资料：

信息

说明

申请事项

AI检索应用开通申请

app_id

用于唯一标识开发者应用身份

公司名称

联系人

联系人姓名

联系人电话

补充信息

建议补充目标设备类型、预计联调时间、测试环境信息

平台将在 1-3 个工作日内完成审核。审核通过后，探鸽团队会基于 APP ID 在管理后台开通AI检索能力，并通过邮件同步结果。​

3.4 联调前确认信息

联调前建议向平台方确认你已经拿到：

•
服务地址和环境信息​

•
ai_app_id​

•
至少 1 个可用的 device_id​

•
用户真实时区，例如 Asia/Shanghai​

•
当前接入方式所需的鉴权信息​

如果你接的是客户端开放接口，常见请求头包括：

•
X-Tg-App-Id​

•
X-Tg-Platform​

•
X-Tg-Sdk-Version​

•
X-Tg-Date​

•
Accept-Language​

•
Authorization​

其中 Authorization 应传用户登录态 access_token，不要传服务端签名。​

4. 你应该调用哪些接口

AI检索应用接入手册​