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. |
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. |
Selbst gehosteter Worker
Dies sind die ant beta:worker-CLI-Flags für den vorgefertigten Worker, der eine self_hosted-Umgebung betreibt. Siehe Selbst gehostete Sandboxes zum Einrichten der Umgebung, zum Ausführen eines Workers und zu den SDK-Helfer-Optionen.
| Flag | Beschreibung |
|---|---|
--environment-id | Die Umgebung, die nach Arbeit abgefragt wird. Wird auch aus ANTHROPIC_ENVIRONMENT_ID gelesen. |
--environment-key | Authentifiziert den Worker bei dieser Umgebung. Wird auch aus ANTHROPIC_ENVIRONMENT_KEY gelesen. |
--workdir | Verzeichnis, in das Skills heruntergeladen werden und in dem Tools Dateien lesen und schreiben. Standardmäßig . (das aktuelle Verzeichnis); das systemseitige Standard-Arbeitsverzeichnis ist /workspace. |
--on-work | Skript, das für jedes beanspruchte Arbeitselement aufgerufen wird, anstatt Tools im Prozess auszuführen. Erhält Session-Details als Umgebungsvariablen. |
--unrestricted-paths | Erlaubt den Datei-Tools, Pfade außerhalb von --workdir zu lesen und zu schreiben. Die Workdir-Prüfung ist nur eine Schutzmaßnahme für die Datei-Tools, keine Sandbox; sie schränkt bash nicht ein. |
--max-idle | Wie lange gewartet wird, nachdem die Session mit einem end_turn-Stop-Reason in den Leerlauf gegangen ist, bevor heruntergefahren wird. Standardmäßig 60s. |
--log-format | Log-Ausgabeformat. Verwende json für die strukturierte Log-Erfassung. Standardmäßig text. |
Der CLI-Worker bindet keine Memory Stores (Speicher) ein: Eine Session, die einen anhängt, läuft trotzdem, aber der Agent findet nichts unter dem mount_path des Stores und keine Änderungen werden in den Store zurücksynchronisiert. Um Memory Stores in Sessions auf einer selbst gehosteten Umgebung zu verwenden, führe stattdessen den SDK-Worker aus; siehe Memory Stores verwenden.
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?