Ezviz Restaurant Inspection (萤石餐厅巡检)

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

快速开始

安装依赖

bash
pip install requests

设置环境变量

bash

必需参数

export EZVIZAPPKEY=yourappkey
export EZVIZAPPSECRET=yourappsecret
export EZVIZDEVICESERIAL=dev1,dev2,dev3

可选参数

export EZVIZCHANNELNO=1 # 通道号，默认 1

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

运行

bash
python3 {baseDir}/scripts/restaurant_inspection.py

命令行参数：
bash

单个设备

python3 {baseDir}/scripts/restaurantinspection.py appKey appSecret dev1 [channelno]

多个设备（逗号分隔）

python3 {baseDir}/scripts/restaurantinspection.py appKey appSecret dev1,dev2,dev3 [channelno]

工作流程

1. 1. 获取 Token (appKey + appSecret → accessToken)

↓

1. 2. 智能体管理 (检测是否存在餐厅智能体 → 不存在则创建)

↓

1. 3. 设备抓图 (accessToken + deviceSerial → picUrl)

↓

1. 4. AI 分析 (agentId + picUrl → 分析结果)

↓

1. 5. 输出结果 (JSON + 控制台)

智能体自动管理说明

你不需要手动配置 EZVIZAGENTID！

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

每次运行:
查询用户智能体列表 (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
======================================================================

多设备格式

格式	示例	说明
单设备	dev1	默认通道 1
多设备

dev1,dev2,dev3 | 全部使用默认通道 | | 指定通道 | dev1:1,dev2:2 | 每个设备独立通道 | | 混合 | dev1,dev2:2,dev3 | 部分指定通道 |

API 接口

接口	URL	文档
获取 Token	POST /api/lapp/token/get	https://open.ys7.com/help/81
设备抓图

POST /api/lapp/device/capture | https://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/anaylsis | https://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/appSecret

open.ys7.com (萤石) | 获取访问 Token | ✅ 必需 |
| 设备序列号 | open.ys7.com (萤石) | 请求抓图 | ✅ 必需 |
| 智能体 ID | aidialoggw.ys7.com (萤石) | AI 分析请求 | ✅ 必需 |
| EZVIZACCESSTOKEN | 自动生成 | 每次运行自动获取 | ✅ 自动 |
| 智能体操作 | 萤石内部接口 | 智能体检测/创建 | ✅ 自动 |

数据流出说明:

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

凭证权限建议:

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

本地处理:

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

应用场景

场景	说明
🍽️ 食品安全巡检	自动检测食品存储、加工过程合规性
🧼 卫生状况监控

识别清洁状态、垃圾处理、消毒情况 | | 👨‍🍳 员工规范检查 |