标书技能（招投标智能体）

面向智能体的招投标付费技能，按次结算，两个能力二选一（action 参数）：

| action | 能力 | 输入 | 输出 | |---|---|---|---| | check | 废标检查 | 采购文件全文 | 废标/风险条款清单（三级风险+应对建议） | | generate | 标书制作 | 采购文件全文 + 投标人名称（可选） | 整本投标书 docx（Base64）+ 章节大纲 |

废标检查（action=check，默认）

抽取所有可能导致废标或扣分的条款，每条含 clause（条款原文）、requirement（要求概述）、risk（★ 重大废标 / △ 扣分 / ○ 格式瑕疵）、suggestion（应对建议）、type（qualification 资质 / technical 技术星号 / format 格式签章 / deadline 时间节点 / bond 保证金 / other 无效投标情形），外加 total 与 high_risk_count 汇总。写标书前的第一道预检。

标书制作（action=generate）

输入采购文件全文，AI 自动完成：需求解析 → 5-6 章大纲规划（项目理解/服务方案/实施计划/团队配置/质量保障/售后承诺）→ 逐章撰写 800-1200 字正文 → 合成规范投标书 docx。

输出：docx_base64（解码保存为 .docx 即可直接编辑）、outline（章节大纲）、project_name、docx_size_bytes。

耗时：分钟级（LLM 逐章生成），调用方超时建议 ≥360 秒。

可选参数：company_name（投标人名称，用于封面与行文口吻，缺省"投标人"）。

调用方式

入口：POST https://zvex.cn/a2m/v1/skill

{"skill": "bid_document", "action": "check", "text": "<采购文件全文>"}
{"skill": "bid_document", "action": "generate", "text": "<采购文件全文>", "company_name": "某某科技有限公司"}

参数也支持嵌套写法：{"skill":"bid_document","input":{"action":"...","text":"..."}}

付款协议（402 Payment-Needed）

首次调用不带凭证 → 返回 402 + Payment-Needed 响应头（Base64URL 签名账单：金额 5.00、账单号、30 分钟有效、商家 RSA2 签名）。
智能体按账单完成支付后，同一请求携带 Payment-Proof: <支付凭证> 头重试。
验付通过 → 执行技能 → 返回结果与 Payment-Validation 头。
凭证无效返回 402（重新发起新账单）；502 为临时失败，用同一 Payment-Proof 重试，不要重复付款。同一账单幂等，不会重复扣费。

错误码

| HTTP | code | 含义 | |---|---|---| | 400 | MISSING_FIELDS | 缺少必填参数 text | | 400 | INVALID_PARAMS | action 非法（只支持 check / generate），计费前拦截 | | 404 | UNKNOWN_SKILL | 技能名错误（响应含可用列表） | | 402 | Payment-Needed / INVALID_PAYMENT_PROOF | 按付款协议处理 | | 502 | FULFILLMENT_ERROR / FULFILLMENT_CONFIRM_FAILED | 临时失败，同凭证重试 | | 500 | CREATE_ORDER_ERROR | 账单生成失败，稍后重试 |

详细文档

接口字段与协议细节：references/api.md
完整请求/响应示例：references/examples.md

商户信息

服务商标：声桥
支付宝 AI 付服务：声桥智能体技能服务
服务地址：https://zvex.cn/a2m/v1/skill
单价：5.00 元/次（check 与 generate 同价，按次计费）

常见问题（FAQ）

Q1：check 和 generate 怎么选？ 投标前先用 check 做废标预检（秒级），按建议改完标书再用 generate 整本生成；也可 both 一次完成。 Q2：首次调用返回账单不是结果？ 正常流程（按次付费）：支付宝完成支付后，完全相同参数+凭证重试即得结果；同账单幂等不重复扣费。 Q3：账单里那串字符要看懂吗？ 不用，防伪签名账单，原样复制进 Payment-Proof 头重试即可。 Q4：没有支付宝？ zvex.cn 注册生成 API Key，请求体带 zvex_api_key 按次扣积分直接出结果。 Q5：generate 要多久？ 分钟级（LLM 逐章撰写），调用超时建议 ≥360 秒；输出 docx_base64 解码即得可编辑 Word。 Q6：参数错误会扣费吗？ 不会，校验在计费前；检查 text 非空、action 为 check/generate/both。