跳转到主要内容
工作原理

Proof of Actor 如何工作。

从传入交互到 application 决策的 evidence-first 路径。

policy · example-app.test
  • /api/v1/catalogenforce智能体允许 · 结构化 API
  • /support/ticketsenforce人类 + AI允许 · 标记为 Human + AI
  • /account/*preview未知保留现有检查
  • /api/v1/orderspreview智能体要求更强的凭据

从交互到决策

  1. 01应用请求或事件一次页面浏览、一次 API 调用、一次 MCP 工具调用,或一次应用内操作。
  2. 02来自受支持集成的信号仅限该集成在该上下文中能够观察到的内容。
  3. 03证据标准化和分类信号会被检查、按依据标注并合并。
  4. 04带依据和不确定性的 Actor 结果人类、人类 + AI、agent 或 Unknown,以及其依据。
  5. 05dashboard 和分析供你的团队审阅的趋势、路由和证据。
  6. 06您的应用自身的决定仅观察,或应用你选择的策略。
面向开发者

What your code receives

Every interaction resolves to one result record. Your application reads the class and the basis and applies its own policy.

Result record
{
  "route": "GET /api/v1/catalog",
  "class": "agent",
  "basis": "verified",
  "evidence": [
    { "signal": "http_message_signature", "result": "valid", "keyid": "assistant.example" },
    { "signal": "client_declaration", "value": "assistant.example" }
  ],
  "observed_at": "2026-11-13T10:42:07Z"
}
class
Human、Human + AI、Agent 或 Unknown。
basis
证据有多强:Verified、Declared、Inferred 或 Unknown。
evidence
结果背后的信号,让您的团队看清原因。

从观察模式开始: 将结果记录在日志旁边,在您选择 policy 之前不做任何更改。 阅读 Node.js 集成指南

Observation mode 是默认模式

安装 Proof of Actor 不会阻止或更改任何请求。结果会被记录下来,方便你的团队与真实的应用结果进行比较,查看误报,并判断是否需要应用任何 policy。

证据类型

可用证据取决于集成和上下文。每个工作流的检查会在 onboarding 期间与团队达成一致,而信号内部细节保持私密,因此更难被模仿。

  • 请求签名

    来自发布其密钥的自动化客户端的密码学签名。

  • 声明

    客户端自称为 Agent,或在你的应用内披露 AI 协助。

  • 交互信号

    来自获批浏览器采集器的信号,位于其运行的页面上。

  • 请求上下文

    服务端集成可用的请求头和协议细节。

agent 身份不等于授权

来自自动化客户端的签名请求可以表明该请求是使用与已发布标识符相关联的密钥签署的,例如运营方的域名。这是有关哪个客户端发出该请求的有用证据。

它不会显示是谁指示了该 agent,是否有人将权限委托给它,背后的法律身份是谁,或者该操作是否安全。这些都是由您的应用通过自身的认证、授权和策略来回答的独立问题。

三个独立的问题
  • 谁在调用?Proof of Actor:签名、声明或推断
  • 哪个凭证?您的 API 密钥、OAuth 令牌或会话
  • 它可能会做什么?您的授权和策略

路由决策如何融入其中

你的应用调用 Proof of Actor,接收结果,并应用自己的规则。你可以按 route 和风险级别选择集成是 fails open(请求按没有 Proof of Actor 时的方式继续)还是 fails closed(应用你现有的更强检查)。

  • API 超时

    如果结果未能及时返回,你的集成将使用你为该路由选择的回退方案。超时绝不会变成人类结果。

  • 缺少遥测

    如果浏览器采集器未运行或某个信号缺失,结果会如实反映这一点。缺失的证据会降低可下结论的程度,它不会被视为可疑。

  • 未知分类

    Unknown 是正常结果。你的政策定义每条路由中的 Unknown 代表什么,例如: 允许公开页面,保留账户变更的现有检查。

  • 过期证据

    证据有其时间和范围。会话早些时候的结果不应在没有重新检查的情况下用于后续更敏感的操作。

beta 集成工作流

  1. 01申请请告诉我们有关该 app 以及你想了解的交互。
  2. 02范围确认集成、路由、使用限制和数据处理方式。
  3. 03以观察模式集成你的 app 响应方式不变。
  4. 04验证将结果与已知的真实基准对比: 覆盖率、未知率、误报、延迟。
  5. 05决定仅在证据支持的地方启用策略。

我们与创始团队一起衡量什么

在每个支持的上下文中, 覆盖率、未知率、相对于已知结果的误报以及新增延迟。

从观察模式开始。

申请加入 founding developer program。

想先聊聊? 联系创始人