Zum Hauptinhalt springen
KI-AGENTEN-იდენტIFIKATION

KI-Agenten-Identifikation für APIs

Ihre API weiß bereits, welcher Schlüssel eine Anfrage gesendet hat. Proof of Actor sagt Ihnen, welche Art von Akteur dahinterstand, welche Belege das stützen, und lässt Ihren Code entscheiden, was als Nächstes geschieht.

Toshendra Sharma

Von Toshendra SharmaGründer & CEO, AgentCredia · Updated November 13, 2026

Ihre API kennt den Schlüssel. Sie kennt den Akteur nicht.

Jede API-Anfrage kommt mit einem gewissen Nachweis darüber an, wer dafür bezahlt: ein API-Schlüssel, ein OAuth-Token, eine Sitzung. Dieser Nachweis beantwortet eine Frage gut. Er sagt Ihnen, welches Konto für den Aufruf verantwortlich ist. Er sagt Ihnen nicht, was den Aufruf gerade tatsächlich ausführt.

Ein einzelner API-Schlüssel kann von einem Entwickler verwendet werden, der in einem Terminal testet, von einem Backend-Job, der nach Zeitplan läuft, von einer Person, die mit einem KI-Assistenten arbeitet, und von einem autonomen Agenten, dem der Schlüssel übergeben wurde, um eine Aufgabe zu erledigen. Das sind sehr unterschiedliche Akteure. Sie haben unterschiedliche Rhythmen, unterschiedliche Fehlermodi und unterschiedliche Risikoprofile. Wenn Sie alle gleich behandeln, schränken Sie entweder die legitime Automatisierung übermäßig ein, auf die sich Ihre Kunden verlassen, oder Sie schützen die Teile Ihrer API nicht ausreichend, die niemals von einem unbeaufsichtigten Agenten gesteuert werden sollten.

KI-Agenten-Identifikation für APIs schließt diese Lücke. Statt alles aus dem Schlüssel abzuleiten, erhalten Sie eine Klassifizierung des Akteurs hinter jeder Anfrage, zusammen mit den Belegen, die sie stützen. Genau das soll Proof of Actor liefern, und der Anwendungsfall für APIs zeigt, wie API-Teams dies Route für Route einsetzen.

Warum API-Teams jetzt Akteurkontext brauchen

Automatischer Traffic zu APIs ist nichts Neues. Skripte, Integrationen und Crawler waren schon immer Teil des Bildes. Was sich geändert hat, ist die Art der Automatisierung. KI-Agenten können Dokumentation lesen, Aufrufe miteinander verketten, kreativ erneut versuchen und im Auftrag von Menschen handeln, die nicht jeden Schritt beobachten. Viele davon sind nützlich und willkommen. Einige sind schlecht gebaut. Einige wenige sind feindlich.

Ohne Akteurkontext greifen API-Teams oft zu groben Mitteln:

  • Rate-Limits pro Schlüssel, die gute und schlechte Agenten gleichermaßen ausbremsen.
  • User-Agent-Regeln, die scheitern, sobald ein Client einen Header ändert.
  • Pauschale Sperren, die legitime Automatisierung dazu bringen, stattdessen Ihre Web-App zu scrapen.

Akteurkontext erlaubt Ihnen, präzise zu reagieren. Ein signierter Agent von einem Betreiber, den Sie kennen, kann auf Lese-Routen ein höheres Limit erhalten. Ein unbekannter Aufrufer auf einer Schreib-Route kann nach einem stärkeren Nachweis gefragt werden. Ein Mensch, der einen KI-Assistenten nutzt, kann ein normales Nutzungserlebnis behalten. Es geht nicht darum, Agenten zu stoppen. Es geht darum, jeder Art von Aufrufer den richtigen Weg zu geben. Was eine signierte Anfrage Ihnen sagen kann und was nicht, lesen Sie unter was signierte KI-Agenten-Anfragen belegen.

Wie KI-Agenten-Identifikation in Proof of Actor funktioniert

Proof of Actor folgt für jede Anfrage demselben evidenzorientierten Ablauf. Die vollständige Schritt-für-Schritt-Erklärung finden Sie unter So funktioniert es; hier ist die Kurzfassung für API-Teams.

1. Signale aus Ihrer Integration

Ihre Integration übergibt Proof of Actor die in diesem Kontext verfügbaren Signale. Für eine API bedeutet das typischerweise Anfragesignale wie Header und Protokolldetails, alle kryptografischen Anfragesignaturen, die der Client bereitstellt, sowie alle Deklarationen, die der Client über sich selbst macht. Jedes Signal wird mit seiner Herkunft gekennzeichnet.

2. Klassifizierung mit Grundlage

Die Signale werden geprüft und zu einer von vier öffentlichen Klassen zusammengeführt:

  • Human: Die beobachtbaren Signale weisen auf eine menschengeführte Interaktion hin.
  • Human + AI: KI-Unterstützung wurde deklariert oder von einer Integration erkannt, die sie beobachten kann.
  • Agent: Automatisierter oder agentenstammender Traffic, gestützt durch verifizierbare Identität oder eine sorgfältig qualifizierte Inferenz.
  • Unknown: Die Belege reichen für eine verlässliche Bestimmung nicht aus.

Jedes Ergebnis trägt außerdem seine Grundlage: Verified, Declared, Inferred oder Unknown. Genau das schätzen API-Teams am meisten. Eine Anfrage, deren HTTP-Message-Signatur gemäß RFC 9421 gegen einen veröffentlichten Schlüssel validiert, wird als Verified gemeldet. Ein Client, der sich einfach selbst als Agent bezeichnet, wird als Declared gemeldet. Ein Muster, das automatisiert wirkt, wird als Inferred gemeldet. Sie müssen nie rätseln, ob ein Ergebnis auf Kryptografie oder auf einer Heuristik beruht. Die Beleggrundlage ist Teil der Antwort.

3. Ein Ergebnis, auf das Ihr Code reagieren kann

Das Ergebnis wird zusammen mit der Klasse, der Grundlage und einer lesbaren Belegzusammenfassung an Ihre Anwendung zurückgegeben. Ihr Code entscheidet, was damit geschieht. Im Beobachtungsmodus erfassen Sie es einfach. Wenn Sie bereit sind, routen Sie danach.

Was Ihr Team bekommt: Detect, Understand, Route

Proof of Actor ist ein Produkt mit drei Fähigkeiten.

Detect

Sammeln Sie die Akteur-Signale, die Ihre API sehen kann, und trennen Sie verifizierte Aussagen von verhaltensbasierten Inferenzschlüssen. Signierte Agentenanfragen, deklarierte Clients, Automatisierungssignale und Unknown-Ergebnisse bleiben klar getrennt, damit nichts stillschweigend zu einem einzigen Wert zusammengeführt wird.

Understand

Sehen Sie, welche Akteure welche Routen aufrufen, wie sich das über die Zeit verändert und welche Belege hinter jeder Klassifizierung stehen. Die Unknown-Rate bleibt sichtbar, sodass Sie genau erkennen, wo Ihre Abdeckung endet und wo ein stärkeres Signal helfen würde.

Route

Schreiben Sie Richtlinien pro Route und pro Risikostufe: allow, adapt, challenge, review oder rate-limit. Behalten Sie für verifizierte Agenten auf schreibgeschützten Endpunkten einen strukturierten, großzügigen Weg bei. Fordern Sie bei Operationen mit hoher Auswirkung stärkere Nachweise an. Definieren Sie einen expliziten Fallback für Unknown und für Timeouts, damit sich Ihre API vorhersehbar verhält, was auch immer geschieht. Sie entscheiden, wie jede Richtlinie fehlschlägt, offen oder geschlossen, basierend auf den Kosten eines Fehlers auf dieser Route.

Identitätsbelege, Berechtigungsnachweise und Autorisierung sind drei verschiedene Dinge

Der häufigste Fehler beim agentenbewussten API-Design besteht darin, drei getrennte Fragen zu einer zusammenzufassen. Proof of Actor hält sie auseinander, und Ihr Design sollte das ebenfalls tun.

  1. Identitätsbeleg: Welche Art von Akteur ruft auf, und was belegt das? Genau das liefert die KI-Agenten-Identifikation. Eine verifizierte Signatur verknüpft eine Anfrage mit einem Schlüssel und seiner veröffentlichten Betreiberkennung. Die IETF-Web Bot Auth-Arbeitsgruppe hat den Auftrag, diese Art von kryptografischer Authentifizierung für automatisierte Clients zu standardisieren, und ihr Umfang umfasst die Authentifizierung des Agenten und nicht des Endnutzers.
  2. Berechtigungsnachweise: Welches Konto ist für diesen Aufruf verantwortlich? Das ist Ihr API-Schlüssel, Token oder Ihre Sitzung, die von Ihnen ausgestellt und verwaltet werden.
  3. Autorisierung: Darf dieser Aufrufer genau dies tun? Das ist Ihr Berechtigungsmodell.

Ein verifizierter Agent ist nicht automatisch ein autorisierter Agent. Eine gültige Signatur beweist nicht, dass eine Person dem Agenten Autorität übertragen hat, und sie macht die angeforderte Aktion nicht sicher. Proof of Actor liefert Ihnen einen verlässlichen Kontext für die erste Frage und belässt die zweite und dritte genau dort, wo sie hingehören: in Ihrer Anwendung. Lesen Sie mehr über Agenten-Autorisierung und darüber, was die Belege auf Erkennung und Grenzen belegen können und was nicht.

Unknown ist ein Feature, kein Fehler

Das Signieren von Anfragen ist optional, und ein unsignierter Client kann sich selbst beliebig beschreiben. Ein System, das jede Anfrage zwanghaft in Human oder Agent einordnet, liegt mitunter selbstbewusst falsch, und Sie werden nicht wissen, wann.

Proof of Actor meldet Unknown, wenn die Belege keine belastbare Bestimmung zulassen. Unknown wird niemals zu Human umgedeutet und standardmäßig niemals als bösartig behandelt. Ihre Richtlinie definiert, was Unknown für jede Route bedeutet: auf öffentlichen Lesezugriffen erlauben, bei Kontoänderungen Ihre bestehenden Prüfungen beibehalten, bei hohen Risiken zur Prüfung einreihen. Dass Unknown sichtbar bleibt, macht Ihre anderen Klassifizierungen vertrauenswürdig. Der Leitfaden zum Umgang mit unbekanntem Traffic zeigt, wie Sie dafür gestalten.

Wo KI-Agenten-Identifikation in Ihrem Stack passt

Proof of Actor sitzt neben Ihrem bestehenden Gateway, Ihrer Authentifizierung und Ihrem Rate-Limiting. Es ersetzt nichts davon. Typische Platzierungen sind:

  • Serverseitige Middleware vor Ihren Route-Handlern, damit jede Anfrage geprüft wird, bevor Ihre Geschäftslogik läuft.
  • Am Edge, damit Signale ausgewertet werden, bevor Anfragen Ihr Origin erreichen.
  • Eine generische HTTP-Integration, damit jeder Stack Anfragenkontext senden und ein Ergebnis mit seiner Grundlage empfangen kann.

Integrationen werden zusammen mit jedem Founding-Team im Onboarding hands-on bereitgestellt, damit der Weg zu Ihrer Architektur passt und nicht umgekehrt. Der Developer Hub zeigt die heute verfügbaren Integrationspfade. Wenn Sie Tools für Agenten betreiben, deckt der MCP-Servers-Anwendungsfall die spezifischen Muster für Tool-Aufrufe ab.

Im Beobachtungsmodus starten

Die Installation von Proof of Actor ändert nicht, wie Ihre API reagiert. Ergebnisse werden aufgezeichnet, damit Ihr Team sie mit den bereits bekannten Resultaten vergleichen, sehen kann, wohin Agenten tatsächlich gehen, die Unknown-Rate auf jeder Route messen und jede Klassifizierung prüfen kann, die falsch erscheint. Erst dann aktivieren Sie eine Richtlinie, Route für Route, wenn die Belege dies stützen.

So führen Sie KI-Agenten-Identifikation ein, ohne Ihre Kunden zu überraschen oder die Integrationen zu brechen, auf die sie angewiesen sind. Der Leitfaden zum sicheren Rollout akteurbewusster Richtlinien führt Schritt für Schritt durch die Abfolge.

Werden Sie Teil des Founding-Developer-Programms

Proof of Actor befindet sich in privater Beta mit einer kleinen Gruppe von Founding-Development-Teams. Ausgewählte Teams können innerhalb der beim Onboarding vereinbarten Nutzungslimits bis zu 12 Monate kostenlosen Zugriff erhalten, zusammen mit direkter Integrationsunterstützung durch unsere Ingenieure und echtem Einfluss darauf, was wir als Nächstes bauen.

Wenn Sie eine API betreiben und wissen möchten, wer sie wirklich aufruft, bewerben Sie sich für den frühen Zugriff. Erzählen Sie uns von Ihrer API, den Routen, die Ihnen am wichtigsten sind, und den Entscheidungen, die Sie mit Akteurkontext anders treffen würden. Wir sagen Ihnen, wie Proof of Actor passt.

Quellen

FÜR ENTWICKLER

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 oder Unknown.
basis
Wie stark die Evidenz ist: verified, declared, inferred oder unknown.
evidence
Die Signale hinter dem Ergebnis, damit Ihr Team den Grund sehen kann.

Starten Sie im Beobachtungsmodus: Erfassen Sie Ergebnisse neben Ihren Logs und ändern Sie nichts, bis Sie eine Richtlinie wählen. Lesen Sie die Node.js-Integrationsanleitung

Häufig gestellte Fragen

Worin unterscheidet sich die KI-Agenten-Identifikation von der API-Schlüssel-Authentifizierung?

Ein API-Schlüssel sagt Ihnen, welches Konto eine Anfrage gesendet hat. Die KI-Agenten-Identifikation sagt Ihnen, welche Art von Akteur hinter der Anfrage steht und welche Belege diese Schlussfolgerung stützen. Sie brauchen beides, und sie beantworten unterschiedliche Fragen.

Kann Proof of Actor jeden KI-Agenten identifizieren, der meine API aufruft?

Proof of Actor klassifiziert jede Anfrage, die es sieht, als Human, Human + AI, Agent oder Unknown und gibt die Grundlage für jedes Ergebnis an. Wenn die Belege nicht stark genug sind, lautet das Ergebnis Unknown statt einer Vermutung.

Bedeutet die Identifikation eines Agenten, dass er handeln darf?

Nein. Identifikation und Autorisierung sind getrennt. Proof of Actor gibt Ihrer Anwendung Kontext über den Aufrufer, und Ihre eigenen Autorisierungsregeln entscheiden, was dieser Aufrufer tun darf.

Wird Proof of Actor Anfragen an meine API blockieren?

Nur wenn Sie das festlegen. Jede Integration beginnt im Beobachtungsmodus, und Durchsetzung erfolgt nur über Richtlinien, die Ihr Team schreibt und aktiviert.

Wie erhalte ich Zugriff?

Proof of Actor befindet sich in privater Beta. Bewerben Sie sich für den frühen Zugriff, und ausgewählte Founding-Developer-Teams können innerhalb der vereinbarten Nutzungslimits bis zu 12 Monate kostenlos erhalten.

Wissen, wer Ihre App verwendet.

Private Beta für eine kleine Gruppe von Founding-Developern.

Möchten Sie zuerst sprechen? Mit den Gründern sprechen