PROGRAMIŚCI · WERSJA ZAPOWIEDZIOWA API

Jedno API do ustalenia, kto lub co działa

Wstępny opis proponowanego API Proof of Actor: na tyle konkretny, by pokazać, jak infrastruktura ma działać, i opublikowany na tyle wcześnie, by korzystający z niego programiści mogli wpłynąć na jego kształt.

Dołącz do programu Developer Preview

Rozwiązanie nie jest gotowe do wdrożenia produkcyjnego

Wersja przedpremierowa dla programistów@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
});

Wersja przedpremierowa dla programistów - projekt API jest rozwijany. Punkty końcowe, pola i nazwy pakietów na tej stronie są propozycjami. Nie ma jeszcze produkcyjnego API ani opublikowanego SDK.

Zakres proponowanego API

Pięć punktów końcowych, jedno poświadczenie

Żądaj danych potrzebnych w danym kontekście, przeanalizuj dowody i zastosuj własne zasady. Ten sam model obejmuje ludzi, ludzi korzystających z pomocy AI oraz agentów.

Utwórz weryfikację

POST/v1/verifications

Określ, czego wymaga interakcja: obecności człowieka, ciągłej kontroli, ujawnienia udziału AI i wymaganego zakresu ujawnienia tożsamości.

Proponowane API

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

Pobierz status aktora

GET/v1/verifications/{verification_id}

Sprawdź typ aktora i poziom pewności każdego twierdzenia. Twoje zasady określają, jak wykorzystać te informacje.

Proponowane 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
}

Zweryfikuj uprawnienia agenta

POST/v1/authority/verify

Sprawdź, czy konkretne działanie konkretnego agenta mieści się w zakresie upoważnienia udzielonego mu przez mocodawcę.

Proponowane 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
}

Wymagaj jednoznacznego potwierdzenia zamiaru przez człowieka

POST/v1/intent

Do działań o istotnych skutkach, które wymagają bezpośredniego zatwierdzenia przez człowieka: właśnie tego działania, w tym momencie i na tych warunkach.

Pobierz poświadczenie

GET/v1/attestations/{id}

Zwraca nadający się do przetwarzania maszynowego Actor Trust Receipt na potrzeby audytu i systemów korzystających z tych danych.

Actor Policy

Określ wymagania dotyczące zaufania

Aplikacje powinny móc określać swoje wymagania w postaci zasad. Kluczowa zasada architektoniczna: Proof of Actor dostarcza dowody pozwalające ocenić zaufanie. Klient ustala zasady akceptacji.

Proponowane APIKoncepcja silnika zasad

policy.require({
  actor: "human",
  presence: "continuous",
  control: 0.90,
  aiAssistance: "low"
});

policy.allow({
  actor: ["human", "authorized_agent"],
  agentAuthority: {
    required: true
  }
});

Zasady projektowania z myślą o programistach

Integracja powinna być łatwiejsza niż tworzenie własnej infrastruktury weryfikacyjnej.
Każdy wynik można wyjaśnić: twierdzeniom towarzyszą dowody i poziom pewności.
Żądaj tylko niezbędnych deklaracji; nie zbieraj niczego więcej.
Ludzie i agenci są równorzędnymi aktorami w tym samym API.
Uprawnienia agenta można zawsze cofnąć i są one zawsze sprawdzane dla każdego działania.

Cennik

Cennik nie jest publikowany w fazie badawczej. Nie ustalimy go ostatecznie, dopóki nie zrozumiemy, które podstawowe rodzaje weryfikacji przynoszą największą wartość. Możliwy przyszły model:

Dla programistów: Bezpłatne środowisko testowe
Twórz: Miesięczna opłata podstawowa + opłata za wykorzystanie
Skala: Ceny zależne od wykorzystania
Dla przedsiębiorstw: Duża skala + zaawansowane zasady + wdrożenie prywatne

Najczęstsze pytania

Pytania programistów

Czy mogę już zintegrować Proof of Actor?

Jeszcze nie. Proof of Actor jest w fazie rozwoju i nie ma produkcyjnej wersji API ani SDK. Punkty końcowe i wywołania SDK na tej stronie stanowią podgląd proponowanego projektu w ramach programu Developer Preview, opublikowany po to, by programiści mogli pomóc go kształtować.

Czy będzie dostępny SDK?

SDK jest elementem proponowanego zestawu narzędzi dla programistów. Pokazane tu nazwy pakietów i metod są przykładowe i mogą się zmienić przed wydaniem.

Jak będzie działać system opłat?

Cennik nie jest publikowany w fazie badawczej. Możliwe jednostki rozliczeniowe obejmują pojedynczą weryfikację, ciągłą sesję, pojedyncze poświadczenie oraz weryfikację upoważnienia, a dla programistów dostępne byłoby bezpłatne środowisko testowe. Nic nie zostało jeszcze ustalone.

Jak uzyskać dostęp?

Dołącz do programu Developer Preview. Powiedz nam, co chcesz weryfikować i jaka jest przybliżona liczba interakcji; wykorzystujemy te odpowiedzi do ustalania priorytetów prac projektowych i przyznawania wczesnego dostępu.

Pomóż kształtować API przed jego udostępnieniem.

Opisz, co chcesz zweryfikować i jakiej liczby interakcji to dotyczy. Uczestnicy programu Developer Preview jako pierwsi zapoznają się z projektem.

Dołącz do programu Developer Preview Zarejestruj przypadek użycia agenta