海南设施蔬菜 · AgentScope 对话式智能管控

基于 AgentScope 2.0 的
儋州智慧大棚智能体

面向儋州两院试验基地(109.500768, 19.495765),对话式管家「棚小智」覆盖 农情感知 → Skills 农事 SOP → 知识库检索 → 场景联动 → 混合控制。支持 MCP 扩展、管理后台配置,以及 Fire Trace 对 Token / Tools / Skills / 知识库的用量可视。

框架 AgentScope 2.0 能力包 Skills + Skill 工具 知识库 向量检索 扩展 MCP 场景 38℃ 高温联动 观测 Fire Trace 数据 JSON 模拟 IoT
01 · Architecture

项目分层架构

对话页、管理后台与 Fire Trace 共用同一 Agent / 模拟数据层;确定性联动走场景规则,开放问答由 ReAct + Toolkit(Tools / Skills / MCP / 知识库)完成。

02 · Core Flow

核心流程

从用户一句话到设备下发:先匹配 Skill 与工具,再查真数据、评估阈值;白名单场景可自动执行,其余需确认。

03 · Capability Map

平台能力全景

业务侧对齐大棚六大模块;Agent 侧补齐 Skills、知识库、MCP 与可观测调试,构成完整演示闭环。

🏞️ 园区与农情

概况、室外/棚内/土壤实时与历史曲线;对话与后台均可查询、模拟尖峰。

🎛️ 调控联动

9 类设备 + 场景规则;白名单可自动,普通调控需确认,强制顶喷/顶窗互锁。

🚨 预警与日志

环境/设备预警流转,场景与单设备下发全程写入控制日志。

🧩 Agent Skills

巡检、高温、水肥、高湿、防台、补光等 SOP;模型经 Skill 工具加载后再按清单调工具。

📚 向量知识库

农艺口径与规程检索(search_knowledge);后台可维护文档并重建索引。

🔌 MCP 扩展

管理后台配置 MCP Server,工具以 mcp__* 注入 Toolkit,与本地工具并列可选。

🛠 管理后台

会话监控、传感器/设备/场景/阈值、提示词、Skills 启停、MCP、知识库一体配置。

🔥 Fire Trace

调用树 / 火焰图 / 瀑布;会话用量统计 Token、Tools、MCP、Skills、知识库次数。

📍 试验点锚定

儋州两院坐标与默认 1 号棚(GH01);演示数据对齐平台需求文档。

04 · Highlights

项目亮点

🧠

ReAct + Toolkit

棚小智真实调用工具拿传感器与设备状态,不编造读数;思考与工具卡片经 SSE 流式展示。

🧩

Skills 像选工具一样

按 description 自主匹配 SOP;命中多步农事后先 Skill 再按清单执行,避免跳过规程。

📚

知识库增强

OpenAI Embedding + 轻量向量检索,补充农艺解释与操作口径,并计入会话用量。

⚡

场景规则引擎

「38℃高温联动」等固定流程用 scenes.json 表达,与 LLM 职责分离,可测可审计。

🛡️

混合控制策略

白名单可自动下发;普通调控与单设备须确认,工具层强制互锁校正。

🔥

可观测调试

Fire Trace 还原推理链路,会话级 Token / Tools / MCP / Skills / 知识库次数一目了然。

05 · Project Map

目录结构

大棚业务集中在 backend/greenhouse/;对话、管理后台、Fire Trace 与首页均在 web/。

backend/greenhouse/ # 智慧大棚业务域 agent_factory.py # 棚小智 Agent 装配 prompts.py # 系统提示词 skill_prompt.py # Skills 注入模板 api.py / admin.py # 对话 SSE · 管理接口 store.py # JSON 模拟数据仓库 knowledge_index.py # 向量知识库索引 skills/ # 农事 SOP(巡检 / 高温 / 水肥…) tools/ # 感知 · 调控 · 预警 · 知识库 data/ # 传感器 · 设备 · 场景 · 知识条目 backend/ session_stats.py # Token / Tools / MCP / Skills / KB debug.py # Fire Trace API tracing.py # TraceStore 内存链路 web/ greenhouse.html(+js) # 对话页 greenhouse-admin.html(+js) # 管理后台 debug.html(+js/css) # Fire Trace home.html # 本首页 run.py # 启动入口 · 默认 :8089