工程建设项目提前介入助手

技能文档

---
name: construction-project-early-entry-assistant
title: 工程建设项目提前介入助手
category: 招投标采购
description: 面向建筑工程与工程建设前期商机，跟踪市政工程、房建、基础设施、EPC、施工总承包、监理、设计、造价、园区建设、道路水利和装修改造项目，在招标前识别建设单位、项目阶段、预算规模与介入窗口。当用户需要查找工程建设拟在建项目、跟踪采购意向、分析建设单位、筛选施工/监理/造价类商机、监控区域工程项目时触发。触发词：工程项目、拟在建、施工总承包、EPC、提前介入。需配置环境变量 BBIAO_API_KEY 使用。
---

# 工程建设项目提前介入助手

面向建筑工程和工程建设前期商机，跟踪市政工程、房建、基础设施、EPC、施工总承包、监理、设计、造价、项目管理、园区建设、道路水利和装修改造项目。适合施工单位、设计院、监理造价、建材设备和工程服务团队提前识别拟在建、采购意向、招标计划、临期项目和即将到期项目，判断建设单位、项目阶段、预算规模、竞对关系和介入路径，帮助团队在招标前锁定建设单位、资金安排和提前介入窗口。本技能不新增专用 API，只复用既有招投标数据服务，通过专属关键词、默认筛选规则、接口调用顺序和输出模板，把通用招投标数据整理为适合搜索、监控、分析和销售跟进的结果。

## 前置条件

- 需配置环境变量 `BBIAO_API_KEY`（招投标数据服务的付费 API Key，从服务提供方申请）
- 可选环境变量 `BBIAO_SERVER_URL` 指定服务地址；未配置时使用 `https://gate.gov-bid.com`
- 密钥获取与套餐购买：[API Key 获取页](https://apiyx.gov-bid.com/)、[接口文档](https://console.woyaobid.com/gateway-admin/share/api-doc)、[套餐购买页](https://console.api.gov-bid.com/bbiao-gateway/package)

## API Key 处理规则

1. 从环境变量 `BBIAO_API_KEY` 读取密钥，从 `BBIAO_SERVER_URL` 读取服务地址。
2. 未找到密钥时立即停止调用，提示用户自行申请获取或直接提供已有密钥。
3. 不得自动注册、猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥。
4. 用户提供密钥后默认长期安全保存，后续任务直接复用；优先存入运行环境的安全凭据库并同步为用户级环境变量，无法设置时存入访问权限受限的本地凭据文件。
5. 额度不足时提示用户前往套餐购买页充值扩容。

## API 概览

基础 URL：`https://gate.gov-bid.com`，接口路径为 `/outer-gateway/bid/{接口名}`，POST 请求为主：

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

只调用下列白名单接口，不要调用未列出的其他接口：

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

## 技能工作流

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

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

### 步骤2：抽取查询条件

提取关键词、地区、时间、公告类型、采购单位、中标单位、金额范围、项目编号和排除词。

### 步骤3：关键词补全与默认值

优先使用用户原词，再结合专属关键词扩展：建筑工程、工程建设、市政工程、房建、基础设施、EPC、施工总承包、监理、设计、造价、项目管理、装修改造、园区建设、道路工程、水利工程。默认排除：招聘、考试、培训、会议、讲座、新闻、科普、通知、人员公示、表彰、租房。未指定地区默认全国，未指定时间默认近 90 天。

### 步骤4：按白名单选择接口并调用

只在接口白名单范围内选择调用顺序，不调用未列出的接口。搜索结果不足时按「同义词扩展 → 放宽时间 → 放宽地区 → 减少低置信度限制」的顺序调整。接口意图到参数的完整映射见 [references/api-mapping.md](references/api-mapping.md)，关键词与允许接口配置见 [references/construction-project-early-entry-assistant-keywords.json](references/construction-project-early-entry-assistant-keywords.json)。

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

输出前过滤招聘、考试、培训、会议、新闻、人员公示等明显无关内容，按以下规范输出：

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

## 额度不足处理

接口返回 `0100590006` 表示余额或额度不足：提供套餐购买页链接，停止当前调用，等待用户明确确认购买完成后仅对原请求重试一次；不轮询、不循环重试、不代为支付。

## 异常处理

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

## 边界约束

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

## 示例用户问题

- 查询近 90 天全国市政工程项目拟在建线索
- 帮我找广东房建工程采购商机，并按金额排序
- 分析今年 EPC 项目主要中标单位有哪些
- 查询北京装修改造项目合同公告，提取甲乙方和金额
- 监控江苏水利工程项目动态，排除招聘和培训信息
- 帮我分析某供应商在施工总承包领域的中标记录

使用说明

# 工程建设项目提前介入助手

在招标开始前锁定工程建设商机：跟踪市政、房建、基础设施、EPC、施工总承包、监理、造价等项目类型的拟在建与采购意向，识别建设单位、预算规模与提前介入窗口。

## 使用

```text
查询近 90 天全国市政工程项目拟在建线索
帮我找广东房建工程采购商机，并按金额排序
分析今年 EPC 项目主要中标单位有哪些
```

需先配置环境变量 `BBIAO_API_KEY`（招投标数据服务付费 API Key），可选 `BBIAO_SERVER_URL` 覆盖服务地址。

## 工作原理

技能以建筑工程专属关键词与默认筛选规则驱动招投标数据 API 的七类白名单接口（自然语言搜索、AI 条件生成、行业推理、公告检索、结构化详情、合同查询、来源追溯），按意图映射选择调用顺序，过滤无关公告后输出表格化项目清单、商机推荐与风险提示，字段缺失时如实标注不编造。

如何安装此技能？

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