Skip to main content
The @agent decorator is used to define agent metadata and information about the runtime environment that will be provisioned to execute it. 
@agent(
    name="my-agent",
    plugins=["CLAUDE_CODE"],
    required_env_vars=["CLAUDE_API_KEY"]
    runtime="python3.10",
)
The only required argument for the @agent decorator is the name argument. The name must be unique per workspace; changing the name will create a new agent or overwrite an existing agent if the name already exists.

​
Arguments

​
name
string
required
The name of the agent.
​
plugins
array
The plugins to install in the agent. Supported values: CLAUDE_CODE.
  • CLAUDE_CODE adds Node to your agent’s runtime and installs the Claude CLI.
​
required_env_vars
array
The environment variables that are required to run your agent. Automations cannot be enabled when these are not defined.
​
runtime
string
default:"python3.10"
The runtime to use for the agent. Supported values: python3.9, python3.10, python3.11, python3.12.