身份证信息查询 - 聚合数据

技能描述

当用户想要根据身份证号码查询证件相关信息，包括性别、出生日期、户口所在地时，使用此技能。本 Skill 提供身份证号码信息查询能力。该服务是基于 A2M 智能收协议（HTTP 402）的付费资源。买家（消费者 Agent）通过本 Skill 向卖家服务端发起资源请求，服务端将返回 402 Payment-Needed 响应报文，买家需将该报文传递给支付宝的 alipay-payment-skill 技能以完成付款。

必要依赖检查

本技能依赖于支付宝AI付技能，需要优先检查技能是否安装，如未安装，需要从clawhub上安装这两个技能：alipay-authenticate-wallet 和 alipay-payment-skill，安装后检查是否已开启支付宝支付功能，如未开启，需要提示用户开启支付宝支付功能。

触发条件

• 用户请求查询身份证号码相关信息
• 用户需要获取身份证号对应的性别、出生日期、户口所在地等信息
• 用户提供或需要验证某个身份证号码的基本信息

工作流程

第一步 收集身份证号码

当用户需要查询身份证号码相关信息时，先提示用户输入需要查询的身份证号码。

第二步：请求资源

向用户展示待查询的参数，用户确认后，向以下 URL 发起请求，且请求体是json字符串，请严格按照以下格式填写：

curl https://apis.juhe.cn/a2a/query
    -d '{"resourceId":"38","data":{"cardno":"\x3C需要查询的身份证号>"}}'
    -H "Content-Type: application/json"

第三步：处理 402 响应

收到状态码为 402 的响应报文（包含 Payment-Needed 响应头）后，将整个 402 响应报文传递给支付宝的 alipay-payment-skill 技能，引导用户完成付款。

提交支付请求后，提示用户支付待确认时，需要展示用户订单号，方便用户核实订单情况。

第四步：后续流程

完全转移到 alipay-payment-skill 技能的工作流,提示支付待确认的信息时，需要包含用户订单号。

异常情况处理

• 用户拒绝付款：尊重用户选择，告知用户该内容为付费资源，如需获取请完成支付。
• 请求返回非 402 状态码：如返回 200，直接展示内容；如返回 4xx/5xx 错误，告知用户服务暂时不可用，建议稍后重试。
• 其余异常情况将由 alipay-payment-skill 技能处理。

Agent 约束

• 禁止缺必填参数发起请求；
• 402 响应报文必须完整透传，不可篡改、删减；
• 严格遵循既定流程与异常规则，禁止自定义逻辑。

使用示例

用户: 帮我查一下身份证号 320505199001011234 的信息

助手: 好的，我来帮你查询该身份证号码的相关信息，包括性别、出生日期、户口所在地。

[执行 curl 请求]

[收到 402 响应后]

这是一个付费资源，需要完成支付才能获取查询结果。正在调用支付宝支付技能...

[调用 alipay-payment-skill]

隐私说明

• 本技能仅用于查询身份证号码对应的基本信息
• 请确保查询行为符合相关法律法规
• 不要用于非法用途或侵犯他人隐私

Agent 约束

• 禁止缺必填参数发起请求；
• 402 响应报文必须完整透传，不可篡改、删减；
• 严格遵循既定流程与异常规则，禁止自定义逻辑。