Diese Seite sammelt Referenzmaterial für Claude Managed Agents. Für aufgabenorientierte Anleitungen folge den Links in jedem Abschnitt. Für die Operationen auf der Session-Ressource siehe Session-Operationen.
Managed Agents API-Anfragen erfordern den Beta-Header managed-agents-2026-04-01, mit Ausnahme der Memory-Store-Endpunkte, die stattdessen agent-memory-2026-07-22 verwenden. Das SDK setzt den korrekten Beta-Header automatisch. Siehe Beta-Header.
Persistierte Event-Typ-Strings folgen einer {domain}.{action}-Namenskonvention; die Nur-Stream-Event-Deltas (siehe den Tab „Event deltas") sind die Ausnahme. Siehe Session-Event-Stream zum Senden, Streamen und Auflisten von Events.
| 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, 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 tun dies automatisch. |
Dies sind die ant beta:worker-CLI-Flags für den vorgefertigten Worker, der eine self_hosted-Umgebung antreibt. 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 werden soll. Liest auch aus ANTHROPIC_ENVIRONMENT_ID. |
--environment-key | Authentifiziert den Worker bei dieser Umgebung. Liest auch aus ANTHROPIC_ENVIRONMENT_KEY. |
--workdir | Verzeichnis, in das Skills heruntergeladen werden und in dem Tools Dateien lesen und schreiben. Standard ist . (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 Leitplanke für die Datei-Tools, keine Sandbox; sie schränkt bash nicht ein. |
--max-idle | Wie lange gewartet werden soll, nachdem die Session mit einem end_turn-Stop-Reason in den Leerlauf gegangen ist, bevor heruntergefahren wird. Standard ist 60s. |
--log-format | Log-Ausgabeformat. Verwende json für strukturierte Log-Aufnahme. Standard ist text. |
Claude Managed Agents verbindet sich mit Remote-MCP-Servern, die einen HTTP-Endpunkt bereitstellen, oder mit privaten MCP-Servern über MCP-Tunnel. Der Server sollte den Streamable-HTTP-Transport des MCP-Protokolls unterstützen; Server, die nur den veralteten 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.
Managed-Agents-Endpunkte sind pro Organisation ratenlimitiert:
| Operation | Limit |
|---|---|
| Create-Endpunkte (wie Agenten, Sessions und Umgebungen) | 300 Anfragen pro Minute |
| Read-Endpunkte (wie Retrieve, List und Stream) | 1.200 Anfragen pro Minute |
Ausgabenlimits und Ratenlimits der Nutzungsstufe auf Organisationsebene gelten ebenfalls.
Für Partner, die Claude Managed Agents integrieren, ist die Verwendung des Claude-Brandings optional. Wenn du in deinem Produkt auf Claude verweist:
Erlaubt:
Nicht gestattet:
Dein Produkt sollte sein eigenes Branding beibehalten und nicht den Anschein erwecken, Claude Code, Claude Cowork oder ein anderes Anthropic-Produkt zu sein. Bei Fragen zur Branding-Konformität wende dich an das Vertriebsteam von Anthropic.
Was this page helpful?