Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Diese Seite sammelt Referenzmaterial für Claude Managed Agents. Für aufgabenorientierte Anleitungen folge den Links in den jeweiligen Abschnitten. Für die Operationen auf der Session-Ressource siehe Session-Operationen.
Alle Managed Agents API-Anfragen erfordern den Beta-Header managed-agents-2026-04-01. Das SDK setzt den Beta-Header automatisch.
Persistierte Event-Typ-Strings folgen einer {domain}.{action}-Namenskonvention; die reinen Stream-Event-Deltas (siehe Tab „Event-Deltas") sind die Ausnahme. Siehe Session-Event-Stream für das Senden, Streamen und Auflisten von Events.
| Typ | Beschreibung |
|---|---|
user.message | Eine Benutzernachricht mit Textinhalt. |
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-Helper und die CLI erledigen dies automatisch. |
Dies sind die ant beta:worker-CLI-Flags für den vorgefertigten Worker, der eine self_hosted-Umgebung steuert. Siehe Selbst gehostete Sandboxes für das Einrichten der Umgebung, das Ausführen eines Workers und die SDK-Helper-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. Standardmäßig . (das aktuelle Verzeichnis); das systemseitige Standard-Arbeitsverzeichnis ist /workspace. |
--on-work | Skript, das für jedes beanspruchte Work-Item aufgerufen wird, anstatt Tools im Prozess auszuführen. Erhält Session-Details als Umgebungsvariablen. |
--unrestricted-paths | Erlaubt Tool-Aufrufen den Zugriff auf Pfade außerhalb von --workdir. |
--max-idle | Wie lange gewartet werden soll, nachdem die Session mit einem end_turn-Stop-Reason in den Idle-Zustand gegangen ist, bevor heruntergefahren wird. Standardmäßig 60s. |
--log-format | Log-Ausgabeformat. Verwende json für strukturierte Log-Aufnahme. Standardmäßig 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 muss den Streamable-HTTP-Transport des MCP-Protokolls unterstützen. Siehe MCP-Connector für das 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 Abrufen, Auflisten und Streamen) | 1.200 Anfragen pro Minute |
Organisationsweite Ausgabenlimits und Nutzungsstufen-Ratenlimits 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 erlaubt:
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 kontaktiere das Anthropic-Vertriebsteam.
Was this page helpful?