개발자 · API 프리뷰

누가 또는 무엇이 행동하는지 확인하는 단일 API

제안된 Proof of Actor API의 미리보기입니다. 인프라가 어떻게 작동하도록 설계되었는지 구체적으로 보여주면서, 실제로 이를 사용할 개발자들이 설계에 의견을 반영할 수 있도록 일찍 공개했습니다.

운영 환경에서 사용할 준비가 되지 않음

개발자 프리뷰@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의 도움을 받는 사람, 에이전트를 포괄합니다.

검증 생성

POST/v1/verifications

상호작용에 필요한 요건을 명시합니다. 사람의 현재 참여, 지속적인 통제, AI 사용 여부 공개, 신원 공개 수준입니다.

제안된 API

POST /v1/verifications
{
  "requirements": {
    "human_presence": true,
    "continuous_control": true,
    "ai_disclosure": true
  }
}

행위자 상태 조회

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
}

에이전트 권한 검증

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
}

명시적인 사람의 의사 확인 요청

POST/v1/intent

중대한 행위에 대해 지금 이 조건에서 해당 행위를 직접 승인하도록 사람에게 요구하는 경우를 위한 것입니다.

증명 정보 조회

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 호출은 제안된 설계의 Developer Preview로, 개발자들이 설계에 참여할 수 있도록 공개되었습니다.

SDK가 제공되나요?

SDK는 제안된 개발자 경험의 일부입니다. 여기에 표시된 패키지 이름과 메서드는 예시이며, 출시 전 변경될 수 있습니다.

요금은 어떻게 책정되나요?

연구 단계에서는 요금을 공개하지 않습니다. 검증 건별, 연속 세션별, 증명서별, 권한 검증 건별 과금이 가능한 기본 단위에 포함될 수 있으며, 개발자를 위한 무료 샌드박스도 제공될 수 있습니다. 확정된 내용은 없습니다.

어떻게 이용할 수 있나요?

개발자 프리뷰에 참여하세요. 무엇을 검증하려는지와 대략적인 상호작용 건수를 알려주세요. 답변을 바탕으로 설계 및 조기 접근의 우선순위를 정합니다.

API가 출시되기 전에 설계에 참여하세요.

무엇을 검증하려는지, 관련 상호작용의 규모는 어느 정도인지 알려주세요. Developer Preview 참여자는 설계를 먼저 확인할 수 있습니다.

개발자 프리뷰 참여하기 에이전트 활용 사례 등록