招投标 Agent 数据接口

要解决的具体问题

在构建 AI Agent 时，集成外部数据源是常见需求，但招投标数据领域存在特定痛点。开发者需要处理自然语言查询到 API 参数的映射、多种接口的路由选择，以及数据可追溯性保障。传统做法要求手动编写转换逻辑、错误处理和数据追踪代码，这增加了开发复杂性和维护成本。例如，用户提问“找广东医院信息化商机”时，Agent 必须将意图拆解为搜索条件、自动补全默认参数（如时间范围、公告阶段），并选择合适接口调用，否则可能返回无关结果或丢失关键字段。

技能如何工作

核心能力

这个技能（bid-agent-data-interface-v2）封装了招投标数据处理的完整工具链，为 Agent 提供以下能力：

• 自然语言改写：通过 aiSearchSubmitPolling 接口，将用户自然语言问题转换为结构化搜索条件，自动补全默认参数（如地区、行业、时间范围）。
• 智能接口路由：根据查询意图自动选择接口。例如，搜索列表用 SearchProjectForAI（Agent 专用）或 searchProjectApi，详情用 getZTBStructreDetail，追溯用 getCollectUrl。
• 结构化输出规范：返回数据按表格格式组织，包含 项目名称、金额、链接 等字段，并标记缺失信息（如“公告未披露”）。
• 可追溯性保障：获取原始公告链接和附件，确保数据来源可验证，支持 RAG 或数据分析流程。

关键步骤

使用该技能的典型工作流如下：

1. 问题解析：Agent 接收用户查询后，首先调用 aiSearchSubmitPolling 生成搜索条件，输出已识别条件和自动补全参数。
2. 搜索调用：根据条件调用搜索接口（如 searchProjectApi），获取项目列表，并以表格形式返回结果。
3. 详情获取：对于需要深入信息的项目，调用 getZTBStructreDetail 获取结构化详情，包括采购需求、风险提示等。
4. 结果整合：合并搜索和详情数据，按规范输出，并说明下一步可调用接口（如附件追溯）。
5. 错误处理：遇到 API Key 缺失或额度不足时，停止调用并给出清晰指引，避免自动重试。

适用边界与注意点

• 数据依赖：所有数据来自世舶科技 API，需要有效 BBIAO_API_KEY。数据覆盖全国全行业，但字段完整性取决于原始公告披露。
• 接口限制：技能仅使用白名单内的六个接口（如 SearchProjectForAI、getCollectUrl 等），不扩展其他接口，以保持能力边界。
• 输出规范：必须说明自动补全条件，字段缺失时用特定文本标记（如“不详”），不编造数据。
• 错误场景：对于额度不足（错误码 0100590006），提供购买链接后停止；不处理招聘、考试等非招投标内容。
• 适用场景：适合 Agent 集成招投标查询功能，用于市场分析、商机挖掘或数据入库，但不适合实时监控或高频批量采集。