tcb agent create
v3.0.0+
tcb agent command has been available since v3.0.0.
Create AI Agent.
Usage
tcb agent create --name <name> [options]
Parameters
| Parameter | Description | Default Value |
|---|---|---|
--name <name> | Agent name (required) | — |
-e, --env-id <envId> | Environment ID | — |
--agent-id <agentId> | Custom Agent ID (auto-generated if not provided) | — |
--code [path] | Local code path, automatically packaged and uploaded. When omitted, the current directory is used; when --code is given without a path, the project directory is used | Current directory |
--runtime <runtime> | Runtime version | — |
--timeout <seconds> | Timeout period (seconds), range 1-7200 | 7200 |
--memory-size <mb> | Memory size (MB), 64 or 128–3072 | 128 |
--install-dep | Automatically install dependencies (used when deploying without node_modules) | — |
--ignore <patterns> | Ignore file patterns, comma-separated | .git,node_modules,.DS_Store |
--env <K=V,...> | Environment variables, in the format KEY1=VALUE1,KEY2=VALUE2 | — |
--json | Output JSON | — |
Examples
# Simplest Creation (with code from the current directory)
tcb agent create --name my-agent -e my-env-id
# Specifying the Code Directory and Runtime
tcb agent create --name my-agent --code ./agent-code --runtime Nodejs20.19 -e my-env-id
# Passing environment variables (for Agent code to read)
tcb agent create --name my-agent \
--env "OPENAI_API_KEY=sk-xxx,MAX_TOKENS=4096" \
-e my-env-id