Referenz
Event-Typen, CLI-Flags für den selbst gehosteten Worker, unterstützte MCP-Server-Typen, Ratenlimits und Branding-Richtlinien für Claude Managed Agents.
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.
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 zum Senden, Streaming und Auflisten von Events. Webhook-Event-Typen sind separat unter Webhooks abonnieren 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. |
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 (Ergebnis), auf das der Agent hinarbeiten soll. |
user.tool_result | Nur für Sessions mit self_hosted-Umgebungen: 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 und in der Regel evaluation (siehe wie jeder Aufruf bewertet wurde). |
agent.tool_result | Ergebnis der Ausführung eines vorgefertigten Agenten-Tools. |
agent.mcp_tool_use | Der Agent ruft ein Tool eines MCP-Servers auf. Enthält evaluated_permission und in der Regel evaluation (siehe wie jeder Aufruf bewertet wurde). |
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-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-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, der angibt, warum der Agent angehalten 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-Objekt mit einem retry_status. |
session.usage | Momentaufnahme der kumulierten Nutzung und der erfassten Listenkosten der Session. Enthält die Nutzungssummen der Session und das Budget der Session, wenn die Session eines hat. |
session.thread_created | Ein Multiagenten-Thread wurde erstellt. Es enthält workflow_run_id: die ID des Runs für einen Thread eines Workflow-Runs und null 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-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. |
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 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, name und description des Runs sowie phases, die für den Run deklarierten Phasen. Es folgt ein Status-Event, nach einer Unterbrechung jedoch möglicherweise nicht. |
workflow_run.status_running | Ein Workflow-Run läuft. Wird gesendet, wenn die Ausführung des Runs 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. |
workflow_run.status_idle | Ein Workflow-Run ist inaktiv geworden: Er wurde pausiert, zum Beispiel am Budget der Session. Eine Pause nach einer Unterbrechung sendet es möglicherweise nicht. Enthält workflow_run_id. |
workflow_run.status_ended | Ein Workflow-Run wurde beendet. Enthält workflow_run_id und result, dessen 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 und workflow_run_id, das null ist, wenn kein Run erstellt wurde. |
workflow_run.phase_started | Ein Workflow-Run ist in eine seiner Phasen eingetreten. Enthält workflow_run_id und workflow_run_phase_id. |
workflow_run.phase_ended | Ein Workflow-Run hat eine Phase verlassen. Enthält workflow_run_id, workflow_run_phase_id und phase_started_id. |
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 mit Token-Zählungen. |
span.outcome_evaluation_start | Die Outcome-Auswertung wurde gestartet. |
span.outcome_evaluation_ongoing | Heartbeat während einer laufenden Outcome-Auswertung. |
span.outcome_evaluation_end | Ein Outcome-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. 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[] dafür entscheiden, und sie werden niemals im Event-Verlauf der Session persistiert. Siehe Antworten mit Event-Deltas in der Vorschau anzeigen, um zu erfahren, wie du sie aktivierst, akkumulierst und abgleichst.
| Typ | Beschreibung |
|---|---|
event_start | Ein Vorschau-Event hat mit der Generierung begonnen. Enthält type und id des kommenden Events. Nur im Stream und niemals persistiert. |
event_delta | Inkrementeller Inhalt für ein Vorschau-Event, identifiziert durch event_id. Nur im Stream und niemals persistiert. |
Selbst gehosteter Worker
Unter Referenz für selbst gehostete Worker 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, die einen HTTP-Endpunkt bereitstellen, oder über MCP-Tunnel 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 zum Deklarieren von Servern auf einem Agenten.
Weitere Informationen zu MCP und zum Erstellen von MCP-Servern findest du in der MCP-Dokumentation.
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 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 von Anthropic.
Was this page helpful?