Ezviz Restaurant Inspection (萤石餐厅巡检)#

通过萤石设备抓图 + 智能体分析接口，实现对餐厅场景的 AI 自动巡检。

快速开始#

安装依赖#

bash

pip install requests

设置环境变量#

bash

# 必需参数
export EZVIZ_APP_KEY="your_app_key"
export EZVIZ_APP_SECRET="your_app_secret"
export EZVIZ_DEVICE_SERIAL="dev1,dev2,dev3"

# 可选参数
export EZVIZ_CHANNEL_NO="1" # 通道号，默认 1

注意: 不需要设置 EZVIZ_ACCESS_TOKEN 或 EZVIZ_AGENT_ID！技能会自动获取 Token 并管理智能体。

运行#

bash

python3 {baseDir}/scripts/restaurant_inspection.py

命令行参数：

bash

# 单个设备
python3 {baseDir}/scripts/restaurant_inspection.py appKey appSecret dev1 [channel_no]

# 多个设备（逗号分隔）
python3 {baseDir}/scripts/restaurant_inspection.py appKey appSecret "dev1,dev2,dev3" [channel_no]

工作流程#

text

1. 获取 Token (appKey + appSecret → accessToken)
 ↓
2. 智能体管理 (检测是否存在餐厅智能体 → 不存在则创建)
 ↓
3. 设备抓图 (accessToken + deviceSerial → picUrl)
 ↓
4. AI 分析 (agentId + picUrl → 分析结果)
 ↓
5. 输出结果 (JSON + 控制台)

智能体自动管理说明#

你不需要手动配置 EZVIZ_AGENT_ID！

技能会自动处理智能体的检测与创建：

text

每次运行:
 查询用户智能体列表 (appType=1)
 ↓
 检查是否存在名称包含"餐厅"或"餐饮"的智能体
 ↓
 如果存在 → 使用第一个匹配的智能体 appId
 如果不存在 → 从模板复制创建新智能体
   - templateId: f4c255b2929e463d86e9 (餐厅行业通用模板)
   - 返回新智能体的 appId

智能体管理特性:

• ✅ 自动检测: 自动查找现有餐厅智能体
• ✅ 防重复创建: 避免为同一用户重复创建相同智能体
• ✅ 模板复制: 自动从标准模板创建专用智能体
• ✅ 无缝集成: 用户无需手动管理智能体
• ⚠️ 注意: 每次运行都会检查智能体状态

输出示例#

text

======================================================================
Ezviz Restaurant Inspection Skill (萤石餐厅巡检)
======================================================================
[Time] 2026-03-16 22:35:00
[INFO] Target devices: 2
 - dev1 (Channel: 1)
 - dev2 (Channel: 1)

======================================================================
[Step 1] Getting access token...
[SUCCESS] Token obtained, expires: 2026-03-23 22:35:00

======================================================================
[Step 2] Managing intelligent agent...
[INFO] Found existing restaurant agent: appId_12345
[SUCCESS] Using existing agent: appId_12345

======================================================================
[Step 3] Capturing and analyzing images...
======================================================================

[Device] dev1 (Channel: 1)
[SUCCESS] Image captured: https://opencapture.ys7.com/...
[SUCCESS] Analysis completed!

[Analysis Result]
{
 "食品安全": "合格",
 "卫生状况": "良好",
 "人员着装": "规范",
 "违规行为": "未发现"
}

======================================================================
INSPECTION SUMMARY
======================================================================
 Total devices: 2
 Success: 2
 Failed: 0
 Agent ID: appId_12345
======================================================================

多设备格式#

格式示例说明单设备dev1默认通道 1多设备dev1,dev2,dev3全部使用默认通道指定通道dev1:1,dev2:2每个设备独立通道混合dev1,dev2:2,dev3部分指定通道

API 接口#

接口URL文档获取 TokenPOST /api/lapp/token/gethttps://open.ys7.com/help/81设备抓图POST /api/lapp/device/capturehttps://open.ys7.com/help/687智能体列表GET /api/service/open/intelligent/agent/app/list内部接口智能体复制POST /api/service/open/intelligent/agent/template/copy内部接口AI 分析POST /api/service/open/intelligent/agent/engine/agent/anaylsishttps://open.ys7.com/help/5006

网络端点#

域名用途open.ys7.com萤石开放平台 API（Token、抓图）aidialoggw.ys7.com萤石 AI 智能体分析接口

格式代码#

返回字段:

• analysis - AI 分析结果（依赖智能体配置）
• pic_url - 抓拍图片 URL（有效期 2 小时）

错误码:

• 200 - 操作成功
• 400 - 参数错误
• 500 - 服务异常
• 10002 - accessToken 过期
• 10028 - 频率限制触发

Tips#

• 多设备: 逗号分隔 dev1,dev2,dev3
• 指定通道: 冒号分隔 dev1:1,dev2:2
• Token 有效期: 7 天（每次运行自动获取）
• 图片有效期: 2 小时
• 频率限制: 设备间自动间隔 4 秒
• 分析超时: 默认 60 秒
• 智能体模板: 固定模板ID f4c255b2929e463d86e9

注意事项#

⚠️ 频率限制: 萤石抓图接口建议间隔 4 秒以上，频繁调用可能触发限流（错误码 10028）

⚠️ 智能体配额: 每个用户可能有智能体创建数量限制，请确保配额充足

⚠️ Token 安全: Token 仅在内存中使用，不写入日志，不发送到非萤石端点

⚠️ 分析超时: AI 分析可能耗时较长，默认超时 60 秒

数据流出说明#

本技能会向第三方服务发送数据：

数据类型发送到用途是否必需摄像头抓拍图片open.ys7.com (萤石)AI 智能体分析✅ 必需appKey/appSecretopen.ys7.com (萤石)获取访问 Token✅ 必需设备序列号open.ys7.com (萤石)请求抓图✅ 必需智能体 IDaidialoggw.ys7.com (萤石)AI 分析请求✅ 必需EZVIZ_ACCESS_TOKEN自动生成每次运行自动获取****✅ 自动智能体操作萤石内部接口智能体检测/创建✅ 自动

数据流出说明:

• ✅ 萤石开放平台 ( open.ys7.com): Token 请求、设备抓图 - 萤石官方 API
• ✅ 萤石 AI 智能体 ( aidialoggw.ys7.com): 图片分析 - 萤石官方 API
• ✅ 萤石内部接口: 智能体管理 - 萤石内部服务
• ❌ 无其他第三方: 不会发送数据到其他服务

凭证权限建议:

• 使用 最小权限 的 appKey/appSecret
• 仅开通必要的 API 权限（设备抓图、AI 分析、智能体管理）
• 定期轮换凭证
• 不要使用主账号凭证

本地处理:

• ✅ Token 在内存中使用，不写入磁盘
• ✅ 不记录完整 API 响应
• ✅ 图片 URL 只显示前 50 字符
• ✅ 不跨运行缓存 Token（每次运行重新获取）
• ✅ 智能体操作仅在必要时执行

应用场景#

场景说明🍽️ 食品安全巡检自动检测食品存储、加工过程合规性🧼 卫生状况监控识别清洁状态、垃圾处理、消毒情况👨‍🍳 员工规范检查检查工作服、口罩、手套佩戴情况📋 合规性审计自动生成巡检报告，满足监管要求🏢 连锁店管理多门店统一标准，远程集中监控