投标响应分析【Agent响应契约多端适配】

概述

Pay Skill 标准调用

本 Skill 已完成“升级为 Pay Skill”改造，必要支付服务已接入、已上线且可用。 本 Skill 是腾讯 SkillHub 按次计费 Pay Skill，单次价格为 ¥9.99（999 分，CNY）。Agent 的首次动作必须直接 POST 下方精确版本业务接口；首次请求前不得执行本地依赖探测或支付动作可用性检查。

支付调用链路为：业务接口首次请求 → 商户服务端生成订单并完成 SkillHub X402 AI 预下单 → 未支付时返回标准 HTTP 402、WeixinPay-Required、X-Out-Trade-No 与顶层 WeixinPay Body → Agent 将支付码交给当前宿主提供的 weixinpay_pay → 支付成功后携带两个原响应头并原样重试同一 URL 和同一 JSON Body。支付能力由商户后端和 Agent 宿主共同提供，不要求用户配置 API Key。

首次业务请求前不要搜索、安装或检查 weixinpay，也不要预先调用 weixinpay_pay；只有收到上述 HTTP 402 后，才把响应中的支付码交给宿主支付动作。

规范依据：腾讯 SkillHub 使用指南—升级为 Pay Skill。

JSON Body 参数契约

普通首次调用的 HTTP Body 顶层必须是一个 JSON 对象。下表字段直接位于顶层；不得把整个对象序列化为字符串，也不得增加 data、input 或 parameters 包装层。number 必须发送 JSON 数值，boolean 必须发送 true 或 false，array 必须发送 JSON 数组，不能用带引号的文本代替。

数组或对象中的成员结构以紧随其后的完整请求示例为准；示例中的嵌套对象保持原层级和字段类型。官方 L1/L2 支付预下单 JSON 由商户服务端内部构造，不属于本 Skill 的业务请求参数，Agent 不得将其放入首次业务 Body。

唯一的普通 JSON 首次请求：

POST https://api.qixiantech.com/api/bid-response-analyzer/v1.2.5
Content-Type: application/json

{
  "bid_document_text": "本项目采购企业信息化系统。投标人必须具有有效营业执照，须提供近三年同类项目业绩证明和项目负责人证书；投标文件不得晚于公告截止时间递交；本项目不接受联合体投标。投标人须按要求提交保证金、签章文件、实施方案、服务承诺和报价明细。缺少资格证明、保证金凭证或法定签章的投标文件将被否决。项目工期、验收标准、售后响应和数据安全方案均须逐条响应，任何负偏离必须在偏离表中明确说明。投标报价应覆盖实施、培训、维护、税费及其他履约成本。以上内容仅为已脱敏测试文本，正式投标必须逐页核对招标文件原件和最新澄清文件。",
  "bid_type": "government_procurement",
  "company_profile": "公司具有有效营业执照、企业软件项目实施团队、同类项目业绩、项目负责人及质量管理材料，可按要求提供证明文件。",
  "competitor_count_estimate": 5
}

上述唯一的 HTTP 代码块是完整首次请求，请求行、Content-Type 和 JSON Body 必须作为一个整体发送。首次请求无需自定义 Header，不携带 WeixinPay-Required、X-Out-Trade-No 或 Authorization；服务端会生成请求关联 ID。宿主只有在能够生成合法 UUID 时才可选传 X-Request-Id 或 X-Idempotency-Key，不得把文档占位文字作为 Header 值发送。

收到支付触发响应后，Agent 必须按以下顺序处理：

1. 从 WeixinPay-Required Header 读取 payment_code；只读取响应体的 Agent 从 WeixinPay["WeixinPay-Required"] 读取同一值。
2. 核对响应中的金额、币种和服务用途，并向用户展示付款信息。
3. 将该值作为 paymentCode 交给当前 Agent 宿主提供的腾讯 SkillHub 微信支付 AI 专属卡支付动作 weixinpay_pay。尚未绑定专属卡时，先按宿主界面完成绑定，再由用户确认支付。
4. 支付成功后，使用首次请求的原始业务 JSON，并携带原 WeixinPay-Required 和 X-Out-Trade-No 重试同一 URL。
5. 若本次响应协商到 ARC v2.1，Agent 必须安全保存 fulfillment.id、result_digest 及 extensions.signed_receipt；不得把签名凭证令牌显示给用户、写入普通日志或发送到无关服务。
6. 只有在已经收到有效 402 并已尝试唤起宿主支付动作后，才能根据宿主实际返回说明支付能力状态；不得用首次调用前的本地探测代替业务请求，不要重新创建订单，也不得伪造支付结果。

Agent响应契约多端适配

本 Skill 已接入 ARC v2.1，支持手机、PC、纯语音及具备空间显示能力的 AI 终端调用。同一次分析或交付的金额、结论、风险和依据保持一致，终端可以根据自身能力选择精简文本、无 Markdown 语音朗读稿、卡片、表格或空间化重点展示。

支持 ARC v2.1 的 Agent 可安全保存服务端签发的履约凭证，在凭证有效且未退款或吊销时，从其他设备取回同一次履约的原结果；取回不会创建新订单，也不会重复收费。

当前限制： 服务不会读取硬件信息，也不会自动识别真实设备类型，需要调用它的 AI Agent 主动声明自身支持的输入、显示和输出能力。服务提供的是适合朗读的文本，不直接生成音频；语音终端需要具备 TTS 或朗读能力。跨设备取回不是自动账号同步，必须由 Agent 安全保管签名履约凭证，或由可信宿主重新验证用户身份；仅知道微信身份标识、订单号或履约编号不能读取结果。

服务价格 ¥9.99/次。工具是投标文件初筛，不输出中标概率，不查询供应商信用库、历史中标库或竞争对手资料。

边界

• 支持 government_procurement、construction、it、consulting、goods。
• 不处理国家秘密、军事国防或用户无权披露的文件。
• 文本 200-100000 字符；公司简介 30-10000 字符。

Agent响应契约接入说明

本节供调用本 Skill 的 AI Agent 读取，普通用户无需填写或理解这些协议字段。设备能力不是由服务端猜测的：Agent 必须根据自身真实能力填写受限的能力声明，不得把浏览器标识、自由文本设备名或用户输入伪装成设备能力。

语音终端读取 presentation.speech_text 并自行朗读；屏幕终端读取结构化 result、extensions 和表现变体。result_digest 用于确认不同终端获得同一业务结果，fulfillment.id 用于识别同一次履约；Agent 不得从展示文案反向解析或修改金额、结论、风险、证据和支付状态。

当前版本已经接入 ARC v2.1，并继续兼容 ARC v2.0。两者都会把不可变业务结果与终端表现分开：同一已履约订单切换终端时不重新运行业务、不重新付款，result_digest 保持一致，仅 presentation 和 representation_id 可按能力变化。服务端协商到 2.1.0 时，还会签发限定当前 Skill、履约、结果摘要和有效期的可携带履约凭证。

已启用能力档案：PAY（支付与幂等履约）、ASSESS（结论与风险评估）、SCAN（扫描范围与定位）、BUNDLE（多文件资源包）、EVID（证据与适用边界）、PAGE（大结果分页与续读）、PRIV（隐私与共享显示）。

ARC v2 是兼容客户端可选的高级协商能力，不作为平台审核或普通调用的第二个首次请求示例。普通调用必须优先执行“Pay Skill 标准调用”中的唯一完整 HTTP 请求。明确支持 ARC v2 的客户端可以在同一精确版本业务接口上把 Content-Type 改为 application/vnd.qixiantech.skill-request+json;version=2，把 Accept 改为 application/vnd.qixiantech.skill-response+json;version=2，并采用下方请求信封；首次请求仍无需自定义 Header，可选请求 ID 或幂等键必须是宿主实际生成的合法 UUID。

ARC v2 请求信封结构：

{
  "contract_request": {
    "accepted_versions": [
      "2.1.0",
      "2.0.0"
    ],
    "accepted_profiles": [
      "payment@1",
      "assessment@1",
      "inspection@1",
      "resource-bundle@1",
      "evidence@1",
      "collection@1",
      "privacy@1"
    ]
  },
  "client_context": {
    "locale": "zh-CN",
    "input_modes": [
      "text"
    ],
    "output_modalities": [
      "text",
      "speech",
      "visual"
    ],
    "display_class": "standard",
    "formats": {
      "markdown": true,
      "tables": true,
      "cards": true,
      "links": true,
      "actions": true
    }
  },
  "input": {
    "bid_document_text": "本项目采购企业信息化系统。投标人必须具有有效营业执照，须提供近三年同类项目业绩证明和项目负责人证书；投标文件不得晚于公告截止时间递交；本项目不接受联合体投标。投标人须按要求提交保证金、签章文件、实施方案、服务承诺和报价明细。缺少资格证明、保证金凭证或法定签章的投标文件将被否决。项目工期、验收标准、售后响应和数据安全方案均须逐条响应，任何负偏离必须在偏离表中明确说明。投标报价应覆盖实施、培训、维护、税费及其他履约成本。以上内容仅为已脱敏测试文本，正式投标必须逐页核对招标文件原件和最新澄清文件。",
    "bid_type": "government_procurement",
    "company_profile": "公司具有有效营业执照、企业软件项目实施团队、同类项目业绩、项目负责人及质量管理材料，可按要求提供证明文件。",
    "competitor_count_estimate": 5
  }
}

支付后重试必须保持 input 不变，允许只切换合法的终端能力声明。request_id 回显当前 HTTP 请求，不作为履约身份；跨终端履约身份读取 fulfillment.id 和 result_digest。服务端未启用 ARC v2.1 时会从上述双版本声明中选择 2.0.0；如果运行中的 v2.1 新订单闸门暂时不可用，错误信封会通过 available_versions 和 retry_with_version 明确提示 2.0.0，Agent 不得在同一请求中自行篡改协商结果。

ARC v2.1 跨设备取回

1. 完成响应协商到 2.1.0 时，从 extensions.signed_receipt 保存 token、recovery_uri 和 expires_at，并同时保存 fulfillment.id 与 result_digest。token 是 bearer 授权凭证，必须按敏感信息保护。
2. 另一设备取回时，向凭证中的 recovery_uri 发起 GET，使用 Authorization: Bearer <token> 或 X-ARC-Fulfillment-Receipt: <token>，并发送该设备当前的 X-Request-Id。
3. 成功响应会返回 X-Skill-Replay: true；Agent 必须核对返回的 fulfillment.id 与 result_digest 和原履约一致。该请求只读取原结果，不创建订单、不触发支付。
4. 仅持有 OpenID、订单号、fulfillment.id 或 result_digest 均无权读取结果。凭证无效返回 401，结果记录不存在或已超过保留期返回 404，凭证因退款或安全事件被吊销返回 410；这些情况不得通过创建新订单伪装成原履约取回。

调用流程

1. 说明提交内容会通过 HTTPS 发往第三方服务；删除不必要的身份信息、密钥和商业秘密并取得用户同意。
2. 收集必填字段：bid_document_text、bid_type、company_profile。
3. 按实际情况收集可选字段：competitor_count_estimate、project_budget。
4. 在 SkillHub 展示 ¥9.99、服务用途和数据边界，取得用户明确付款确认。
5. 按“Pay Skill 标准调用”先请求业务接口；支持 ARC v2 的 Agent 可以改用“Agent响应契约接入说明”中的媒体类型和完整请求信封。

平台返回 HTTP 402 时

业务接口是公开的 Pay Skill 入口，不需要用户配置 API Key，也不携带Authorization。首次请求不携带 X-Out-Trade-No，也不要求自定义Header；服务端会生成请求关联 ID。宿主如能生成合法 UUID，可以选传X-Request-Id 或本次业务调用唯一的 X-Idempotency-Key，但不得把文档占位文字作为 Header 值。服务端完成微信支付 Native 下单和SkillHub AI 预下单后，会返回：

• HTTP 状态码：402
• Header WeixinPay-Required：支付码
• Header X-Out-Trade-No：商户订单号
• Body WeixinPay：兼容只读取响应体的 Agent
• v1 Body amount：9.99，currency：CNY
• ARC v2 extensions.payment.amount：999 分，currency：CNY

显式 ARC v2 调用的两个支付响应头保持不变；响应体同时包含官方顶层WeixinPay 兼容提示块，以及 status=action_required、result=null和 extensions.payment。支付事实以服务端生成的 extensions.payment 为准，WeixinPay 仅用于 SkillHub 和只读取响应体的 Agent 拉起支付，两处支付码必须一致。

官方兼容字段至少包含以下结构；服务端可以同时返回业务契约字段：

{
  "data": {
    "message": "本次调用需要付费"
  },
  "WeixinPay": {
    "WeixinPay-Required": "<payment_code>",
    "prompt": "本次使用微信支付，请将 WeixinPay-Required 的值作为 paymentCode 交给 weixinpay_pay，以向用户申请支付授权。"
  }
}

收到 402 后：

1. 保存两个响应头，核对金额为 ¥9.99、币种为 CNY；若首次请求选传了合法 X-Idempotency-Key，网络重发时复用该键。
2. 将 WeixinPay-Required 的值作为 paymentCode 交给当前 Agent 宿主提供的腾讯 SkillHub 微信支付 AI 专属卡支付动作 weixinpay_pay；尚未绑定专属卡时，先按宿主界面完成绑定，再由用户确认支付。首次业务请求前不得用本地依赖探测代替业务接口调用。
3. 支付成功后必须重新请求同一 URL；v1 的 JSON body 与首次请求逐字段一致。ARC v2 必须保持 input 不变，允许仅切换合法的 client_context。
4. 重试请求必须原样携带 WeixinPay-Required 和 X-Out-Trade-No 两个 Header。
5. 后端按 X-Out-Trade-No 向微信支付查单；只有 trade_state=SUCCESS、金额、商户号和 AppID 均匹配时才返回付费结果。
6. 返回 PAYMENT_REQUIRED 或 NOT_PAID 时等待原订单，不创建新订单；返回 REFUNDED 时告知已退款并终止。
7. 禁止伪造支付码、订单号或支付结果；ARC v2 不得修改原始 input。
8. 新的业务调用如选择使用幂等键，必须生成新的合法 UUID；已过期或已处理订单不得复用旧键。

支付后重试示例：

POST <与首次请求相同的 URL>
Content-Type: application/json
WeixinPay-Required: <402 响应中的 payment_code>
X-Out-Trade-No: <402 响应中的 out_trade_no>

<与首次请求完全一致的 JSON>

展示结果

原样展示 result_status、summary、score、grade、findings、recommendations、risks、missing_info、requirements、critical_gaps、joint_bid_status、competitor_count_estimate。

• 屏幕终端按 presentation 展示文本、表格或卡片；语音终端只朗读 presentation.speech_text。任何终端都不得为了适配展示而修改 result 中的金额、结论、风险或依据。
• Agent 应保留并可向用户展示 fulfillment.id、result_digest 和凭证到期时间，用于识别同一次履约和核对跨端结果；不得展示或复述 extensions.signed_receipt.token。
• 跨设备取回成功后应明确说明这是原履约结果，且未再次收费；退款、吊销、凭证过期或结果超过保留期时，应如实提示无法继续取回。
• score 是材料准备度，不是中标概率。
• grade=verify_before_bid 表示存在未被简介佐证的要求。
• 仅在 joint_bid_status=allowed 时可讨论联合体；forbidden 时不得建议联合体。

HTTP 402 按上方流程处理支付；400 先修正输入且确认字段类型、长度和枚举值后再重试，不要重复付款；409 订单或幂等键冲突时改用新的合法 UUID，或在首次请求中省略可选幂等键；410 表示订单已过期；429 按 Retry-After 等待；5xx 告知暂不可用。