SuperAPI AI 工具集

persona-hello-world

测试与质量

查看项目

更新于 10-15 23:28

技能介绍

用途:在 Persona 沙箱中证明“创建并读取”这一最小 API 路径可用,用于验证新集成路径是否打通。成功响应只证明传输与契约兼容,不代表某人通过了身份验证。

前置条件:沙箱 API key、已审阅并固定日期的 API 版本、已启用的沙箱 inquiry 模板 ID、合成测试身份数据,以及持久且唯一的 operation ID。

用法步骤:一,选择创建契约,在 inquiry-template-id、inquiry-template-version-id 或受支持的模板选择器中只用其一;除非受控测试刻意锁定版本,优先用稳定模板 ID。二,生成可重放安全的意图:Idempotency-Key 由 operation ID 生成,而非个人或引用 ID;发送 POST 前先持久化请求指纹。三,按需关联账户:自动创建账户时使用 meta.auto-create-account-reference-id;仅当客户端需要即时会话时才用 meta.auto-create-inquiry-session。四,检查 JSON:API 结果:核对 data.type、inquiry ID、status、模板关系及可选 meta['session-token'];新增字段和类型视为兼容性新增。五,读取并处置:GET 该 inquiry,比对 ID 与 status,保留脱敏回执。除非观测到的 inquiry 与验证状态支持,否则不得声称通过、失败或完成。

认证:沙箱 bearer API key 请求 https://api.withpersona.com/api/v1,并显式指定已审阅的 Persona-Version。session token 在通过受保护通道交付给目标客户端前应保留在服务端。

工具纪律:修改前用 Read 与 Grep 检查应用配置、供应商文档、fixtures、schema、测试和脱敏运营证据;Write 或 Edit 仅用于已批准的实现、配置、测试、runbook 或脱敏回执。未经操作者明确批准,不得创建、恢复、批准、拒绝、脱敏、轮换、撤销、部署或以其他方式变更生产 Persona 资源。

输出:一份脱敏的创建请求指纹与 inquiry ID;观测到的 inquiry 状态与可选 session-token 处置情况;与身份结果分离的通过/失败冒烟测试回执;连同环境、资源与事件标识、API 版本、模板上下文、源契约指纹、证据、未决风险、回滚状态与最终决策一并返回,且不得暴露 bearer key、webhook secret、inquiry session token、原始身份文档或非必要 PII。

错误处理:400 创建错误时检查 JSON:API 结构与模板选择器互斥性及环境归属;409 或重放不匹配时比对已存请求指纹,切勿在参数变更后复用同一幂等键;inquiry 保持 pending 属有效传输结果,应使用沙箱控制或受支持客户端流程,而非臆造通过。

限制:本技能只覆盖沙箱冒烟路径,成功请求不构成身份决策通过的证明;缺失事实暂未提供。