本文へ移動
Proof of Actor

開発者向け · API プレビュー

誰が、または何が行動しているかを把握するための単一のAPI

提案中のProof of Actor APIのプレビュー。インフラの動作設計を示せるだけの具体性を備え、利用する開発者が設計に関われるよう早期に公開しています。

Developer Previewに参加
本番環境では利用できません
開発者向けプレビュー@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つのエンドポイント、1つのアテステーション

状況に応じて必要な情報を要求し、証拠を確認して、ポリシーを適用します。同じモデルで、人間、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
}
03

エージェントの権限を検証

POST/v1/authority/verify

特定のエージェントによる特定の行為が、本人または組織から委任された権限の範囲内かどうかを確認します。

提案段階の API
POST /v1/authority/verify
{
  "agent_id": "agt_48291",
  "requested_action": {
    "type": "purchase",
    "amount": 420,
    "currency": "USD"
  }
}

{
  "agent": "verified",
  "principal": "verified",
  "mandate": "valid",
  "action_authorised": true,
  "maximum_amount": 500
}
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は、提案段階にある開発者向け利用環境の一部です。ここに示すパッケージ名とメソッドは例示であり、リリース前に変更される可能性があります。

料金体系はどうなりますか？

研究段階では料金を公開していません。想定される課金単位には、検証ごと、継続セッションごと、Actor Attestationごと、権限の検証ごとがあり、開発者向けの無料サンドボックスも検討しています。いずれも未確定です。

利用するにはどうすればよいですか？

Developer Previewにご参加ください。何を検証したいか、やり取りのおおよその件数をお知らせください。いただいた回答を、設計と早期アクセスの優先順位付けに役立てます。

公開前のAPI設計に参加する。

何を検証したいか、また対象となるやり取りがどの程度の件数かをお知らせください。Developer Previewの参加者には、設計を先行して公開します。

Developer Previewに参加エージェントのユースケースを登録する