慧问答

概述

通过慧查税服务获取财税专业问答。每次成功获取回答按 0.01 元/次 结算。

付费前置检查

调用本 Skill 前，检查当前 Agent 是否已安装并可调用 weixinpay_pay 支付能力：

• 已安装：继续调用服务。
• 未安装：明确告知用户“当前 Agent 暂不支持微信支付付费能力”，停止本次调用；不要尝试绕过支付或输出未支付的付费结果。

接口定义

• 地址：https://huichashui.com/api/skill-pay/resource/hui-tax-chat
• 方法：POST
• 请求头：Content-Type: application/json
• 请求体：

{
  "query": "销售货物取得含税收入 113 万元，如何计算销项税额？"
}

query 为用户的财税问题。应保留用户原始意图和必要上下文，不要虚构企业数据、税率、法规或业务事实。

付费调用流程

1. 首次请求资源

使用用户问题发送 POST 请求。若服务直接返回 code: "SUCCESS"，按“支付后交付”处理。

2. 处理待支付响应

若收到 HTTP 402 Payment Required：

1. 从响应 Header 提取 WeixinPay-Required，作为 paymentCode。
2. 从响应 Header 提取 X-Out-Trade-No，作为本次订单号；必须保存。
3. 调用 weixinpay_pay(paymentCode=<WeixinPay-Required 的值>)，向用户申请微信支付授权。
4. 只有在支付能力确认成功后，才进入下一步；支付取消、失败或超时时不得交付付费回答。

3. 支付成功后重新请求（必须执行）

使用与首次完全相同的请求体再次请求同一地址，并增加 Header：

X-Out-Trade-No: <首次响应中的订单号>

支付成功并不等于已经拿到答案。只有带原订单号重试后，服务才会校验订单并返回付费产物。不要重新创建订单，也不要修改 query。

4. 支付后交付

成功响应格式：

{
  "code": "SUCCESS",
  "out_trade_no": "...",
  "answer": "慧问答的完整回答",
  "legalBasis": [
    {
      "id": "法规ID",
      "title": "法规标题"
    }
  ]
}

将 answer 作为核心交付内容返回给用户；如 legalBasis 非空，一并列出法规标题。若数组为空，不得虚构法规依据。

异常处理

• 402 响应缺少 WeixinPay-Required 或 X-Out-Trade-No：告知用户支付初始化失败，不要盲目重试或猜测订单信息。
• 支付未完成：告知用户未完成支付，结束本次流程。
• 支付后重试未返回 SUCCESS：保留订单号并提示服务端订单校验或履约异常；不要重复支付。
• 同一订单重复请求：使用相同的 X-Out-Trade-No 重试，服务端会幂等返回既有结果。