# CoopNet：面向农业合作社的AI驱动运营协调平台

> CoopNet 是一个专为农业合作社设计的AI驱动运营平台，集成了库存管理、任务委派、生产沟通等功能。通过单一LLM和Tool Calling架构，实现WhatsApp消息自动解析、智能任务分配、异常检测和定时AI报告生成，帮助合作社实现数字化、可追踪的运营管理。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-05-13T00:43:15.000Z
- 最近活动: 2026-05-13T00:50:28.751Z
- 热度: 150.9
- 关键词: 农业合作社, AI代理, Tool Calling, 库存管理, WhatsApp集成, 任务分配, 异常检测, Gemini
- 页面链接: https://www.zingnex.cn/forum/thread/coopnet-ai
- Canonical: https://www.zingnex.cn/forum/thread/coopnet-ai
- Markdown 来源: ingested_event

---

## 背景与问题

农业合作社的日常运营通常依赖手工和分散的管理方式，面临诸多挑战：

- **库存信息分散**：使用Excel、纸质记录或口头通知跟踪库存，导致数据延迟和错误
- **生产者沟通碎片化**：通过WhatsApp和电话分散沟通，信息容易丢失且难以追踪
- **仓库任务手动分配**：耗时且容易出错
- **关键库存水平发现滞后**：导致供应危机
- **临期产品难以追踪**：造成浪费和财务损失
- **需求、库存和产能无法联动分析**：决策质量低下
- **AI决策缺乏记录**：自动化过程无法审计

## CoopNet 简介

CoopNet 是一个面向农业合作社的AI驱动运营、库存和任务管理平台。它整合了仓库管理、需求跟踪、生产者沟通、基于班次的任务分配、财务可视化、异常检测、AI报告和WhatsApp消息处理，为合作社提供统一、智能、可审计的运营解决方案。

### 核心目标

1. 集中跟踪库存和仓库状态
2. 自动分析生产者发来的收获消息
3. 在同一运营流程中整合需求、库存和生产者信息
4. 早期识别关键库存和浪费风险
5. 自动向班次中的合适员工分配任务
6. 生成每日、晚间和每周AI报告
7. 通过记录AI决策建立可审计的结构

## 系统架构

CoopNet 采用四层架构设计：

```
用户/生产者/Cron → 前端/Webhook → FastAPI后端 → Gemini AI Agent → Tool Calling → Supabase数据库 → 任务/通知/报告/日志
```

### 技术栈

| 层级 | 技术 |
|------|------|
| 前端 | Next.js 15 + React 19 + TypeScript + Tailwind CSS |
| 后端 | FastAPI + Python 3.11+ |
| 数据库 | Supabase PostgreSQL + Auth |
| AI层 | Google Gemini + Tool Calling |
| 消息 | Twilio WhatsApp |
| 定时任务 | APScheduler |

## 核心功能详解

### 1. AI代理与Tool Calling架构

CoopNet 的核心是一个基于Gemini的AI代理，通过Tool Calling实现与真实数据的连接：

**可用工具列表：**

| 工具 | 功能 |
|------|------|
| `get_stock(product_name)` | 获取产品当前库存量和单位 |
| `check_threshold(product_name)` | 检查关键库存阈值和填充率 |
| `get_daily_orders(date)` | 列出指定日期的订单 |
| `assign_task(role, title, priority)` | 向班次中的员工分配任务 |
| `update_stock(product_name, delta, reason)` | 更新库存数量 |
| `get_sales_forecast(product_name, days)` | 基于历史订单生成需求预测 |
| `send_notification(role, title, message)` | 向相关角色发送系统通知 |

**Tool Calling流程：**

```
用户请求/定时触发 → Gemini决定调用工具 → 执行后端handler → 查询/更新Supabase → 返回结果给AI → AI生成最终响应
```

### 2. WhatsApp生产者消息处理

生产者可通过WhatsApp发送自由格式的收获消息，系统自动解析并采取行动：

**示例消息：**"50 kg biber ve 30 kg domates hasat ettim."（我收获了50公斤辣椒和30公斤番茄）

**处理流程：**

```
生产者WhatsApp消息 → Twilio Webhook → FastAPI端点 → 电话号码验证 → Gemini NLP解析 → 库存决策引擎 → 任务/审批/拒绝/日志
```

**库存水平决策规则：**

| 库存水平 | 行动 |
|---------|------|
| > 75% | 当前不需要该产品 → 记录决策 |
| 25% - 75% | 进入待审批队列 → 通知管理员 → 12小时审批流程 |
| < 25% | 自动接受 → 创建仓库任务 → 通知管理员和员工 → 向生产者发送接受消息 |

### 3. 基于班次的智能任务分配

当AI或系统需要创建任务时：

```
assign_task(role="warehouse") → 角色转部门 → 查询shifts表中的活跃班次 → 找到合适员工 → 创建带assigned_to字段的任务 → 任务在班次页面可见
```

**部门映射：**

| 角色 | 部门 |
|------|------|
| warehouse | 仓库 |
| logistics | 物流 |
| field | 田地 |
| accounting | 会计 |

### 4. 定时AI代理

后端启动时，APScheduler自动激活以下定时任务：

| 代理 | 调度 | 任务 |
|------|------|------|
| 早间代理 | 每天07:00 | 关键库存、待审批项、每日订单 → 生成早间行动计划 |
| 晚间代理 | 每天22:00 | 已完成任务、订单状态、代理决策 → 生成每日总结 |
| 每周代理 | 周一08:00 | 每周订单趋势、库存变化、绩效评分 → 生成每周报告 |
| 审批超时代理 | 每小时 | 自动拒绝超过12小时的审批，通知生产者 |
| 库存检查代理 | 每30分钟 | 扫描关键库存，创建高优先级任务，记录决策 |
| 防浪费代理 | 每6小时 | 查找3天内到期的产品，向兄弟生产者生成优惠提议 |

### 5. 异常检测系统

自动识别运营中的异常情况：

- 意外的库存下降
- 突然的需求激增
- 物流延迟
- 关键任务积压
- 浪费风险

### 6. AI报告与审计日志

**AI报告类型：**

- 早间行动计划（07:00）
- 每日总结（22:00）
- 每周洞察（周一08:00）
- AI建议、供应商邮件和通知草稿

**AI日志系统：**

- AI操作历史
- 行动日志
- 警告和自动化记录
- 决策原因和影响说明

## 数据库设计

**核心数据表：**

| 表名 | 说明 |
|------|------|
| `products` | 仓库产品、库存水平、价格、到期日 |
| `requests` | 客户订单和状态 |
| `tasks` | 任务及与员工的assigned_to关联 |
| `employees` | 人员列表、部门、角色、电话、头像 |
| `shifts` | 每周班次时间表 |
| `pending_approvals` | 管理员审批队列及12小时超时 |
| `ai_logs` | AI决策和事件记录 |
| `ai_reports` | AI报告条目 |
| `stk_alerts` | 浪费和关键库存警报 |
| `financial_stats` | 财务指标 |

## 关键API端点

**仪表板与运营：**

- `GET /api/dashboard/summary` - 仪表板摘要
- `GET /api/dashboard/stock/all` - 所有库存
- `GET /api/dashboard/trends` - 趋势数据
- `PATCH /api/dashboard/tasks/{task_id}` - 更新任务

**定时任务：**

- `GET /api/cron/stock-check` - 库存检查
- `GET /api/cron/daily-summary` - 每日总结
- `GET /api/cron/anomaly-check` - 异常检查
- `GET /api/cron/morning-briefing` - 早间简报
- `GET /api/cron/evening-summary` - 晚间总结
- `GET /api/cron/weekly-briefing` - 每周简报

**AI功能：**

- `POST /api/ai/chat` - AI聊天
- `POST /api/ai/daily-summary` - 生成每日总结
- `POST /api/ai/weekly-insight` - 生成每周洞察
- `GET /api/ai/logs` - AI日志
- `GET /api/ai/reports` - AI报告

**Webhook：**

- `POST /api/webhook/whatsapp` - WhatsApp消息处理
- `POST /api/webhook/whatsapp/demo` - WhatsApp演示

## 安全与审计特性

1. **AI决策可审计**：所有AI决策记录到`ai_logs`表
2. **审批流程**：关键操作需要管理员审批
3. **超时机制**：12小时自动拒绝未处理审批
4. **置信度阈值**：NLP解析结果需达到置信度标准
5. **Supabase Auth**：完整的用户认证和授权

## 实际应用价值

### 对合作社管理者的价值

1. **单一视图管理**：从单个面板监控所有运营
2. **主动预警**：在问题发生前收到警报
3. **数据驱动决策**：基于历史数据和AI洞察做出决策
4. **减少浪费**：通过临期预警和智能调配减少损失
5. **提升效率**：自动化日常任务分配和沟通

### 对生产者的价值

1. **简化沟通**：通过熟悉的WhatsApp发送消息
2. **快速反馈**：自动接收接受/拒绝通知
3. **透明流程**：了解产品状态和合作社需求

## 总结

CoopNet 代表了AI技术在农业合作社运营中的创新应用。通过将库存管理、任务分配、生产沟通和AI分析整合到统一平台，它解决了传统手工管理的痛点。Tool Calling架构使AI能够实际操作数据库和执行任务，而不仅仅是提供建议。定时代理确保系统7x24小时主动监控和响应，审计日志则建立了可信赖的自动化基础。对于寻求数字化转型的农业合作社，CoopNet 提供了一个实用且完整的解决方案。