开发者预览计划@proofofactor/sdk
import { ProofOfActor } from "@proofofactor/sdk";
const actor = await ProofOfActor.verify({
require: [
"human_presence",
"human_control",
"session_continuity"
]
});
if (actor.humanControl > 0.90) {
allow();
}
// For agents
const authority = await ProofOfActor.verifyAuthority({
agent,
action
});开发者预览计划 - API 设计仍在演进。本页面中的端点、字段和软件包名称均为提案。目前尚无生产环境 API，也尚未发布 SDK。
拟议中的 API 接口范围
5 个端点，一份证明
根据具体场景请求所需信息，读取证据，并应用你的策略。同一模型适用于人类、AI 辅助的人类和智能体。
01
创建验证
POST/v1/verifications
声明交互要求：真人在场、持续控制、披露 AI 使用情况、身份披露级别。
拟议中的 API
POST /v1/verifications
{
"requirements": {
"human_presence": true,
"continuous_control": true,
"ai_disclosure": true
}
}02
获取行为主体状态
GET/v1/verifications/{verification_id}
查看行为体类型及每项判断的置信度。如何据此采取行动，由你的策略决定。
拟议中的 API
GET /v1/verifications/{verification_id}
{
"actor_type": "human",
"confidence": 0.97,
"human_presence": "verified",
"human_control": 0.94,
"ai_participation": "low",
"continuity": 0.99
}04
请求明确的人类意图
POST/v1/intent
适用于需要真人在此时、依照这些条件直接批准当前操作的重大操作。
05
获取证明
GET/v1/attestations/{id}
返回供审计和下游系统使用的机器可读 Actor Trust Receipt。
Actor Policy
声明你的信任要求
应用应能够通过策略声明自身要求。关键的架构原则是：Proof of Actor 提供信任证据，由客户决定可接受的策略。
拟议中的 API策略引擎概念
policy.require({
actor: "human",
presence: "continuous",
control: 0.90,
aiAssistance: "low"
});
policy.allow({
actor: ["human", "authorized_agent"],
agentAuthority: {
required: true
}
});面向开发者的设计原则
- 集成过程应该比自行构建内部验证基础设施更简单。
- 每项结果均可解释：判断附有证据和置信度。
- 只请求所需的声明，不收集其他信息。
- 在同一个 API 中，人类和智能体都是一等行动主体。
- 代理权限始终可撤销，且每次操作都会核验。
定价
研究阶段尚未公布定价。在明确哪些验证能力最有价值之前，我们不会敲定定价。未来可能采用以下模式：
- 开发者
- 免费沙盒环境
- 构建
- 月度基础费用 + 用量费用
- 规模化
- 按用量计费
- 企业版
- 用量 + 高级策略 + 私有化部署
常见问题
开发者常见问题
现在可以集成 Proof of Actor 吗？
尚未。Proof of Actor 仍在开发中，目前没有可用于生产环境的 API 或 SDK。本页展示的端点和 SDK 调用是拟议设计的开发者预览版，发布这些内容是为了让开发者参与完善设计。
会提供 SDK 吗？
SDK 是拟议开发者体验的一部分。此处展示的软件包名称和方法仅供示意，在发布前可能变更。
定价方式是什么？
研究阶段尚未公布定价。可能的计费单位包括按次验证、按持续会话、按证明声明以及按权限验证计费，并为开发者提供免费沙盒。一切尚未确定。
如何获取访问权限？
加入开发者预览计划。请告诉我们您希望核验什么，以及大致的交互量；我们会据此确定设计和早期访问的优先顺序。