Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
This page collects reference material for Claude Managed Agents. For task-oriented guides, follow the links in each section. For the operations on the session resource, see Session operations.
Persisted event type strings follow a {domain}.{action} naming convention; the stream-only event deltas (see the Event deltas tab) are the exception. See Session event stream for sending, streaming, and listing events.
| Type | Description |
|---|---|
user.message | A user message with text, image, or document content. |
user.interrupt | Stop the agent mid-execution. |
user.custom_tool_result | Response to a custom tool call from the agent. |
user.tool_confirmation | Approve or deny an agent or MCP tool call when a permission policy requires confirmation. |
user.define_outcome | Define an outcome for the agent to work toward. |
user.tool_result | For sessions with self_hosted environments only, your integration is responsible for providing agent_toolset results. The SDK helpers and CLI do this automatically. |
These are the ant beta:worker CLI flags for the pre-built worker that drives a self_hosted environment. See Self-hosted sandboxes for setting up the environment, running a worker, and the SDK helper options.
| Flag | Description |
|---|---|
--environment-id | The environment to poll for work. Also reads from ANTHROPIC_ENVIRONMENT_ID. |
--environment-key | Authenticates the worker with this environment. Also reads from ANTHROPIC_ENVIRONMENT_KEY. |
--workdir | Directory where skills are downloaded and tools read and write files. Defaults to . (the current directory); the system default working directory is /workspace. |
--on-work |