智慧农业项目机会追踪助手

技能文档

---
name: smart-agriculture-opportunity-tracker
title: 智慧农业项目机会追踪助手
category: 招投标采购
description: 面向智慧农业、数字农业和乡村振兴领域，从全国招投标数据中追踪农业物联网、高标准农田、灌溉系统、农产品溯源、设施农业、农机设备等采购机会，分析采购单位、中标单位、金额与区域热度。当用户需要查找农业类招标公告、中标结果、采购意向、拟在建项目或农业赛道商机监控时触发。触发词：智慧农业、农业招标、高标准农田、农机采购、乡村振兴项目。
---

# 智慧农业项目机会追踪助手

面向智慧农业、数字农业和乡村振兴项目，追踪农业物联网、现代农业园区、高标准农田、农田水利、灌溉系统、水肥一体化、农业大数据、农产品溯源、智慧温室、设施农业、种业基地、无人农机、农业遥感、病虫害监测、冷链仓储和农机设备采购机会。适合农业科技公司、设备厂商、集成商、农服机构和渠道团队识别地方农业农村局、园区平台、合作社和国企项目。

本技能不新增专用 API，只复用全国全行业招投标数据 API，通过专属关键词、默认筛选规则、接口调用顺序和输出模板，把通用招投标数据整理为适合搜索、监控、分析和销售跟进的结果。

## 服务配置

1. 从环境变量 `BBIAO_API_KEY` 读取密钥；从环境变量 `BBIAO_SERVER_URL` 读取服务地址，未配置时使用 `https://gate.gov-bid.com`。
2. 未找到密钥时立即停止调用，提示用户向数据服务提供方申请 API Key，配置到 `BBIAO_API_KEY` 后重试。
3. 不得自动注册、猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥。
4. 用户提供密钥后默认长期安全保存，后续任务直接复用，无需重复询问；密钥优先存入运行平台的安全凭据库，并同步配置为用户级环境变量。
5. 额度不足时提示用户向数据服务提供方充值或扩容，等待用户确认后再重试。

## 引用文件

处理接口选择、参数补全、关键词扩展或结果过滤时，先查看：

- `references/api-mapping.md`：接口范围、用户意图映射、默认参数和异常处理。
- `references/smart-agriculture-opportunity-tracker-keywords.json`：关键词、排除词、公告类型和允许接口。

## API 概览

基础 URL：默认 `https://gate.gov-bid.com`，接口路径为 `/outer-gateway/bid/{接口名}`。

请求格式：

```text
POST {BASE_URL}/outer-gateway/bid/{接口名}?key={API_KEY}
Content-Type: application/json
```

## 主要工具

只使用以下接口；不要加入未列出的其他接口。

| 类别 | 接口名 | 用途 |
|---|---|---|
| 招中标信息搜索列表（Agent 专用） | SearchProjectForAI | 面向自然语言问题检索招标采购项目 |
| AI 生成招中标信息搜索条件 | aiSearchSubmitPolling | 把自然语言需求改写为可执行搜索条件 |
| AI 行业搜索 | industryReasoning | 根据关键词推理行业方向或行业编码候选 |
| 招中标信息搜索列表 | searchProjectApi | 按关键词、地区、行业、时间、金额、企业名称检索公告 |
| 招中标信息结构化数据详情 | getZTBStructreDetail | 获取采购方、供应商、金额、联系人、时间等结构化字段 |
| 招中标合同数据搜索列表 | searchProjectContactApi | 搜索合同公告，核验甲乙方、合同金额和履约周期 |
| 获取招中标信息采集源网址 | getCollectUrl | 获取原始公告来源链接，用于结果追溯和复核 |

## 触发条件

当用户问题包含以下意图时使用本技能：

- 查询、筛选或监控智慧农业、数字农业、农业物联网、现代农业园区、高标准农田、农田水利、灌溉系统、水肥一体化、农业大数据、农产品溯源、智慧温室、设施农业、种业基地、无人农机、农业遥感、病虫害监测、农村人居环境、冷链仓储、农机设备、乡村振兴相关的招标公告、中标结果、合同公告、采购意向或拟在建项目。
- 分析上述领域内的采购单位、供应商、中标记录、合同机会、竞争对手或市场趋势。
- 按地区、时间、金额、公告阶段、采购单位或企业名称查找智慧农业领域商机。
- 把自然语言需求转成招投标 API 查询条件，并输出可复核的结果。

## 专属关键词

优先使用用户原词，再结合以下关键词扩展：智慧农业、数字农业、农业物联网、现代农业园区、高标准农田、农田水利、灌溉系统、水肥一体化、农业大数据、农产品溯源、智慧温室、设施农业、种业基地、无人农机、农业遥感、病虫害监测、农村人居环境、冷链仓储、农机设备、乡村振兴。

默认排除：招聘、考试、培训、会议、讲座、新闻、科普、通知、人员公示、表彰、租房。

## 技能工作流

### 步骤1：判断用户意图

区分商机搜索、公告检索、中标分析、合同查询、拟在建跟踪、企业画像、客户供应商关系或竞争对手分析。

### 步骤2：抽取检索条件

抽取关键词、地区、时间、公告类型、采购单位、中标单位、金额范围、项目编号和排除词；使用专属关键词补全行业或场景词；未指定地区默认全国，未指定时间默认近 90 天。

### 步骤3：调用接口

只在「主要工具」列出的接口范围内选择调用顺序，不调用未列出的接口。

### 步骤4：结果不足时调整

按「同义词扩展 → 放宽时间 → 放宽地区 → 减少低置信度限制」的顺序调整检索条件。

### 步骤5：过滤与输出

输出前过滤招聘、考试、培训、会议、新闻、人员公示等明显无关内容，按输出规范整理结果。

## 接口调用顺序

| 用户意图 | 推荐接口 | 必要参数 | 自动补全参数 | 输出重点 |
|---|---|---|---|---|
| 自然语言搜索 | SearchProjectForAI | 用户自然语言需求 | 关键词、地区、时间、公告阶段 | 识别条件、相关项目、匹配理由 |
| AI 条件生成 | aiSearchSubmitPolling | 自然语言需求 | 关键词、地区、时间、金额、公告阶段 | 可执行查询条件、条件解释 |
| 行业识别 | industryReasoning | 行业或业务描述 | 同义词、行业方向 | 行业方向、关键词扩展 |
| 公告检索 | searchProjectApi | 关键词、时间、分页 | 地区、公告阶段、排除词 | 项目列表、采购单位、金额、时间 |
| 结构化详情 | getZTBStructreDetail | 项目 ID、发布时间 | 无 | 采购方、供应商、金额、联系人 |
| 合同查询 | searchProjectContactApi | 关键词、时间、分页 | 地区、合同金额、履约周期 | 合同甲乙方、合同金额、履约期限 |
| 来源追溯 | getCollectUrl | 项目 ID、发布时间 | 无 | 原始链接、采集来源 |

## 输出规范

- 先说明识别出的查询条件和自动补全条件。
- 搜索结果用表格输出：项目名称、地区、公告类型、发布时间、采购单位、中标单位、金额、来源链接。
- 详情分析输出：采购需求、资格条件、关键时间、金额、附件、原始公告链接和风险提示。
- 商机分析输出：推荐等级、匹配理由、采购方价值、竞争强度、下一步动作和待核实信息。
- 企业分析输出：企业概况、近期中标记录、合作客户、供应商关系、重点区域和业务关键词。
- 字段缺失时写「公告未披露」或「不详」，不得编造金额、联系人、附件或链接。

## 额度不足处理

错误码 100590006 表示余额或额度不足：停止调用，提示用户向数据服务提供方充值或扩容。只有用户明确确认完成后，才对原请求重试一次；若仍失败，说明结果并停止，不轮询、不循环重试、不代为支付。

## 异常处理

| 场景 | 处理方式 |
|---|---|
| 未配置 API Key | 提示用户申请密钥并配置 `BBIAO_API_KEY` |
| 认证失败 | 检查 API Key 是否正确、是否过期、是否具备接口权限 |
| 余额不足 / 额度耗尽 | 提示充值或扩容，停止调用并等待用户确认 |
| 参数错误 | 检查必填参数、日期格式、分页、金额范围、公告类型和地区参数 |
| 结果为空 | 扩展同义词，放宽时间、地区和公告阶段 |
| 详情不可用 | 返回搜索摘要，并说明详情、附件或原始链接未返回 |

## 不应做的事情

- 不新增 API，不使用其他数据服务的地址、Key 名称、请求头或文案。
- 不调用、不展示未列入「主要工具」的其他接口。
- 不把招聘、考试、培训、会议、新闻、人员公示等内容当成采购商机。
- 不编造公告、金额、联系人、附件、投标截止时间或中标单位。

## 示例用户问题

- 查询近 90 天全国高标准农田相关项目。
- 帮我找广东智慧温室采购商机，并按金额排序。
- 分析今年农机设备领域主要中标单位有哪些。
- 查询北京农产品溯源相关合同公告，提取甲乙方和金额。
- 监控江苏农业物联网项目，排除招聘和培训信息。
- 帮我分析某供应商在设施农业领域的中标记录。

使用说明

# 智慧农业项目机会追踪助手

面向智慧农业、数字农业和乡村振兴领域，从全国招投标数据中追踪高标准农田、农业物联网、设施农业、农机设备等采购机会，输出可复核的商机分析。

## 使用

```text
帮我找近 90 天广东的智慧温室和高标准农田招标项目，按金额排序
```

首次使用前配置数据服务密钥：

```bash
export BBIAO_API_KEY=你的密钥
# 可选：覆盖服务地址
export BBIAO_SERVER_URL=https://gate.gov-bid.com
```

## 工作原理

技能把自然语言需求映射为招投标数据 API 的检索条件，按「判断意图 → 抽取条件 → 调用接口 → 调整结果 → 过滤输出」五步执行；使用行业专属关键词与排除词过滤噪音，最终输出项目表、商机分析与跟进建议，字段缺失时明确标注而非编造。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。