在 DSH 生态中,处理视觉数据往往需要对接专门的推理服务。下面介绍一个专注于火焰识别的插件,它通过调用小笨羊的 API 接口,为智能体提供火焰检测能力。
插件定位¶
该插件由 xby-skill 维护,属于模型推理类别。它的核心功能是在各类通用场景中检测火焰,最佳适用对象是安防摄像头和交通摄像头的视角。
核心功能¶
插件提供了四个核心接口,分别处理不同的输入数据格式:
- set_xby_apikey:在对话中设置 API 密钥。该设置会自动持久化,重启进程后依然有效。
- fire_detection:检测火焰。需要输入图片文件链接。
- fire_detection_for_data_base64:检测火焰。需要输入图片文件的 BASE64 编码。
- fire_detection_for_data_file:检测火焰。需要输入图片文件的文件路径。
安装与启用¶
使用官方安装命令添加插件:
dsh plugin --profile web add github:xby_skill/xby-fire-detection
安装完成后,插件即可在对话上下文中使用。
典型用法¶
使用前需完成以下步骤:
- 使用前需前往小笨羊官网注册并获取 API 密钥。
- 在对话中使用
set_xby_apikey命令设置密钥。 - 根据图片的存储形式,调用对应的检测函数:
- 链接方式:调用fire_detection,传入图片的 URL。
- Base64 方式:调用fire_detection_for_data_base64,传入 Base64 字符串。
- 本地文件:调用fire_detection_for_data_file,传入文件路径。
适用场景与注意¶
- 适用场景:安防监控、交通路口监控等需要实时或离线火焰检测的场景。
- 注意:插件依赖外部 API,必须自行获取密钥。由于插件以当前 dsh 进程权限运行,安装前建议检查源码与许可证(MIT)。
通过上述步骤,可以在 DSH 流程中直接集成火焰检测能力。更多细节可查阅插件目录或 GitHub 仓库。