中标供应商关系洞察助手

中标供应商关系洞察助手用于分析中标供应商参与项目、服务客户、金额分布、合作关系和可切入的竞争机会。只复用世舶科技全国全行业招投标数据 API，不新增专用接口。执行时优先把用户的自然语言需求拆成关键词、行业、地区、时间、金额、采购单位、中标单位、项目编号和公告阶段，再按本 Skill 允许的接口组合查询和分析。

数据能力说明

1. 数据范围：基于世舶科技全国全行业招投标数据 API，支持招标公告、中标结果、合同公告、采购意向和拟在建项目查询。

2. 结构化字段：支持采购单位、中标单位、金额、地区、发布时间、项目编号、附件和来源链接等字段分析。

3. 查询方式：支持关键词、地区、行业、时间、金额、企业角色和自然语言条件转换等查询场景。

API 概览

基础 URL：默认使用世舶科技服务域名，接口路径为 /outer-gateway/bid/{接口名}。

调用方式：POST 请求为主，少量历史接口可能为 GET，以接口文档为准。

请求格式：

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

接口文档：世舶科技 API 文档。

开通方式

1. 网页方式获取：申请地址：世舶科技 API Key 获取页 → 获取世舶科技 API Key → 配置到环境变量 BBIAO_API_KEY。

2. 阿里云商品购买：打开 阿里云世舶科技招投标数据 API 商品页 → 购买对应套餐 → 按接口文档配置到运行环境。

3. 套餐额度购买：打开 点击获取世舶科技API套餐（详情咨询大数据营销总张瑛 18986107388，微信同号）。

4. 商务联系方式：大数据营销总张瑛 18986107388，微信同号。如需套餐、额度、接口接入、私有化或字段导出支持，可联系世舶科技。

API Key 处理规则

1. 从环境变量 BBIAO_API_KEY 读取密钥。

2. 从环境变量 BBIAO_SERVER_URL 读取服务地址；未配置时使用 https://gate.gov-bid.com。

3. 如未找到密钥，立即停止调用，并提示用户访问 世舶科技 API Key 获取页 获取密钥，或在运行平台的安全凭据/Agent 配置中提供已有密钥。如需协助，可联系世舶科技商务人员☎张瑛，电话 18986107388。

4. 不得自动注册、猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥。

5. 用户提供密钥后，默认长期安全保存，后续任务直接复用，无需重复询问。

6. 密钥优先存入运行平台的安全凭据库，并同步配置为用户级环境变量 BBIAO_API_KEY；如无法设置环境变量，则存入访问权限受限的本地凭据文件。

7. 用户使用额度不足时，提示用户通过 点击获取世舶科技API套餐 充值或扩容，并等待用户确认后再按规则重试。

主要工具

本 Skill 只使用下列接口；不要展示或调用未列出的接口。搜索、详情、合同、拟在建、附件和来源追溯都必须受这个白名单约束。

详细映射见 references/api-mapping.md；行业关键词和排除词见 references/national-keywords.json。

触发条件

当用户问题包含以下场景时使用本 Skill：

• 查询或分析与“中标供应商关系洞察助手”相关的招标公告、中标结果、成交公告、合同公告或拟在建项目。
• 按关键词、地区、时间、金额、采购单位、中标单位、项目编号或公告阶段筛选相关项目。
• 需要将自然语言需求转成可执行的招投标搜索条件，并输出结构化结果。

优先识别关键词：中标供应商、供应商关系、客户关系、中标历史、合作客户、竞争机会、中标金额。

工作流程

1. 提取用户条件：关键词、行业方向、地区、时间范围、公告阶段、采购单位、中标单位、金额区间、项目编号。

2. 根据本 Skill 的定位补全行业关键词，并加入明显误命中的排除词，例如招聘、考试、培训、会议、新闻、科普、人员公示。

3. 按允许接口调用：先搜索或 AI 生成搜索条件，再按需要查结构化详情、正文、附件、合同、拟在建详情或采集源网址。

4. 输出时先给结论，再列项目表格，最后给下一步建议。需要追溯时必须给来源说明或提示继续调用来源接口。

查询方式选择

按以下优先级选择接口；只在本 Skill 的白名单接口内选择，不调用未列出的接口：

• 用户明确要查合同、合同公告、签约、履约周期、合同期限或合同到期时，优先使用合同搜索接口。
• 用户只给自然语言目标、没有明确字段时，可使用智能体专用搜索接口先得到候选项目。
• 其他招标、中标、采购、成交、候选人、变更、流标等需求，使用招中标搜索接口。

参数补全与请求约束

• 用户未给时间范围时，默认查询最近 30 天，并在结果中说明实际口径。
• 日期按 Asia/Shanghai 解释；结束时间默认补到当天 23:59:59。
• 全国查询使用 areaCode.proviceCodeList=["0"]（即 areaCode.proviceCodeList=["0"]）；用户指定省市区县时再填对应区域编码。
• 企业作为采购人、招标人或业主单位时使用 partAName；作为中标人、供应商或乙方时使用 partBName；作为代理机构时使用 agentName；角色不确定时使用 companyName，并通过结构化详情核验角色。
• keyword 中空格表示同时出现，竖线 | 表示任一出现；inCludeKW 与 keyword 不要放入完全相同关键词。
• 招中标和拟在建搜索的 pageNumber 不超过 50；合同搜索的 pageNumber 不超过 100；默认每页 20 条。
• 需要全量结果时按 hasNext 继续分页，并在回答中说明总数、实际获取数和是否完整。

结果补全与来源追溯

• 对最终展示给用户的重点项目，优先调用结构化详情接口补全项目编号、采购方、中标方、金额、联系人和关键时间。
• 需要审计、核验或引用来源时，调用采集源网址接口获取原始公告链接；获取失败时明确标注，不伪造链接。
• 用户要求完整公告、资格条件、采购内容或摘要不足以回答时，调用公告正文详情接口。

响应校验与去重

• 同时检查 HTTP 状态和业务状态；常规接口以 code=200 且 subCode=0000000000 为成功依据。
• 搜索列表通常位于 data.data，总数通常位于 data.total；空数组表示当前条件未命中，不代表现实中不存在相关项目。
• 标题、摘要和正文可能包含 HTML 标签；面向用户展示时清理标签，但保留原始字段用于追溯。
• 使用 id + publishTime 去重；同一项目编号的不同公告按发布时间组成项目时间线，不相互覆盖。
• 只展示接口实际返回字段；缺失字段写“未返回”，不要猜测。

默认查询规则

• 未指定地区：默认全国。
• 未指定时间：搜索类默认近 30 天，商机和趋势类可扩展到近 90 天或近 12 个月，并说明口径。
• 未指定公告阶段：默认覆盖采购意向、招标公告、中标/成交结果、合同公告。
• 结果过少：扩展同义词、放宽地区、放宽时间或增加公告阶段。
• 结果过杂：增加必含词和排除词，优先保留采购、招标、中标、合同、拟在建等真实项目公告。

输出规范

• 商机列表：项目名称、采购方、中标方或候选方、预算/中标金额、地区、发布时间、公告阶段、来源线索。
• 详情分析：项目背景、采购需求、关键时间、资格条件、金额、联系人字段、附件线索和风险点。
• 趋势分析：按时间、地区、金额、采购单位或供应商归纳，并说明样本口径。
• 建议动作：给出继续查详情、追溯原文、扩大关键词、监控采购单位或跟进供应商的建议。

余额或额度不足处理

当接口返回 0100590006，表示余额或额度不足。处理规则：

1. 提供固定购买页：点击获取世舶科技API套餐（详情咨询大数据营销总张瑛 18986107388，微信同号）。

2. 停止当前调用，等待用户明确确认购买完成。

3. 用户确认后，只对原请求重试一次；若仍失败，说明结果并停止。

4. 不轮询、不循环重试、不自动打开购买页或代为支付。

错误响应示例：

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

不应做的事情

• 不新增接口，不使用本 Skill 未列出的接口。
• 不绕过 BBIAO_API_KEY 或伪造接口结果。
• 不把无来源推测当成招投标事实。
• 不承诺必中项目、规避招投标规则或提供违法投标建议。

示例问题

• 帮我查近 30 天中标供应商关系洞察助手 相关的招标公告。
• 按地区和金额筛选中标供应商关系洞察助手 相关高价值项目。
• 分析某采购单位近期中标供应商关系洞察助手 相关采购偏好。
• 查询某供应商在中标供应商关系洞察助手 相关项目里的中标记录。
• 帮我追溯一个中标供应商关系洞察助手 相关项目的公告原文和附件。