招投标RAG知识检索助手

技能文档

---
name: lanshan-bid-rag-knowledge-search
title: 招投标RAG知识检索助手
category: 招投标采购
description: 面向 RAG 与知识库场景，检索、结构化招投标公告与拟在建数据，抽取项目名称、采购单位、中标单位、金额、地区、附件等字段，支持语义分块、元数据设计与可追溯来源，服务于招投标问答、项目检索、企业跟踪和商机推荐知识库构建。当用户需要把招标公告做成知识库、设计标讯 RAG 分块或构建招投标问答系统时触发。触发词：招投标RAG、标讯知识库、招标公告结构化、招投标问答。
---

# 招投标 RAG 数据助手

为 RAG 场景检索、摘要、结构化招投标公告和拟在建数据。根据用户问题自动选择搜索、详情、合同、拟在建、附件、采集源网址和 AI 搜索条件生成接口，把通用招投标数据整理成可追溯、可分析、可接入的结果。

## 服务配置

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

## 引用文件

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

- `references/api-mapping.md`：接口调用映射、默认参数、接入方式和错误处理。
- `references/national-keywords.json`：触发关键词、排除词、公告类型和默认时间范围。

## 接入方式

### 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 客户端。

## 主要工具

只展示和调用下列接口；不要加入未列出的其他接口。

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

## 技能工作流

### 步骤1：确认配置与需求

检查 `BBIAO_API_KEY` 是否可用；明确用户目标是检索、结构化入库、问答模板设计还是接口接入。

### 步骤2：选择接口并构造条件

根据需求在「主要工具」白名单内选择接口，抽取关键词、地区、时间、公告类型等参数；未指定地区默认全国，未指定时间默认近 90 天。

### 步骤3：执行检索与结构化

调用接口获取数据；长正文按采购需求、资格条件、评分办法、合同信息等语义分块；保留标题、正文、结构化字段、发布时间、地区、公告类型、来源链接和附件。

### 步骤4：组织可追溯输出

检索回答优先引用接口返回的客观数据，附原始公告链接；缺失字段明确标注「公告未披露」或「不详」，不得编造公告、金额、联系人、附件或链接。

### 步骤5：给出入库与接入建议

数据入库/RAG 类输出包含字段映射、去噪规则、唯一键建议、原文链接、附件链接和可追溯信息；接口接入类输出包含推荐接口、必要参数、调用顺序、错误处理和示例请求体。

## 使用重点

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

## 输出规范

- 先说明本次识别出的查询条件和自动补全条件。
- 搜索结果用表格输出：项目名称、地区、公告类型、发布时间、采购方、中标方、金额、链接。
- 详情解析输出：采购需求、资格条件、关键时间、金额、附件、原始公告链接和风险提示。

## 额度不足处理

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

错误响应示例：

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

## 错误处理

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

## 执行规则

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

## 示例问题

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

使用说明

# 招投标RAG知识检索助手

面向 RAG 与知识库场景，检索并结构化全国招投标公告与拟在建数据，支持语义分块、元数据设计与原文可追溯，助力构建招投标问答与商机推荐系统。

## 使用

```text
帮我把近 30 天的中标公告整理成 RAG 入库格式，字段要有采购单位、中标金额和原文链接
```

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

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

## 工作原理

技能在接口白名单内按需调用搜索、详情、附件、采集源等接口，长正文按采购需求、资格条件、评分办法等语义分块，输出含字段映射、去噪规则与唯一键建议的入库方案；所有结论附原始公告链接，缺失字段明确标注。

如何安装此技能？

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