Ezviz Restaurant Inspection (萤石餐厅巡检)

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

快速开始

安装依赖

pip install requests

设置环境变量

# 必需参数
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 并管理智能体。

运行

python3 {baseDir}/scripts/restaurant_inspection.py

命令行参数：

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

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

工作流程

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

智能体自动管理说明

你不需要手动配置 EZVIZ_AGENT_ID！

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

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

智能体管理特性:

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

输出示例

======================================================================
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
======================================================================

多设备格式

API 接口

网络端点

格式代码

返回字段:

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

凭证权限建议:

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

本地处理:

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

应用场景