AdminInference Hooks

Inference Hooks

Copy page



Sende jeden regulierten Prompt an den KI-Sicherheitsserver deiner Organisation, um vor der Inferenz ein Allow- oder Deny-Urteil einzuholen.

„Inference hooks“ (Inferenz-Hooks) ermöglichen es einer Claude Enterprise-Organisation, jeden regulierten Prompt über einen „AI security server“ (KI-Sicherheitsserver) zu leiten – einen HTTPS-Dienst, den die Organisation oder ihr Sicherheitsanbieter betreibt –, bevor die Inferenz ausgeführt wird. Wenn ein Benutzer einen Prompt absendet, sendet Anthropic das Gesprächstranskript an deinen KI-Sicherheitsserver und wartet auf ein Allow- oder Deny-Urteil; eine abgelehnte Anfrage erreicht das Modell nie. Sicherheits- und Compliance-Teams nutzen Inference Hooks, um Datenrichtlinien inline durchzusetzen, und Entwickler bauen den KI-Sicherheitsserver, der jede Anfrage bewertet.

Da der Hook auf den Servern von Anthropic läuft – nachdem die Anfrage den Client verlassen hat und bevor das Modell läuft –, gilt er einheitlich für jede regulierte Anfrage, ohne dass auf Benutzergeräten etwas installiert oder bereitgestellt werden muss.

Derzeit ist das einzige Hook-Ereignis prompt, das einmal pro regulierter Inferenzanfrage ausgelöst wird, bevor die Inferenz beginnt. Eine antwortseitige Durchsetzung ist als späteres Ereignis geplant.

---

So funktionieren Inference Hooks

1. Ein Benutzer sendet einen Prompt auf einer regulierten Oberfläche ab.
2. Anthropic sendet einen HTTPS-POST an den konfigurierten KI-Sicherheitsserver-Endpunkt deiner Organisation. Der Anfragetext enthält das Gesprächstranskript, und jede Anfrage wird gemäß der Standard Webhooks-Spezifikation signiert, sobald deine Organisation ihr Signaturgeheimnis generiert hat, sodass dein Server überprüfen kann, dass sie von Anthropic stammt.
3. Dein KI-Sicherheitsserver bewertet den Inhalt und antwortet mit einem Urteil innerhalb des Urteils-Timeouts, das deine Organisation konfiguriert (standardmäßig 5 Sekunden).
4. Bei allow läuft die Inferenz normal weiter. Bei deny wird die Anfrage abgelehnt, und der Benutzer sieht eine „Durch Richtlinie blockiert“-Meldung, die aus zwei Teilen zusammengesetzt ist: dem anfragespezifischen Grund, den dein KI-Sicherheitsserver im Feld deny_reason des Urteils angegeben hat, gefolgt von einer festen Meldung, die deine Administratoren konfigurieren (zum Beispiel, an wen man sich wenden oder wo man eine Ausnahme beantragen kann). Wenn deine Administratoren keine konfiguriert haben, weist eine integrierte Standardmeldung den Benutzer an, sich an sie zu wenden. Jede Ablehnung wird außerdem im Activity Feed deiner Organisation aufgezeichnet.

Das folgende Diagramm verfolgt ein Beispiel (eine Cowork-Anfrage, bei der Claude auch ein O365-Tool aufruft), um zu veranschaulichen, welche Teile des Ablaufs mit Hooks versehen sind. Die Hook-Punkte sind die Schritte 1 und 5 des Diagramms, in denen der Prompt eintrifft und das Tool-Ergebnis zurückkommt; jeder führt zu dem in den Schritten 2 und 6 gezeigten Validierungsaustausch mit deinem KI-Sicherheitsserver.

Ein Urteil ist ein kleines JSON-Objekt: {"action": "allow"} lässt die Anfrage fortfahren, und ein Deny enthält den für den Benutzer sichtbaren Grund. Das vollständige Urteilsschema findest du unter Ein Urteil zurückgeben.

Dein KI-Sicherheitsserver sieht, was der Benutzer sieht: Transkripttext, Tool-Aufrufe und deren Ergebnisse sowie aus Anhängen extrahierten Text. Er erhält niemals rohe Datei- oder Bild-Bytes, System-Prompts oder Anthropic-internen Kontext. Anthropic speichert im Rahmen von Inference Hooks keine Prompt- oder Antwortinhalte; es werden nur Metadaten zur Hook-Aktivität aufgezeichnet, wie Urteile, Zeitstempel und Anfragekennungen.

Wenn dein KI-Sicherheitsserver nicht erreichbar ist, einen Fehler zurückgibt oder nicht innerhalb des Timeouts antwortet, entscheidet die Fehlerbehandlungseinstellung deiner Organisation über das Ergebnis: die Anfrage blockieren oder sie ohne Prüfung fortfahren lassen.

Die Durchsetzung kann in deinem eigenen Tempo eingeführt werden, sodass niemand am ersten Tag blockiert werden muss: Der Shadow-Modus beobachtet Urteile im Live-Traffic, ohne etwas zu blockieren, ein Rollout-Prozentsatz prüft einen gewählten Anteil der Anfragen, und Ausschlüsse nehmen Mitglieder gewählter Rollen vollständig aus. Siehe Inference Hooks konfigurieren.

Die vollständigen Anfrage- und Antwortschemata, die Signaturprüfung und betriebliche Details findest du unter Eine Integration entwickeln.

---

Anwendungsfälle

• „Data loss prevention“ (Verhinderung von Datenverlust), oder DLP. Leite das Transkript an deinen DLP-Scanner weiter und lehne Prompts ab, die regulierte oder klassifizierte Inhalte enthalten. Dies ist die häufigste Einsatzform.
• Echtzeit-Archivierung von Transkripten. Archiviere jedes Transkript bei Eingang und gib immer allow zurück – als Push-basierte Alternative zum Polling der Compliance API.
• Prompt-Telemetrie. Miss, wie deine Organisation Claude nutzt, im Moment der Nutzung.
• Policy-Engines. Setze deine eigenen Regeln vor der Inferenz durch: Modell-Allowlists, projektbezogene Einschränkungen oder Arbeitszeitkontrollen.

---

Aktuelle Einschränkungen

• Anhänge werden durch Metadaten und extrahierten Text dargestellt. Rohe Datei- und Bild-Bytes werden nie gesendet, sodass reine Bildinhalte (zum Beispiel ein Screenshot eines Dokuments) nicht geprüft werden.
• Urteile lauten Allow oder Deny. Das Umschreiben oder Schwärzen eines Prompts wird nicht unterstützt.
• Plattform-Organisationen (API-Zugriff über die Claude Platform) sind nicht im Geltungsbereich.

---

Verfügbarkeit

Inference Hooks sind für Claude Enterprise-Organisationen verfügbar. Ihre Konfiguration erfordert die Berechtigung organization:manage, über die die integrierten Rollen Admin, Owner und Primary owner verfügen, ebenso wie jede benutzerdefinierte Rolle, der sie gewährt wurde.

Ein Hook reguliert Gespräche in claude.ai, Cowork und Claude Code-Sitzungen in deiner Claude Enterprise-Organisation, unabhängig davon, ob sie im Web, in der Desktop-App oder in der CLI laufen. Inference Hooks sind auf Amazon Bedrock oder Google Cloud nicht verfügbar.

Regulierte Anfragen sind die Inferenzanfragen hinter dem Gespräch des Benutzers. Nebenanfragen, wie die Generierung von Gesprächstiteln, werden nicht an deinen Endpunkt gesendet, und System-Prompts sowie Tool-Definitionen sind nie in dem enthalten, was gesendet wird. Der Sprachmodus ist nicht abgedeckt.

---

Inference Hooks im Vergleich zur Compliance API

Beide Funktionen dienen Sicherheits-, Rechts- und Compliance-Teams in Claude Enterprise-Organisationen.

Verwende Inference Hooks, um eine Anfrage zu stoppen, bevor sie das Modell erreicht, und die Compliance API, um im Nachhinein zu prüfen, was geschehen ist.

---

In diesem Abschnitt