核心概念
六个概念，贯穿所有接口。
- Subject 主体
- 个人、机构、智能体或设备。所有调用都必须归属于一个可验证的主体。
- Memory 记忆
- 带来源、状态、版本和有效期的记忆条目。写入长期记忆需经本人确认（candidate → confirm）。
- Permission Decision 权限决策
- 针对「谁、为了什么目的、访问哪些字段」的一次显式判定，返回 allowedFields 与 deniedFields。
- Capability 能力令牌
- 一次性、限时、限目的的执行凭证。任务必须持有效令牌运行，可随时撤销。
- Task 任务
- 在授权边界内运行的一次协同任务，产生结果、回执和候选记忆。
- Audit Receipt 审计回执
- 本人可见的执行记录：时间、主体、目的、读取与未读取字段、模型、有效期与结果。
API 预览
接口与调用示例
全部标注 Developer Preview：接口名称与字段可能调整。示例中的主体、字段与返回值均为合成数据。
- POST
/v1/subjects创建主体（个人、机构、智能体或设备）
- POST
/v1/memories/candidates提交候选记忆，等待本人确认
- POST
/v1/memories/{id}/confirm本人确认候选记忆进入长期记忆
- POST
/v1/permissions/decisions请求一次最小权限决策
- POST
/v1/capabilities签发一次性、限时、限目的能力令牌
- POST
/v1/tasks在授权边界内创建协同任务
- GET
/v1/audit/receipts/{id}查询用户可见的审计回执
Developer Preview / 接口名称与字段可能调整。以上为概念性 API 设计预览，尚未正式开放，不代表已上线的生产接口。
创建协同任务（概念示例）Developer Preview
// 接口名称与字段可能调整，仅为设计预览
const task = await zhishen.tasks.create({
subject: "body_demo_001",
purpose: "health_risk_check",
requestedMemory: ["allergy", "current_medication"],
requireHumanConfirmation: true
});
// 返回结果（节选）
{
decisionId: "pd_demo_8f2a",
allowedFields: ["allergy", "current_medication"],
deniedFields: ["medical_records_full"],
capabilityExpiresAt: "2026-03-14T01:30:31Z",
auditReceiptId: "ar_demo_51c9"
}常见问题
技术团队最常问的四个问题
是否支持不同的模型？
是。模型通过 Model Router 接入，按能力、隐私、地区、质量、成本和延迟路由。平台不绑定单一模型厂商，模型可插拔、可替换。
如何接入我们现有的智能体？
行业智能体通过 Agent Gateway 接入，凭能力令牌在授权边界内读取信息和执行任务，无需推倒现有实现。接入规范随开发者预览提供。
数据可以留在本地吗？
可以。智身云支持私有化部署与地区节点，数据驻留边界在权限决策与模型路由层强制执行。
如何获得开发者文档和测试环境？
当前处于 Developer Preview 阶段，通过下方「申请开发者预览」提交信息，我们会按批次开放测试环境与文档。