IDENTIFICAZIONE DI AGENTI AI

Identificazione di agenti AI per API

La tua API sa già quale chiave ha fatto una richiesta. Proof of Actor ti dice che tipo di attore c'era dietro, quale evidenza lo supporta e lascia che sia il tuo codice a decidere cosa succede dopo.

Richiedi accesso anticipato Esplora come funziona

Di Toshendra SharmaFondatore e CEO, AgentCredia · Updated November 13, 2026

La tua API conosce la chiave. Non conosce l'attore.

Ogni richiesta API arriva con una qualche prova di chi la sta pagando: una chiave API, un token OAuth, una sessione. Questa prova risponde bene a una domanda. Ti dice quale account è responsabile della chiamata. Non ti dice che cosa sta effettivamente effettuando la chiamata in quel momento.

Una singola chiave API può essere usata da uno sviluppatore che testa in un terminale, da un job backend in esecuzione secondo una pianificazione, da una persona che lavora con un assistente AI e da un agente autonomo a cui è stata consegnata la chiave con il compito di portare a termine una attività. Sono attori molto diversi. Hanno ritmi diversi, modalità di guasto diverse e profili di rischio diversi. Trattarli tutti allo stesso modo significa o restringere troppo l'automazione legittima su cui fanno affidamento i tuoi clienti, oppure proteggere troppo poco le parti della tua API che non dovrebbero mai essere guidate da un agente non presidiato.

L'identificazione di agenti AI per API colma questo divario. Invece di inferire tutto dalla chiave, ottieni una classificazione dell'attore dietro ogni richiesta, insieme all'evidenza che la supporta. È questo che Proof of Actor è progettato per fornire, e il caso d'uso APIs mostra come i team API lo applicano route per route.

Perché i team API hanno ora bisogno del contesto dell'attore

Il traffico automatizzato verso le API non è una novità. Script, integrazioni e crawler hanno sempre fatto parte del quadro. Ciò che è cambiato è il tipo di automazione. Gli agenti AI possono leggere la documentazione, concatenare chiamate, riprovare in modo creativo e agire per conto di persone che non stanno osservando ogni passaggio. Molti sono utili e benvenuti. Alcuni sono costruiti male. Alcuni sono ostili.

Senza il contesto dell'attore, i team API tendono a ricorrere a strumenti grezzi:

Limiti di velocità per chiave, che rallentano allo stesso modo agenti buoni e agenti cattivi.
Regole basate su user-agent, che si rompono non appena un client cambia un header.
Blocchi generalizzati, che spingono l'automazione legittima a fare scraping della tua web app.

Il contesto dell'attore ti permette di rispondere con precisione. Un agente firmato da un operatore che riconosci può ottenere un limite più alto sulle route di lettura. Un chiamante sconosciuto che arriva su una route di scrittura può essere invitato a presentare una credenziale più forte. Una persona che usa un assistente AI può mantenere un'esperienza normale. Il punto non è fermare gli agenti. Il punto è dare a ogni tipo di chiamante il percorso giusto. Per sapere che cosa una richiesta firmata può e non può dirti, leggi cosa dimostrano le richieste firmate degli agenti AI.

Come funziona l'identificazione di agenti AI in Proof of Actor

Proof of Actor segue lo stesso flusso basato sull'evidenza per ogni richiesta. Puoi leggere la procedura completa in Come funziona; qui c'è la versione breve per i team API.

1. Segnali dalla tua integrazione

La tua integrazione passa a Proof of Actor i segnali disponibili in quel contesto. Per una API, questo significa in genere il contesto della richiesta, come header e dettagli del protocollo, eventuali firme crittografiche della richiesta fornite dal client e eventuali dichiarazioni che il client fa su se stesso. Ogni segnale è etichettato con la propria origine.

2. Classificazione con una base

I segnali vengono verificati e combinati in una delle quattro classi pubbliche:

Human: i segnali osservabili indicano una interazione guidata da una persona.
Human + AI: l'uso di AI è stato dichiarato o rilevato da una integrazione che può osservarlo.
Agent: traffico automatizzato o originato da agenti, supportato da identità verificabile o da una inferenza attentamente qualificata.
Unknown: l'evidenza non supporta una determinazione affidabile.

Ogni risultato porta anche la sua base: Verified, Declared, Inferred o Unknown. Questa è la parte che i team API apprezzano di più. Una richiesta la cui firma HTTP message signature, come definita in RFC 9421, viene convalidata rispetto a una chiave pubblicata viene riportata come Verified. Un client che si limita a dichiararsi come agente viene riportato come Declared. Un pattern che appare automatizzato viene riportato come Inferred. Non devi mai chiederti se un risultato si basa sulla crittografia o su una euristica. La base dell'evidenza fa parte della risposta.

3. Un risultato su cui il tuo codice può agire

Il risultato torna alla tua applicazione con la classe, la base e un riepilogo leggibile dell'evidenza. Il tuo codice decide che cosa farne. In modalità di osservazione, lo registri semplicemente. Quando sei pronto, lo usi per instradare.

Cosa ottiene il tuo team: Detect, Understand, Route

Proof of Actor è un unico prodotto con tre capacità.

Detect

Raccogli i segnali dell'attore che la tua API può vedere e separa le affermazioni verificate dalle inferenze comportamentali. Le richieste firmate dagli agenti, i client dichiarati, i segnali di automazione e i risultati Unknown restano tutti distinti, così nulla viene fuso silenziosamente in un unico punteggio.

Understand

Vedi quali attori chiamano quali route, come questo cambia nel tempo e quale evidenza sta dietro a ciascuna classificazione. Il tasso di Unknown resta visibile, così sai esattamente dove finisce la tua copertura e dove un segnale più forte sarebbe utile.

Route

Scrivi policy per route e per livello di rischio: allow, adapt, challenge, review o rate-limit. Mantieni un percorso strutturato e permissivo per gli agenti verificati su endpoint di sola lettura. Richiedi credenziali più forti sulle operazioni ad alto impatto. Definisci un fallback esplicito per Unknown e per i timeout, così la tua API si comporta in modo prevedibile qualunque cosa accada. Decidi tu come ogni policy fallisce, aperta o chiusa, in base al costo di un errore su quella route.

Evidenza di identità, credenziali e autorizzazione sono tre cose diverse

L'errore più comune nella progettazione di API consapevoli degli agenti è fondere tre domande separate in una sola. Proof of Actor le tiene distinte, e anche il tuo design dovrebbe farlo.

Evidenza di identità: che tipo di attore sta chiamando e cosa lo prova? Questo è ciò che fornisce l'identificazione di agenti AI. Una firma Verified associa una richiesta a una chiave e al relativo identificatore di operatore pubblicato. Il gruppo di lavoro IETF Web Bot Auth ha il mandato di standardizzare questo tipo di autenticazione crittografica per client automatizzati, e il suo ambito copre l'autenticazione dell'agente piuttosto che dell'utente finale.
Credenziali: quale account è responsabile di questa chiamata? Questa è la tua chiave API, token o sessione, emessi e gestiti da te.
Autorizzazione: questo chiamante può fare questa cosa specifica? Questo è il tuo modello di permessi.

Un agente verificato non è automaticamente un agente autorizzato. Una firma valida non prova che una persona abbia delegato l'autorità all'agente, e non rende sicura l'azione richiesta. Proof of Actor ti fornisce un contesto affidabile per la prima domanda e lascia la seconda e la terza esattamente dove devono stare: nella tua applicazione. Leggi di più su autorizzazione degli agenti e su ciò che l'evidenza può e non può stabilire in Detection & Limitations.

Unknown è una funzione, non un fallimento

La firma della richiesta è facoltativa e un client non firmato può descriversi come preferisce. Un sistema che forza ogni richiesta dentro Human o Agent sbaglierà con sicurezza una parte delle volte, e non saprai quando.

Proof of Actor segnala Unknown quando l'evidenza non supporta una determinazione. Unknown non viene mai convertito in Human e non viene mai trattato come malevolo per impostazione predefinita. La tua policy definisce che cosa significa Unknown per ogni route: consentilo sulle letture pubbliche, mantieni i controlli esistenti sulle modifiche all'account, mettilo in coda per revisione dove la posta in gioco è alta. Rendere Unknown visibile è ciò che rende affidabili le altre classificazioni. La guida su gestione del traffico sconosciuto mostra come progettare per questo caso.

Dove si inserisce l'identificazione di agenti AI nel tuo stack

Proof of Actor si affianca al gateway, all'autenticazione e al rate limiting esistenti. Non sostituisce nessuno di questi elementi. Le collocazioni tipiche includono:

Middleware lato server davanti ai tuoi route handler, così ogni richiesta viene valutata prima che il tuo business logic venga eseguito.
All'edge, così i segnali vengono valutati prima che le richieste raggiungano l'origine.
Una integrazione HTTP generica, così qualsiasi stack può inviare il contesto della richiesta e ricevere un risultato con la sua base.

Le integrazioni vengono fornite in modalità hands-on con ogni team fondatore durante l'onboarding, così il percorso corrisponde alla tua architettura e non il contrario. Il developer hub mostra i percorsi di integrazione disponibili oggi. Se usi strumenti per agenti, il caso d'uso MCP Servers copre i pattern specifici per le chiamate agli strumenti.

Parti in modalità di osservazione

Installare Proof of Actor non cambia il modo in cui la tua API risponde. I risultati vengono registrati così il tuo team può confrontarli con gli esiti che già conosce, vedere dove vanno davvero gli agenti, misurare il tasso di Unknown su ogni route e rivedere ogni classificazione che sembra errata. Solo dopo abiliti una policy, route per route, dove l'evidenza la supporta.

È così che distribuisci l'identificazione di agenti AI senza sorprendere i clienti o rompere le integrazioni da cui dipendono. La guida su rilasciare in modo sicuro policy consapevoli degli attori illustra la sequenza passo dopo passo.

Entra nel programma founding developer

Proof of Actor è in private beta con un piccolo gruppo di team fondatori di sviluppo. I team selezionati possono ricevere fino a 12 mesi di accesso gratuito, entro i limiti di utilizzo concordati durante l'onboarding, insieme a supporto diretto all'integrazione da parte dei nostri ingegneri e a una reale influenza su ciò che costruiamo dopo.

Se gestisci una API e vuoi sapere chi la sta davvero chiamando, candidati per l'accesso anticipato. Raccontaci della tua API, delle route che ti interessano di più e delle decisioni che prenderesti in modo diverso con il contesto dell'attore. Ti diremo come si inserisce Proof of Actor.

Fonti

RFC 9421: HTTP Message Signatures, IETF, February 2024.
Web Bot Auth (webbotauth) working group charter, IETF.

PER GLI SVILUPPATORI

What your code receives

Every interaction resolves to one result record. Your application reads the class and the basis and applies its own policy.

Result record

{
  "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

Domande frequenti

In che cosa l'identificazione di agenti AI è diversa dall'autenticazione con chiave API?

Una chiave API ti dice quale account ha inviato una richiesta. L'identificazione di agenti AI ti dice che tipo di attore c'è dietro la richiesta e quale evidenza supporta quella conclusione. Servono entrambe e rispondono a domande diverse.

Proof of Actor può identificare ogni agente AI che chiama la mia API?

Proof of Actor classifica ogni richiesta che vede come Human, Human + AI, Agent o Unknown e indica la base di ciascun risultato. Quando l'evidenza non è abbastanza forte, il risultato è Unknown invece di essere una supposizione.

Identificare un agente significa che è autorizzato ad agire?

No. Identificazione e autorizzazione sono separate. Proof of Actor fornisce alla tua applicazione il contesto sul chiamante, e le tue regole di autorizzazione decidono che cosa quel chiamante può fare.

Proof of Actor bloccherà le richieste alla mia API?

Non a meno che tu non decida che debba farlo. Ogni integrazione parte in modalità di osservazione e l'enforcement avviene solo tramite policy che il tuo team scrive e abilita.

Come ottengo l'accesso?

Proof of Actor è in private beta. Candidati per l'accesso anticipato e i team fondatori selezionati possono ricevere fino a 12 mesi gratuiti entro i limiti di utilizzo concordati.

Scopri chi sta usando la tua app.

Private beta per un piccolo gruppo di founding developer.

Richiedi accesso anticipato Visualizza i prezzi

Preferisci parlare prima? Parla con i fondatori