发起托管身份核验，不把证件放进AI对话

问题：证件进入了错误的渠道

当身份入驻流程经由AI助手进行时，最省事的做法往往最糟糕：让用户直接在对话中上传身份证件或自拍照。对话记录会以核验流程无法控制的方式被存储、分享和审阅。替代方案是托管流程：你的服务，或代表服务行事的助手，申请一个核验链接；本人打开链接，在那里完成身份与活体步骤。助手自始至终看不到任何证件或人脸图像。你要做的决定并不是开发哪种摄像头组件，而是应用应当发送哪几个值，以及读回结果时应当信任哪些值。尽早划清这条边界，可以让敏感图像远离日志、提示词和客服工单，避免日后难以清理的数据残留。

产品契约的明确内容

根据经过审阅的产品契约，托管身份任务接收三个输入：主体授权引用、稳定的请求UUID，以及明确的试用或付费模式。助手对话中不得出现任何证件或人脸。输出为托管URL、任务状态和权威完成状态。所列工具为production_capabilities、start_identity_onboarding、get_production_verification和refresh_production_verification。其中最重要的有两点。第一，完成身份与活体步骤的是本人，而不是助手。第二，Approved并不授予应用权限；获批的人能做什么，由你自己的规则决定。契约也记录了限制：新用户完整通过托管流程的验收仍处于待定状态；在线购买需要支付渠道验收通过。商户执行需要当前有效的能力、授权以及已接受的报价。文档本身并不能证明发生过真实核验，也不代表存在任何客户。

假设场景与fixture预期输出

以下为假设场景：一个小型SaaS团队要新增一位卖家。其入驻服务记录卖家的授权引用，在任何调用之前生成并保存一个请求UUID，并明确选择试用模式，然后请求发起托管流程。在所提供的合成契约示例中，不会向真实服务商发出任何请求，预期fixture输出严格为：status pending、hosted_url null、verified false、automatic_business_approval false。请逐字理解每个字段。status pending表示任务已存在，但尚无最终结果。hosted_url null表示暂时没有可展示给本人的链接，因此界面不应渲染失效按钮，更不能自行编造链接。verified false并非拒绝，只说明核验尚未完成。automatic_business_approval false确认即便之后获批，也不会自动开通卖家权限。这只是合成契约示例，不是真实验收；fixture被允许运行，并不等于获得业务许可。

提议的应用设计

以下是我们提议的设计，并非产品已实现的行为。在发起之前，把请求UUID与主体引用一起持久化，这样重试时会复用同一请求，而不会创建第二个流程。将任务状态以pending保存，并设置本地截止时间。只有当任务返回非空的托管URL时，才把它展示给本人，并通过你自己的界面发送，绝不在对话中索要图像。本人完成流程后，使用get_production_verification读取权威完成状态，而不是相信浏览器跳转或助手发来的消息。保留一个独立的业务决策步骤：权威的Approved只是卖家策略的一个输入，策略还需核对租户、用户以及所请求的操作。日志只记录UUID、状态和结果，绝不记录证件内容。

失败处理

对每一条非理想路径都要明确规划。如果hosted_url一直为null，就保持任务为pending，并告知本人链接尚未就绪；不要用新的UUID再建一个请求。如果回调始终没有到达，前文示例中的本地恢复模式会在截止时间到达时让待定任务过期；它不会轮询服务商，因此对原任务执行refresh应当是一个经过授权的、有意为之的步骤。fixture事件只接受合成回调，不接受真实签名，所以fixture通过并不能说明生产环境中的签名校验是否正确。如果状态为Declined或未完成，应予以记录并转交人工审核，而不是静默重试。如果仍有人把证件发到对话里，不要转发，而是引导其使用托管链接。如果缺少模式参数，应拒绝发起，而不是猜测试用或付费。

验收清单

在宣布该集成可以进入试点之前，请逐项确认：请求携带主体授权引用、已保存的请求UUID和明确的模式；任何提示词、对话记录或日志中都没有证件或人脸图像；fixture返回status pending、hosted_url null、verified false和automatic_business_approval false；界面在hosted_url为空时不会出现失效链接；重试复用同一个UUID；完成状态读取自权威状态，而非页面跳转；Approved必须经过你自己的权限规则，绝不直接授予访问权；恢复流程在本地过期，不轮询服务商；团队记录中注明新用户完整获批的验收仍待完成，且购买取决于支付渠道验收。清单全部通过，只说明你的处理逻辑是可靠的，并不代表已经发生过真实核验。

检查这项功能

https://gridzen.ai/tools/hosted-identity/ · 核对输入、输出与能力边界。以下命令只读取产品说明，不执行真实请求。

gridzen tools --product hosted-identity

来源与范围

https://gridzen.ai/tools/hosted-identity/ https://gridzen.ai/guides/current-capabilities/ 依据已检查的来源快照与本地模拟；建议的业务规则属于设计建议，不代表已证明的生产行为。内容使用 AI 辅助写作，并经过独立审稿。