ENTWICKLER · API-VORSCHAU

Eine API, um zu bestimmen, wer oder was handelt

Eine Vorschau auf die vorgeschlagene Proof of Actor API: konkret genug, um zu zeigen, wie die Infrastruktur funktionieren soll, und frühzeitig veröffentlicht, damit die Entwickler, die sie nutzen werden, sie mitgestalten können.

Am Developer Preview teilnehmen

Nicht bereit für den Produktivbetrieb

Entwickler-Vorschau@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
});

Entwickler-Vorschau - Das API-Design wird weiterentwickelt. Die Endpunkte, Felder und Paketnamen auf dieser Seite sind Vorschläge. Es gibt noch keine produktive API und kein veröffentlichtes SDK.

Vorgeschlagene API-Schnittstelle

5 Endpunkte, eine Attestierung

Fordern Sie an, was Ihr Anwendungsfall erfordert, prüfen Sie die Nachweise und wenden Sie Ihre Richtlinie an. Dasselbe Modell gilt für Menschen, AI-unterstützte Menschen und Agenten.

Verifizierung erstellen

POST/v1/verifications

Legen Sie fest, was die Interaktion erfordert: Anwesenheit eines Menschen, durchgehende Kontrolle, Offenlegung des Einsatzes von AI und Grad der Identitätsoffenlegung.

Vorgeschlagene API

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

Akteurstatus abrufen

GET/v1/verifications/{verification_id}

Lesen Sie den Akteurtyp und das Konfidenzniveau jeder Aussage. Ihre Richtlinie bestimmt, wie damit umzugehen ist.

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

Befugnis des Agenten prüfen

POST/v1/authority/verify

Prüfen, ob eine bestimmte Handlung eines bestimmten Agenten durch das Mandat gedeckt ist, das ihm sein Auftraggeber erteilt hat.

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

Ausdrückliche Willensbekundung eines Menschen anfordern

POST/v1/intent

Für folgenreiche Handlungen, die eine direkte menschliche Zustimmung zu genau dieser Handlung, zu diesem Zeitpunkt und unter diesen Bedingungen erfordern.

Attestierung abrufen

GET/v1/attestations/{id}

Gibt den maschinenlesbaren Actor Trust Receipt für Audits und nachgelagerte Systeme zurück.

Actor Policy

Legen Sie Ihre Vertrauensanforderungen fest

Anwendungen sollten ihre Anforderungen als Richtlinie festlegen können. Das zentrale Architekturprinzip: Proof of Actor liefert Vertrauensnachweise. Der Kunde legt fest, welche Richtlinie für ihn akzeptabel ist.

Vorgeschlagene APIKonzept einer Richtlinien-Engine

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

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

Gestaltungsprinzipien für Entwickler

Die Integration sollte einfacher sein, als eine eigene Verifizierungsinfrastruktur aufzubauen.
Jedes Ergebnis ist nachvollziehbar: Aussagen enthalten Belege und Konfidenzwerte.
Fordern Sie nur die Nachweise an, die Sie benötigen, und erheben Sie keine weiteren Daten.
Menschen und Agenten sind in derselben API gleichwertige Akteure.
Die Befugnis eines Agenten ist jederzeit widerrufbar und wird bei jeder Aktion überprüft.

Preise

Während der Forschungsphase werden keine Preise veröffentlicht. Wir legen das Preismodell erst fest, wenn wir wissen, welche Arten von Verifizierung den größten Nutzen bieten. Ein mögliches späteres Modell:

Entwickler: Kostenlose Testumgebung
Entwickeln: Monatlicher Grundbetrag + nutzungsabhängige Kosten
Skalierung: Nutzungsabhängige Preise
Unternehmen: Volumen + erweiterte Richtlinien + private Bereitstellung

Häufig gestellte Fragen

Fragen von Entwicklern

Kann ich Proof of Actor schon heute integrieren?

Noch nicht. Proof of Actor befindet sich in der Entwicklung; es gibt weder eine produktive API noch ein produktives SDK. Die Endpunkte und SDK-Aufrufe auf dieser Seite sind eine Developer Preview des vorgeschlagenen Designs, die veröffentlicht wurde, damit Entwickler es mitgestalten können.

Wird es ein SDK geben?

Ein SDK ist Teil der geplanten Entwicklerumgebung. Die hier gezeigten Paketnamen und Methoden dienen der Veranschaulichung und können sich vor einer Veröffentlichung ändern.

Wie wird die Preisgestaltung funktionieren?

Während der Forschungsphase werden keine Preise veröffentlicht. Mögliche Abrechnungseinheiten sind einzelne Verifizierungen, durchgehende Sitzungen, Attestierungen und Prüfungen der Befugnis. Für Entwickler könnte es eine kostenlose Sandbox geben. Nichts davon steht fest.

Wie erhalte ich Zugang?

Nehmen Sie am Developer Preview teil. Teilen Sie uns mit, was Sie verifizieren möchten und mit welchem ungefähren Interaktionsvolumen Sie rechnen. Anhand Ihrer Antworten priorisieren wir die Entwicklung und den frühen Zugang.

Gestalten Sie die API mit, bevor sie veröffentlicht wird.

Sagen Sie uns, was Sie überprüfen möchten und um wie viele Interaktionen es geht. Mitglieder des Developer Preview erhalten zuerst Einblick in das Konzept.

Am Developer Preview teilnehmen Anwendungsfall für einen Agenten registrieren