用途
该技能用于操作账户关联的 Persona 身份验证（Inquiry）与会话（Session）生命周期，从创建到安全恢复。适用于实现客户身份验证旅程的场景。其核心思路是把 Inquiry 建模为持久化的服务端工作流：在支持账户自动创建时关联客户引用，仅在客户端需要时签发会话，并且不假设恢复操作无害或无限次。
主要能力
- 解析内部主体，查找已有的 Persona 账户或活跃 Inquiry，并通过主体范围的操作锁防止并发重复创建。
- 创建 Inquiry：使用单一模板选择器、按需设置 meta.auto-create-account-reference-id，并携带持久化幂等键，可选请求初始 Inquiry 会话。
- 安全交付会话：读取 meta['session-token']，将其绑定到预期主体与客户端，从日志中脱敏，并应用应用侧过期与单次交付策略。
- 观察生命周期事件：以受验证的 Webhook 作为主要信号，GET 对账作为恢复路径，持久化 Persona 事件 ID 与创建时间。
- 按需恢复：对符合条件的待处理 Inquiry 调用 /inquiries/:id/resume 并读取 meta.session-token，避免主动恢复（Inquiry 默认最多 25 次会话）。
- 关闭领域决策：将观察到的 Inquiry 与验证证据映射为单独审查的业务决策，明确重试、人工审核与终态。
使用方式
服务端生命周期调用使用环境 bearer key 与带日期的 API 版本。Inquiry 会话令牌是短期的客户端能力，不得视为 API 密钥或写入日志。工具纪律方面：在提出变更前，使用 Read 与 Grep 检查应用配置、提供方文档、fixtures、schema、测试与脱敏后的运行证据；仅对已批准的实现、配置、测试、runbook 或脱敏回执使用 Write 或 Edit。未经操作员明确批准，不得创建、恢复、批准、拒绝、脱敏、轮换、撤销、部署或以其他方式变更生产 Persona 资源。
适用场景
适用于需要实现客户身份验证旅程、管理账户关联 Inquiry 与会话生命周期的服务端集成场景，例如回头客请求继续待处理的验证流程。
限制
- 恢复操作并非无害或无限：Inquiry 默认最多 25 次会话，需在达到上限前升级处理。
- 重复活跃 Inquiry 时应停止创建，按内部主体与账户对账并选择权威 Inquiry。
- 恢复被拒绝时，应读取当前 Inquiry 状态与会话历史，不得循环或自动创建替代项。
- 成功的请求并不证明身份决策成功，需对照关联的第一方证据、固定 API 版本、脱敏契约 fixtures、预期失败路径以及文档化的回滚或人工处置路径进行验证。
- 输出时不得暴露 bearer key、Webhook 密钥、Inquiry 会话令牌、原始身份文档或不必要的 PII。
输出内容
- 主体到账户到 Inquiry 的谱系
- 会话签发与恢复台账
- 观察到的生命周期与领域决策回执
返回环境、资源与事件标识符、API 版本、模板上下文、源契约指纹、证据、未解决风险、回滚状态与最终决策，同时不暴露敏感凭据与 PII。
前置条件
- 已批准的 Inquiry 模板与账户关联策略
- 从内部主体到 Persona 账户与 Inquiry ID 的持久化映射
- 会话令牌交付与过期控制
资源
- 第一方来源说明
- API 介绍
- API 快速入门
- API 密钥
- 速率限制
- Webhook 最佳实践
- 请求幂等性