Come funziona Proof of Actor.
Un percorso evidence-first dall'interazione in ingresso alla decisione dell'applicazione.
- /api/v1/catalogenforceAgenteConsenti · API strutturata
- /support/ticketsenforceUmano + IAConsenti · etichetta come Human + AI
- /account/*previewSconosciutoMantieni i controlli esistenti
- /api/v1/orderspreviewAgenteRichiedi credenziali più forti
Dall'interazione alla decisione
- 01Richiesta o evento dell'applicazioneUna visualizzazione di pagina, una chiamata API, una chiamata strumento MCP o un'azione nell'app.
- 02Segnali dall'integrazione supportataSolo ciò che quell'integrazione può osservare in quel contesto.
- 03Normalizzazione e classificazione delle evidenzeI segnali vengono controllati, etichettati in base al fondamento e combinati.
- 04Risultato dell'attore con base e incertezzaHuman, Human + AI, Agent o Unknown, più su cosa si basa.
- 05Dashboard e analyticsTendenze, route ed evidenze da rivedere per il tuo team.
- 06La decisione della tua applicazioneSolo osservazione, oppure applica una policy che hai scelto.
What your code receives
Every interaction resolves to one result record. Your application reads the class and the basis and applies its own policy.
{
"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 o Unknown.
- basis
- Quanto sono forti le evidenze: Verified, Declared, Inferred o Unknown.
- evidence
- I segnali dietro il risultato, così il tuo team può vedere il perché.
Inizia in modalità di osservazione: registra i risultati accanto ai tuoi log e non cambiare nulla finché non scegli una policy. Leggi la guida di integrazione Node.js
Observation mode è l'impostazione predefinita
L'installazione di Proof of Actor non blocca né modifica alcuna richiesta. I risultati vengono registrati in modo che il tuo team possa confrontarli con gli esiti reali dell'applicazione, esaminare i falsi positivi e decidere se una policy sia appropriata.
Tipi di evidenza
L'evidenza disponibile dipende dall'integrazione e dal contesto. I controlli per ciascun workflow vengono concordati con il team durante l'onboarding e i dettagli interni dei segnali restano privati, così sono più difficili da imitare.
Firme delle richieste
Firme crittografiche da client automatizzati che pubblicano le loro chiavi.
Dichiarazioni
Un client che si identifica come agent, oppure una dichiarazione di assistenza AI all'interno della tua app.
Segnali di interazione
Segnali da un collector browser approvato, nelle pagine in cui viene eseguito.
Contesto della richiesta
Header e dettagli del protocollo disponibili per un'integrazione lato server.
Dove si inseriscono le decisioni di routing
La tua applicazione chiama Proof of Actor, riceve un risultato e applica le proprie regole. Scegli, per route e per livello di rischio, se l'integrazione deve fallire open (la richiesta prosegue come se Proof of Actor non fosse presente) oppure fail closed (si applica il tuo controllo più rigoroso esistente).
Timeout API
Se un risultato non è disponibile in tempo, la tua integrazione usa il fallback che hai scelto per quel route. Un timeout non diventa mai un risultato Human.
Telemetria mancante
Se il collector del browser non è stato eseguito o un segnale è assente, il risultato lo riflette. Le evidenze mancanti riducono ciò che si può dire; non vengono trattate come sospette.
Classificazioni Unknown
Unknown è un risultato normale. La tua policy definisce cosa significa Unknown per ogni route, per esempio: consentire le pagine pubbliche, mantenere i controlli esistenti sulle modifiche all'account.
Evidenza obsoleta
Le evidenze hanno un tempo e un ambito. Un risultato ottenuto all'inizio di una sessione non dovrebbe essere riutilizzato per un'azione successiva più sensibile senza un controllo تازه.
Il workflow di integrazione beta
- 01RichiediRaccontaci della app e dell'interazione che vuoi comprendere.
- 02AmbitoConcorda l'integrazione, i percorsi, i limiti d'uso e la gestione dei dati.
- 03Integra in modalità osservazioneNessuna modifica al modo in cui la tua app risponde.
- 04ConvalidaConfronta i risultati con il ground truth che conosci: copertura, tasso di sconosciuti, falsi positivi, latenza.
- 05DecidiAbilita una policy solo dove le evidenze la supportano.
Cosa misuriamo con i team fondatori
Inizia in modalità di osservazione.
Candidati per unirti al founding developer program.
Preferisci parlare prima? Parla con i fondatori