招投标数据智能接口

技能文档

---
name: bid-agent-data-interface-v2
title: 招投标数据智能接口
category: 招投标采购
description: 基于全国全行业招投标数据 API，为智能体场景提供招投标数据查询、自然语言条件改写、结果追溯与结构化分析，覆盖招中标搜索、详情、合同、拟在建、附件与采集源网址等接口。当用户需要招投标数据检索、招标信息解析、商机搜索、招投标 API 接入等场景时触发。
---

# 招投标数据智能接口

本技能用于智能体场景下的招投标数据查询、自然语言改写和结果追溯。它根据用户问题自动选择搜索、详情、合同、拟在建、附件、采集源网址和 AI 搜索条件生成接口，把通用招投标数据整理成可追溯、可分析、可接入的结果。

## 技能工作流

### 步骤1：配置认证

1. 从环境变量 `BBIAO_API_KEY` 读取密钥；服务地址从环境变量 `BBIAO_SERVER_URL` 读取，未配置时使用 `https://gate.gov-bid.com`。
2. 密钥通过数据服务商开通后获取；未找到密钥时立即停止调用，并提示用户先获取并配置 `BBIAO_API_KEY`。
3. 不得自动注册、猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥。
4. 用户提供密钥后默认长期安全保存：优先写入运行环境的安全凭据库并同步为用户级环境变量，无法设置时存入访问权限受限的本地凭据文件。
5. 错误码 `0100590006` 表示余额或额度不足：提示用户到服务商控制台充值或扩容，确认完成前停止调用，不轮询、不循环重试。

### 步骤2：理解需求并选择接口

把用户自然语言拆成意图、参数和调用顺序；复杂问题先调用 AI 搜索条件生成接口（`aiSearchSubmitPolling`），再进入搜索、详情、附件或合同接口。只使用下方白名单接口，不新增其他接口。

| 类别 | 接口名 | 用途 |
|---|---|---|
| 招中标接口 | `SearchProjectForAI` | 用自然语言友好的条件搜索招标采购项目 |
| AI 辅助接口 | `aiSearchSubmitPolling` | 把自然语言需求改写为可执行搜索条件 |
| 招中标接口 | `searchProjectApi` | 按关键词、地区、行业、时间、金额和企业名称搜索招标采购信息 |
| 招中标接口 | `getZTBStructreDetail` | 获取采购方、供应商、金额、联系人、时间等结构化详情 |
| 招中标接口 | `getCollectUrl` | 获取原始公告链接，方便追溯 |
| 招中标接口 | `getProjectByProjectNumber` | 按项目编号或标号查询项目 |

### 步骤3：调用接口

基础 URL：默认服务域名，接口路径为 `/outer-gateway/bid/{接口名}`，以 `POST` 请求为主。

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

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

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

### 步骤4：整理并输出结果

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

## 错误处理

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

余额不足的错误响应示例：

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

## 执行规则

- 调用接口前必须检查 `BBIAO_API_KEY`。
- 不把招聘、考试、培训、会议、新闻、人员公示等内容当成采购商机。
- 输出必须说明已识别条件、自动补全条件和下一步可调用接口。
- 遇到 API Key 或额度问题时，停止调用并给出清晰处理步骤。

## 示例问题

- 帮我设计一个调用招投标数据接口的流程。
- 用户问「找广东医院信息化商机」时应该怎么选接口？
- 把这个自然语言问题拆成工具调用参数。
- 查询到列表后什么时候要调用详情接口？
- 如何同时返回附件和原始公告链接？

使用说明

# 招投标数据智能接口

一句话：面向智能体的全国招投标数据查询接口，支持自然语言搜索、结构化详情与结果追溯。

## 使用

```bash
export BBIAO_API_KEY="your_key_here"
```

然后直接对话，例如：

- 「找近一个月广东医院信息化相关的招标商机」
- 「解析这个招标项目的资格条件和关键时间」
- 「按项目编号 P2026-088 查询中标结果」

## 工作原理

技能先把自然语言拆解为查询意图与参数，调用 AI 条件生成接口改写为可执行搜索条件，再调用招中标搜索、详情、附件等接口获取数据，最后以结构化表格输出并附原始公告链接，便于追溯与入库。

如何安装此技能？

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