--- title: Referenz url: https://platform.claude.com/docs/de/managed-agents/reference description: Event-Typen, CLI-Flags für den selbst gehosteten Worker, unterstützte MCP-Server-Typen, Ratenlimits und Branding-Richtlinien für Claude Managed Agents. featureMetadata: topic: title: Managed Agents url: https://platform.claude.com/docs/en/managed-agents/overview status: beta betaHeader: managed-agents-2026-04-01 --- Diese Seite sammelt Referenzmaterial für Claude Managed Agents. Aufgabenorientierte Leitfäden findest du über die Links in den jeweiligen Abschnitten. Die Operationen auf der Session-Ressource findest du unter [Session-Operationen](https://platform.claude.com/docs/de/managed-agents/session-operations). ## Event-Typen Persistierte Event-Typ-Strings folgen der Namenskonvention `{domain}.{action}`; die nur im Stream vorhandenen Event-Deltas (siehe den Tab „Event-Deltas“) sind die Ausnahme. Siehe [Session-Event-Stream](https://platform.claude.com/docs/de/managed-agents/events-and-streaming) zum Senden, Streaming und Auflisten von Events. Webhook-Event-Typen sind separat unter [Webhooks abonnieren](https://platform.claude.com/docs/de/managed-agents/webhooks#supported-event-types) aufgeführt, und einige ihrer Namen unterscheiden sich von denen des Streams (zum Beispiel `session.status_idled` statt `session.status_idle`). | Typ | Beschreibung | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `user.message` | Eine Benutzernachricht mit Text-, Bild- oder Dokumentinhalt. | | `user.interrupt` | Stoppt den Agenten mitten in der Ausführung. Es beendet keinen [Workflow-Run](https://platform.claude.com/docs/de/managed-agents/workflow-runs#interrupt-a-session-with-runs-open). | | `user.custom_tool_result` | Antwort auf einen Custom-Tool-Aufruf des Agenten. | | `user.tool_confirmation` | Genehmigt oder verweigert einen Agenten- oder MCP-Tool-Aufruf, wenn eine Berechtigungsrichtlinie eine Bestätigung erfordert. | | `user.define_outcome` | Definiert ein [Outcome](https://platform.claude.com/docs/de/managed-agents/define-outcomes) (Ergebnis), auf das der Agent hinarbeiten soll. | | `user.tool_result` | Nur für Sessions mit `self_hosted`-[Umgebungen](https://platform.claude.com/docs/de/managed-agents/self-hosted-sandboxes): Deine Integration ist dafür verantwortlich, `agent_toolset`-Ergebnisse bereitzustellen. Die SDK-Helfer und die CLI erledigen dies automatisch. | | Typ | Beschreibung | | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `agent.message` | Inhaltsblöcke der Agentenantwort. | | `agent.thinking` | Signalisiert, dass der Agent durch „extended thinking" (erweitertes Nachdenken) Fortschritte macht. Dies ist nur ein Fortschrittssignal und enthält nicht den Denkinhalt. | | `agent.tool_use` | Der Agent ruft ein vorgefertigtes Agenten-Tool auf (bash, Dateioperationen usw.). Enthält `evaluated_permission` (java, php: `evaluatedPermission`; csharp, go: `EvaluatedPermission`) und in der Regel `evaluation` (csharp, go: `Evaluation`) (siehe [wie jeder Aufruf bewertet wurde](https://platform.claude.com/docs/de/managed-agents/permission-policies#see-how-each-call-was-evaluated)). | | `agent.tool_result` | Ergebnis der Ausführung eines vorgefertigten Agenten-Tools. | | `agent.mcp_tool_use` | Der Agent ruft ein MCP-Server-Tool auf. Enthält `evaluated_permission` (java, php: `evaluatedPermission`; csharp, go: `EvaluatedPermission`) und in der Regel `evaluation` (csharp, go: `Evaluation`) (siehe [wie jeder Aufruf bewertet wurde](https://platform.claude.com/docs/de/managed-agents/permission-policies#see-how-each-call-was-evaluated)). | | `agent.mcp_tool_result` | Ergebnis der Ausführung eines MCP-Tools. | | `agent.custom_tool_use` | Der Agent ruft eines deiner benutzerdefinierten Tools auf. Antworte mit einem `user.custom_tool_result`-Ereignis. | | `agent.thread_context_compacted` | Der Gesprächsverlauf wurde komprimiert, damit er in das „context window" (Kontextfenster) passt. | | `agent.thread_message_received` | In einer [Multiagenten](https://platform.claude.com/docs/de/managed-agents/multiagent-orchestration)-Session ist eine Nachricht von einem anderen Thread auf dem Thread eingegangen, dessen Stream dieses Event überträgt; auf dem primären Thread hat ein Agent einen Bericht oder eine Frage an den von der Session ausgeführten Agenten gesendet. | | `agent.thread_message_sent` | In einer [Multiagenten](https://platform.claude.com/docs/de/managed-agents/multiagent-orchestration)-Session hat der Thread, dessen Stream dieses Event überträgt, eine Nachricht an einen anderen Thread gesendet; auf dem primären Thread hat der von der Session ausgeführte Agent eine Aufgabe oder Folgenachricht an einen anderen Agenten gesendet. | Nachrichteninhalte in diesen Events können einen `redacted`-Inhaltsblock enthalten, `{"type": "redacted"}`: einen Platzhalter für Inhalte, die aufgrund der Modellrichtlinien von Anthropic zurückgehalten wurden. Der Block enthält keine weiteren Felder. Redacted-Blöcke erscheinen nur in Inhalten, die die Plattform ausgibt; ein User-Event, das einen solchen enthält, wird mit einem 400-Fehler abgelehnt. | Typ | Beschreibung | | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `session.status_running` | Der Agent verarbeitet aktiv. | | `session.status_idle` | Der Agent hat seine aktuelle Aufgabe abgeschlossen und wartet auf Eingaben. Enthält einen `stop_reason` (java, php: `stopReason`; csharp, go: `StopReason`), der angibt, warum der Agent gestoppt hat. | | `session.status_rescheduled` | Ein vorübergehender Fehler ist aufgetreten und die Session versucht es automatisch erneut. | | `session.status_terminated` | Die Session wurde beendet, entweder aufgrund eines nicht behebbaren Fehlers oder weil sie archiviert wurde. | | `session.deleted` | Die Session wurde gelöscht. Beendet jeden aktiven Event-Stream; für diese Session werden keine weiteren Events ausgegeben. | | `session.updated` | Eine Session-Update-Anfrage hat mindestens ein Feld geändert. Enthält nur die geänderten Felder. Aktualisierungen gelten ab dem nächsten Turn. | | `session.error` | Während der Verarbeitung ist ein Fehler aufgetreten. Enthält ein typisiertes `error` (csharp, go: `Error`)-Objekt mit einem `retry_status` (java, php: `retryStatus`; csharp, go: `RetryStatus`). | | `session.usage` | Momentaufnahme der kumulierten Nutzung der Session und der erfassten Listenkosten. Enthält die Nutzungssummen der Session und, falls die Session eines hat, ihr [Budget](https://platform.claude.com/docs/de/managed-agents/budgets). | | `session.thread_created` | Ein [Multiagenten](https://platform.claude.com/docs/de/managed-agents/multiagent-orchestration)-Thread wurde erstellt. Es enthält `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`): die ID des Runs für den Thread eines [Workflow-Runs](https://platform.claude.com/docs/de/managed-agents/workflow-runs#a-runs-threads) und `null` (python: `None`; ruby: `nil`; java: `Optional.empty()`; go: `""`) für jeden anderen Thread. | | `session.thread_status_running` | Ein Session-Thread hat mit der Ausführung begonnen. Jede Session gibt dies für ihren primären Thread aus; in [Multiagenten](https://platform.claude.com/docs/de/managed-agents/multiagent-orchestration)-Sessions werden Zustandsübergänge von Kind-Threads zusätzlich im primären Stream gespiegelt. | | `session.thread_status_idle` | Ein Session-Thread hat seinen Turn beendet und wartet auf Eingaben. Enthält `stop_reason` (java, php: `stopReason`; csharp, go: `StopReason`). | | `session.thread_status_rescheduled` | Ein Session-Thread ist auf einen vorübergehenden Fehler gestoßen und versucht es automatisch erneut. | | `session.thread_status_terminated` | Ein Session-Thread wurde beendet und nimmt keine weiteren Eingaben an, zum Beispiel weil er archiviert wurde oder auf einen nicht behebbaren Fehler gestoßen ist. Ein Advisor-Thread wird außerdem beendet, wenn seine Konsultation endet. Die Threads eines Workflow-Runs archiviert der Server selbst. | In einer Session, deren Agent [dynamische Workflows](https://platform.claude.com/docs/de/managed-agents/multiagent-orchestration#dynamic-workflows) aktiviert hat, kommen diese `workflow_run.*`-Events im Stream der Session an: | Typ | Beschreibung | | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `workflow_run.created` | Ein Workflow-Run wurde erstellt. Enthält `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`), `name` (csharp, go: `Name`) und `description` (csharp, go: `Description`) des Runs sowie `phases` (csharp, go: `Phases`), die für den Run deklarierten Phasen. Ein Status-Event folgt, nach einer Unterbrechung jedoch möglicherweise nicht. | | `workflow_run.status_running` | Ein Workflow-Run läuft. Wird gesendet, wenn der Run mit der Ausführung beginnt, was eine Weile nach `workflow_run.created` sein kann, und erneut, wenn er nach einer Pause am Budget fortgesetzt wird. Eine Fortsetzung nach einer Unterbrechung sendet es möglicherweise nicht. Ein Run, der von Anfang an inaktiv ist, erhält möglicherweise zuerst `workflow_run.status_idle`. Enthält `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`). | | `workflow_run.status_idle` | Ein Workflow-Run wurde inaktiv: Er wurde pausiert, zum Beispiel am Budget der Session. Eine Pause nach einer Unterbrechung sendet es möglicherweise nicht. Enthält `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`). | | `workflow_run.status_ended` | Ein Workflow-Run wurde beendet. Enthält `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`) und `result` (csharp, go: `Result`), dessen `type` (csharp, go: `Type`) angibt, wie der Run endete. | | `workflow_run.error` | Ein Fehler eines Workflow-Runs oder ein Start, den der Server abgelehnt hat. Ein Run, der mit einem Fehler endet, erhält es mit demselben Fehler vor seinem `workflow_run.status_ended`. Enthält `error` (csharp, go: `Error`) und `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`), das `null` (python: `None`; ruby: `nil`; java: `Optional.empty()`; go: `""`) ist, wenn kein Run erstellt wurde. | | `workflow_run.phase_started` | Ein Workflow-Run ist in eine seiner Phasen eingetreten. Enthält `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`) und `workflow_run_phase_id` (java: `workflowRunPhaseId`; php: `workflowRunPhaseID`; csharp, go: `WorkflowRunPhaseID`). | | `workflow_run.phase_ended` | Ein Workflow-Run hat eine Phase verlassen. Enthält `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`), `workflow_run_phase_id` (java: `workflowRunPhaseId`; php: `workflowRunPhaseID`; csharp, go: `WorkflowRunPhaseID`) und `phase_started_id` (java: `phaseStartedId`; php: `phaseStartedID`; csharp, go: `PhaseStartedID`). | Span-Events sind Observability-Marker, die Aktivitäten zur Zeit- und Nutzungserfassung umschließen. | Typ | Beschreibung | | --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `span.model_request_start` | Ein Modell-Inferenzaufruf wurde gestartet. | | `span.model_request_end` | Ein Modell-Inferenzaufruf wurde abgeschlossen. Enthält `model_usage` (java, php: `modelUsage`; csharp, go: `ModelUsage`) mit Token-Zählungen. | | `span.outcome_evaluation_start` | Die [Outcome](https://platform.claude.com/docs/de/managed-agents/define-outcomes)-Auswertung wurde gestartet. | | `span.outcome_evaluation_ongoing` | Heartbeat während einer laufenden [Outcome](https://platform.claude.com/docs/de/managed-agents/define-outcomes)-Auswertung. | | `span.outcome_evaluation_end` | Ein [Outcome](https://platform.claude.com/docs/de/managed-agents/define-outcomes)-Auswertungszyklus wurde abgeschlossen. Ein `needs_revision`-Ergebnis bedeutet, dass ein weiterer Zyklus folgt; `satisfied`, `max_iterations_reached`, `failed` und `interrupted` sind terminal. | | Typ | Beschreibung | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `system.message` | Fügt privilegierten Kontext auf Systemebene hinzu, der für den zugehörigen Turn und alle nachfolgenden Turns gilt. Welche Modelle dies akzeptieren, findest du unter [Unterstützte Modelle](https://platform.claude.com/docs/de/managed-agents/events-and-streaming#supported-models). Bei einem nicht unterstützten primären Modell wird das Event mit `model_does_not_support_mid_conversation_system` abgelehnt. | Event-Deltas sind reine Stream-Vorschau-Events. Sie werden auf Stream-Verbindungen (auf Session-Ebene oder pro Thread) ausgegeben, die sich mit dem Parameter `event_deltas` (curl: `event_deltas[]`; cli: `--event-delta`; java, php: `eventDeltas`; csharp, go: `EventDeltas`) dafür entscheiden, und sie werden niemals im Event-Verlauf der Session persistiert. Siehe [Antworten mit Event-Deltas in der Vorschau anzeigen](https://platform.claude.com/docs/de/managed-agents/event-deltas), um zu erfahren, wie du sie aktivierst, akkumulierst und abgleichst. | Typ | Beschreibung | | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `event_start` | Die Generierung eines Vorschau-Events hat begonnen. Enthält `type` (csharp, go: `Type`) und `id` (csharp, go: `ID`) des bevorstehenden Events. Nur im Stream und niemals persistiert. | | `event_delta` | Inkrementeller Inhalt für ein Vorschau-Event, identifiziert durch `event_id` (java: `eventId`; php: `eventID`; csharp, go: `EventID`). Nur im Stream und niemals persistiert. | ## Selbst gehosteter Worker Unter [Referenz für selbst gehostete Worker](https://platform.claude.com/docs/de/managed-agents/self-hosted-sandboxes-reference) findest du die CLI-Flags von `ant beta:worker`, Umgebungsvariablen, Dateisystempfade und SDK-Helferoptionen der vorgefertigten Worker, die eine `self_hosted`-Umgebung betreiben. ## Unterstützte MCP-Server-Typen Claude Managed Agents verbindet sich mit [Remote-MCP-Servern](https://platform.claude.com/docs/de/agents-and-tools/remote-mcp-servers), die einen HTTP-Endpunkt bereitstellen, oder über [MCP-Tunnel](https://platform.claude.com/docs/de/agents-and-tools/mcp-tunnels/overview) mit privaten MCP-Servern. Der Server sollte den Streamable-HTTP-Transport des MCP-Protokolls unterstützen; Server, die nur den abgekündigten SSE-Transport unterstützen, funktionieren weiterhin über einen automatischen Fallback. Siehe [MCP-Connector](https://platform.claude.com/docs/de/managed-agents/mcp-connector) zum Deklarieren von Servern auf einem Agenten. Weitere Informationen zu MCP und zum Erstellen von MCP-Servern findest du in der [MCP-Dokumentation](https://modelcontextprotocol.io). ## Ratenlimits Managed-Agents-Endpunkte unterliegen „rate limits“ (Ratenlimits) pro Organisation: | Operation | Limit | | ------------------------------------------------------- | ------------------------- | | Create-Endpunkte (wie Agenten, Sessions und Umgebungen) | 300 Anfragen pro Minute | | Read-Endpunkte (wie Abrufen, Auflisten und Streaming) | 1.200 Anfragen pro Minute | [Ausgabenlimits und Ratenlimits der Nutzungsstufen](https://platform.claude.com/docs/de/api/rate-limits) auf Organisationsebene gelten ebenfalls. ## Branding-Richtlinien Für Partner, die Claude Managed Agents integrieren, ist die Verwendung des Claude-Brandings optional. Wenn du in deinem Produkt auf Claude verweist: **Erlaubt:** * „Claude Agent“ (bevorzugt für Dropdown-Menüs) * „Claude“ (innerhalb eines Menüs, das bereits mit „Agents“ beschriftet ist) * „\{YourAgentName} Powered by Claude“ (wenn du bereits einen Agentennamen hast) **Nicht gestattet:** * „Claude Code“ oder „Claude Code Agent“ * „Claude Cowork“ oder „Claude Cowork Agent“ * ASCII-Art im Claude Code-Branding oder visuelle Elemente, die Claude Code nachahmen Dein Produkt sollte sein eigenes Branding beibehalten und nicht wie Claude Code, Claude Cowork oder ein anderes Anthropic-Produkt erscheinen. Bei Fragen zur Branding-Konformität wende dich an das [Vertriebsteam](https://www.anthropic.com/contact-sales) von Anthropic.