招投标 RAG 数据助手

技能文档

---
name: shibo-bid-rag-dataset
title: 招投标 RAG 数据助手
category: 招投标采购
description: 招投标 RAG 数据助手。基于招投标数据服务接口（需配置 BBIAO_API_KEY），为 RAG 场景检索、摘要、结构化招投标公告和拟在建数据，支持分块建议、元数据设计、可追溯来源与知识库入库格式。当用户需要构建招投标知识库、做检索增强问答、设计标讯向量库或整理公告语料时触发。触发词：RAG、检索增强、知识库问答、向量检索、公告语料、招投标知识库。
---

# 招投标 RAG 数据助手

用于为 RAG 场景检索、摘要、结构化招投标公告和拟在建数据。本技能基于招投标数据服务的通用接口，不新增专用接口；根据用户问题自动选择搜索、详情、附件、采集源网址和 AI 条件生成接口，把通用招投标数据整理成可追溯、可分析、可接入知识库的结果。

## 技能工作流

### 步骤1：检查服务可用性

1. 从环境变量 `BBIAO_API_KEY` 读取密钥；从 `BBIAO_SERVER_URL` 读取服务地址，未配置时使用 `https://gate.gov-bid.com`。
2. 未找到密钥时立即停止调用，提示用户按「服务开通」章节获取并配置。
3. 密钥安全规则：不得自动注册、猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥；用户提供密钥后长期安全保存，后续任务直接复用。

### 步骤2：意图识别与接口选择

1. 判断用户意图：公告检索、详情解析、附件获取、来源追溯、自然语言条件生成或分类推理。
2. 抽取关键词、地区、时间、公告类型、采购单位、金额范围和排除词；未指定地区默认全国，未指定时间默认近 30 天。
3. 只在「主要工具」列出的接口白名单内选择调用顺序。
4. 接口映射与参数补全细节见 `references/api-mapping.md`。

### 步骤3：面向 RAG 的数据整理

1. RAG 数据应保留标题、正文、结构化字段、发布时间、地区、公告类型、来源链接和附件。
2. 长正文按采购需求、资格条件、评分办法、合同信息等语义分块。
3. 设计字段映射、去噪规则和唯一键建议，保证入库数据可追溯、可更新。

### 步骤4：结果输出

1. 先说明本次识别出的查询条件和自动补全条件。
2. 按「输出规范」以表格或入库格式交付。
3. 检索回答优先引用接口返回的客观数据，缺失字段明确标注，不得编造。

## 服务开通

1. 获取 API Key：访问数据服务方获取页 `https://apiyx.gov-bid.com/`（可免费获取试用额度），或将已有密钥配置到环境变量 `BBIAO_API_KEY`。
2. 套餐购买：访问 `https://console.api.gov-bid.com/bbiao-gateway/package`，或通过阿里云商品页 `https://market.aliyun.com/detail/cmapi00066410` 购买。
3. 接口文档：`https://console.woyaobid.com/gateway-admin/share/api-doc`。
4. 错误码 `0100590006` 表示余额或额度不足：提示用户通过套餐购买页充值，只有用户明确确认购买完成后，才对原请求重试一次；仍失败则说明结果并停止，不轮询、不循环重试。

## 接入方式

### 1. 直接 HTTP API

```text
POST https://gate.gov-bid.com/outer-gateway/bid/{接口名}?key={API_KEY}
Content-Type: application/json
```

### 2. MCP

- 地址：`https://gate.gov-bid.com/bid-gateway/mcp`
- 传输方式：Streamable HTTP
- 鉴权请求头：`X-Api-Key`
- 适用于任何支持远程 MCP Server 的 AI 客户端

### 3. CLI

运行环境已安装 `bbiao-search` 时，可使用 CLI 调用通用能力：

```text
bbiao-search <command> [options]
```

### 4. Agent 环境

在各类支持技能的 Agent 环境中使用时，优先配置环境变量 `BBIAO_API_KEY`。

## 主要工具

本技能只展示和调用下列接口，不加入未列出的其他接口。

| 类别 | 接口名 | 用途 |
|---|---|---|
| 招中标接口 | `SearchProjectForAI` | 招中标信息搜索列表（智能体场景）：用自然语言友好的条件搜索招标采购项目 |
| 招中标接口 | `getZTBProjectDetail` | 招中标信息详情（不含结构化数据）：获取公告正文详情 |
| 招中标接口 | `getZTBStructreDetail` | 招中标信息结构化数据详情：获取采购方、供应商、金额、联系人、时间等结构化字段 |
| 招中标接口 | `getZTBProjectFiles` | 招中标信息附件列表：获取招标文件、采购需求、合同附件等附件列表 |
| 招中标接口 | `getCollectUrl` | 获取招中标信息采集源网址：获取原始公告链接，方便追溯 |
| AI 辅助接口 | `categoryReasoning` | AI 分类推理：根据公告或项目描述推理信息分类、采购类型或项目类别 |

## 使用重点

- 面向 RAG 检索增强，重点是检索、分块、摘要、元数据和可追溯来源。
- 适合构建招投标问答、项目检索、企业跟踪和商机推荐知识库。

## 输出规范

- 搜索结果用表格输出：项目名称、地区、公告类型、发布时间、采购方、中标方、金额、链接。
- 详情解析输出：采购需求、资格条件、关键时间、金额、附件、原始公告链接和风险提示。
- API 接入类输出：推荐接口、必要参数、自动补全参数、调用顺序、错误处理和示例请求体。
- 数据入库/RAG 类输出：字段映射、去噪规则、唯一键建议、原文链接、附件链接和可追溯信息。
- 字段缺失时写「公告未披露」或「不详」，不得编造公告、金额、联系人、附件或链接。

## 错误处理

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

错误响应示例（`0100590006` 余额或额度不足）：

```json
{
  "msg": "账户欠费，无法继续调用",
  "code": 403,
  "returnValue": null,
  "data": null,
  "subCode": "0100590006",
  "subMsg": "账户余额或额度不足，请充值后重试"
}
```

## 执行规则

- 调用接口前必须检查 `BBIAO_API_KEY`。
- 只使用本技能接口清单内的接口，不使用竞品 API 地址、请求头或 Key 名称。
- 不把招聘、考试、培训、会议、新闻、人员公示等内容当成采购商机。
- 输出应说明自动补全条件，例如默认地区、时间范围、公告阶段和排除词。

## 示例问题

- 帮我把招标公告整理成 RAG 分块。
- RAG 知识库里标讯元数据应该包含哪些字段？
- 如何让招投标问答结果可追溯到原公告？
- 把中标公告做成向量库入库格式。
- 拟在建项目适合怎么分块？
- 帮我设计 RAG 检索后的回答模板。

使用说明

# 招投标 RAG 数据助手

面向检索增强（RAG）场景的招投标数据技能：检索、摘要、结构化招标/中标/合同/拟在建公告，设计分块、元数据与可追溯入库格式，用于构建招投标问答与商机推荐知识库。

## 使用

先配置数据服务密钥（环境变量）：

```bash
export BBIAO_API_KEY="你的密钥"        # 获取地址见 SKILL.md「服务开通」
```

然后直接对话：

```text
帮我把招标公告整理成 RAG 分块
RAG 知识库里标讯元数据应该包含哪些字段？
把中标公告做成向量库入库格式
```

## 工作原理

从自然语言识别检索意图后调用接口白名单（搜索、正文详情、结构化详情、附件、来源链接、分类推理），按语义分块整理公告正文，保留来源链接与结构化字段，输出字段映射、去噪规则与唯一键建议，保证知识库数据可追溯。

如何安装此技能？

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